How richarrrd53/storyboardai2 works
Storyboard AI is a web app that helps short-video creators turn story ideas into editable, image-backed storyboards, while also supporting project management, reusable templates, and YouTube video discovery. The main flow runs from the creator UI through the Express API to AI generation and saved projects; discovery separately searches and analyzes videos before converting them into templates. The graph reflects README-documented capabilities and sampled module references; unsampled frontend wiring and database details are shown only where documented, not inferred from naming.
Main entry points: server.js Express API · main.js Storyboard SPA · copilot.js Creative copilot · generation.js Storyboard generation
Components 22
Creator experience
- Storyboard SPA
public/js/main.js - Creation workflow
public/js/features/creation.js - Project management UI
public/js/features/projects.js - Template browser
public/js/pages/templates.js - Discovery UI
public/js/discovery.js
Accounts and projects
- Authentication
public/js/features/auth-service.js - Project operations
public/js/features/projects.js
AI creation
- Creative copilot
lib/ai/copilot.js - Storyboard generation
lib/ai/generation.js - AI model settings
lib/ai/model-config.js - Creative request policy
lib/ai/creative-request.js
Discovery and templates
- YouTube search
lib/discovery/youtube-collector.js - Video analysis
lib/discovery/video-analyzer.js - Structure extraction
lib/discovery/analyzers/short-video-template-lab.js - Discovery template builder
lib/discovery/template-builder.js - Template catalog
lib/template-catalog.js
Services and storage
- Express API
server.js - Project and shot data
lib/prisma.ts
Other components
- Creator
- Google AI services
- YouTube Data API
- PostgreSQL
Connections 27
- Creator → Storyboard SPA: uses
README.md - Storyboard SPA → Creation workflow: opens creation
README.md - Storyboard SPA → Project management UI: manages projects
README.md - Storyboard SPA → Template browser: browses templates
README.md - Storyboard SPA → Discovery UI: explores videos
README.md - Creation workflow → Express API: requests creation
README.md - Project management UI → Express API: requests project actions
README.md - Storyboard SPA → Authentication: supports login
README.md - Authentication → Express API: authenticates via
README.md - Express API → Project and shot data: reads and writes
README.md - Project and shot data → PostgreSQL: persists data
README.md - Express API → Creative copilot: routes copilot requests
server.js - Express API → Storyboard generation: routes generation
server.js - Creative copilot → Storyboard generation: parses responses
lib/ai/copilot.js - Creative copilot → AI model settings: gets model settings
lib/ai/copilot.js - Creative copilot → Creative request policy: applies request policy
lib/ai/copilot.js - Storyboard generation → AI model settings: gets model settings
lib/ai/generation.js - Storyboard generation → Google AI services: generates text and images
README.md - Express API → YouTube search: routes searches
server.js - Express API → Video analysis: routes analysis
server.js - Express API → Discovery template builder: routes template creation
server.js - YouTube search → YouTube Data API: searches videos
lib/discovery/youtube-collector.js - Video analysis → Google AI services: analyzes video
README.md - Video analysis → Structure extraction: uses structure rules
- Discovery template builder → Template catalog: creates reusable templates
- Template browser → Express API: requests templates
README.md - Discovery UI → Express API: requests discovery
README.md