diff --git a/src/components/nodes/GenerateImageNode.tsx b/src/components/nodes/GenerateImageNode.tsx
index 8cf45c32..7f0b3413 100644
--- a/src/components/nodes/GenerateImageNode.tsx
+++ b/src/components/nodes/GenerateImageNode.tsx
@@ -590,5 +590,8 @@ export function GenerateImageNode({ id, data, selected }: NodeProps<NanoBananaNo
   );
 }
 
-// Backward-compatible alias
+/**
+ * @deprecated Use `GenerateImageNode` instead. This alias is kept for backward compatibility
+ * with existing workflows but will be removed in a future version.
+ */
 export { GenerateImageNode as NanoBananaNode };
diff --git a/src/store/workflowStore.ts b/src/store/workflowStore.ts
index 4c7778a1..06eefc43 100644
--- a/src/store/workflowStore.ts
+++ b/src/store/workflowStore.ts
@@ -340,9 +340,12 @@ export const saveGenerateImageDefaults = (settings: Partial<GenerateImageDefault
   localStorage.setItem(GENERATE_IMAGE_DEFAULTS_KEY, JSON.stringify(updated));
 };
 
-// Backward-compatible aliases
+/**
+ * @deprecated Backward-compatible aliases. Use `GenerateImageDefaults` and `saveGenerateImageDefaults` instead.
+ */
 type NanoBananaDefaults = GenerateImageDefaults;
 const loadNanoBananaDefaults = loadGenerateImageDefaults;
+/** @deprecated Use `saveGenerateImageDefaults` instead */
 export const saveNanoBananaDefaults = saveGenerateImageDefaults;
 
 // localStorage helpers for provider settings