- Replace QuickstartTemplatesView with TemplateExplorerView
- Widen modal from max-w-3xl to max-w-4xl for sidebar layout
- Add max-h-[80vh] constraint for overflow handling
- Add search input with 200ms debounce for filtering by name/description
- Add category filter buttons (All, Product, Style, Composition, Community)
- Add tag pill buttons with multi-select OR logic
- Implement filtering logic: search AND category AND tags
- Add empty state with clear filters button
- Restructure layout: sidebar (w-48) + main grid area
- Update createPredictedCost helper for new breakdown format with provider, modelId, unit fields
- Add createMultiProviderCost helper for testing multi-provider scenarios (Gemini, fal.ai, Replicate)
- Add test cases for Known Costs section with provider grouping
- Add test cases for Pricing Unavailable section with Replicate models
- Add test cases for billing units (per image, per 5 seconds, etc.)
- Add test for Replicate help text with external link
- Add test for empty sections being hidden
- Add test for incurred cost tracking note
- Update Pricing Reference tests for new dynamic format
- All existing functionality tests preserved (close, reset, escape key)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Redesign CostDialog to show provider-grouped cost information
- Add two-section layout: Known Costs (Gemini, fal.ai) and Pricing Unavailable (Replicate)
- Add ProviderIcon component with colored dots for each provider
- Group breakdown items by provider with provider headers
- Show billing units (per image, per video, per second) for each model
- Add Replicate help text with link to replicate.com
- Update Incurred Cost section with note "Tracks Gemini and fal.ai only"
- Hide empty sections dynamically
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add SelectedModelPricing interface to providers.ts
- Update SelectedModel type with optional pricing field
- Track fal.ai costs in nanoBanana execution and regeneration
- Track fal.ai costs in generateVideo execution and regeneration
- Skip cost tracking for Replicate (no pricing API available)
- Gemini continues to use hardcoded pricing
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Grid layout with 2 columns on mobile, 3 on larger screens
- Uses TemplateCard for preset templates with metadata
- Community workflows section with custom cards
- Loads presets from getAllPresets() with node count calculation
- Fetches community workflows from /api/community-workflows
- Template selection via /api/quickstart POST and community API
- Loading states per template, error handling with dismissible alert
- Discord CTA for community contributions
- Update test data to use new multi-provider interface fields
- Add test for unknown pricing indicator
- Remove resolution-specific test that no longer applies
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Card layout with 48x48 icon area
- Template name and 2-line description with line-clamp
- Node count badge and category badge with color coding
- Tag pills display (max 4 shown)
- Loading state with spinner animation
- Disabled state with reduced opacity
- Hover states for interactive feedback
- Update calculatePredictedCost to produce CostBreakdownItem[] format
- Add unknownPricingCount to return value (was missing)
- CostDialog already using modelName property
- Add TemplateMetadata interface with nodeCount, category, tags, previewImage
- Add TemplateCategory type (product, style, composition, community)
- Update PresetTemplate interface with category and tags fields
- Add category and tags to all 6 preset templates
- Add getTemplateMetadata() to extract node count from workflow
- Add getPresetWithMetadata() to get template with full metadata
- Update getAllPresets() to include category and tags in return type
Phase 25: Template Explorer UI
- 2 plans created
- 5 total tasks defined
- Ready for execution
Plan 01: Template types, TemplateCard, grid layout (3 tasks)
Plan 02: Sidebar filters, WelcomeModal integration (2 tasks + checkpoint)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add fetchFalPricing() to batch-fetch pricing from fal.ai API:
- GET /v1/models/pricing?endpoint_id={ids}
- Maps "image" unit -> per-run, others -> per-second
- Best-effort: errors logged but don't fail model fetching
Pricing is merged into ProviderModel after fetching fal.ai models.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add pricing field to GEMINI_IMAGE_MODELS array:
- nano-banana: $0.039 per-run
- nano-banana-pro: $0.134 per-run
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
The aspectRatio, resolution, and useGoogleSearch controls were only
shown when isGeminiOnly was true, but that was always false since
fal.ai is always available. Now these controls show based on whether
the currently selected model is a Gemini model.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
When connecting to nodes with multiple input handles of the same type,
now finds the first unoccupied handle instead of always targeting the
first one. Returns null if all handles are occupied.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
The generateVideo node type was missing from imageStorage.ts, causing
input images to be saved as new files on every workflow save instead
of being deduplicated via refs.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Security & API route fixes:
- Remove API key query param support in fal/models route to prevent credential leakage
- Fix MIME type fallback in save-generation route (now uses prefix-based fallback: image/* -> png, video/* -> mp4, unknown -> bin)
- Add timeout (60s) and size limits (500MB) for remote fetch in save-generation route using AbortController
CSS fix:
- Consolidate duplicate :root blocks in globals.css
- Change handle selector from data-handletype="prompt" to data-handletype="text"
- Update --handle-color-text CSS variable from #a3a3a3 to #3b82f6
Test file global mock isolation:
- Fix useAnnotationStore mock to support Zustand selector pattern
- Use vi.stubGlobal() instead of direct global assignments to prevent test leakage
- Restore global.Image in afterAll hook in AnnotationModal.test.tsx
- Wrap async Done assertion in waitFor() in AnnotationModal.test.tsx
- Use idiomatic fireEvent.dragOver() in AnnotationNode.test.tsx
- Fix global.confirm stub with proper beforeAll/afterAll lifecycle in CostDialog.test.tsx
- Import ReactNode type properly in EdgeToolbar.test.tsx
- Update save-generation route test to expect AbortController signal in fetch call
- Add Multi-Provider Support (Beta) section for Replicate and fal.ai
- Update Tech Stack and Environment Variables with new providers
- Add docs link to welcome modal (https://node-banana-docs.vercel.app/)
- Remove debug console.log statements from gridSplitter and WorkflowCanvas
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Fixes issues with external provider models (e.g., seedream-4.5) where:
- Boolean/integer params with "image" in name were misclassified as image inputs
- Array params without items.type specification were incorrectly rejected
- Handle ID mismatch between node components (image-0) and store (image)
- dynamicInputs not passed to API in node regeneration code path
Changes:
- Update isImageInput() to check schema types, not just names
- Map both indexed (image-0) and legacy (image) handle IDs to schema names
- Add dynamicInputs to nanoBanana regeneration request body
- Add hidden backward-compat handles for edge routing
- Add comprehensive tests for schema classification and handle mapping
- Fix Toast test to use specific selector for close button
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
These planning phase documents are local development artifacts
that don't need to be shared in the repo. They remain in .gitignore.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Create server.js with extended requestTimeout (10 min) for long-running fal.ai video generation
- Update package.json dev script to use custom server
- Add comments explaining why queue API is not used (file size limitations)
- Use WHATWG URL API instead of deprecated url.parse()
- Added support for long-running video generation using a queue system with a 10-minute timeout.
- Updated maxDuration constant to reflect the new timeout for video generation.
- Enhanced API request handling to accommodate video generation, including error handling and polling for completion.
- Updated model retrieval tests to reflect the inclusion of additional models and improved provider filtering.
- Modified component tests to track model usage and reflect changes in the UI for provider selection.
- Image data flow through node chains (imageInput, annotation, nanoBanana)
- Text data flow through node chains (prompt, llmGenerate)
- Dynamic inputs from schema-mapped connections
- State updates during execution (status, outputImage)
- Mixed image and text data flow
The open project button was only visible for unsaved projects. Now it
displays in both states so users can always load a different project.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
shrimbly