How awakelab-dev/awk-motion works
Wilox Motion is a web app and API for turning text into narrated, illustrated motion videos, then managing and delivering them. The principal workflow is text submission, voice and word timing, storyboard and timeline planning, keyframe approval, clip generation, post-processing, and final rendering. Separate branches cover theme creation, projects and access, imports, reviews and sharing, and exports/publications. The README documents these product capabilities; edges are limited to relationships shown in the supplied excerpts, source index, or README, so some unsampled subsystem links are omitted.
Main entry points: pipeline.service.ts Generation pipeline · run-store.ts Run persistence · themes.controller.ts Theme studio API · access.service.ts Access control
Components 23
Video creation
- Generation API
apps/api/src/generations/generations.controller.ts - Generation pipeline
apps/api/src/pipeline/pipeline.service.ts - Storyboard prompts
packages/prompts/src/index.ts - Timeline planner
apps/api/src/pipeline/timeline.ts - AI providers
apps/api/src/providers/ports.ts - Media processing
apps/api/src/media/ffmpeg.ts
Themes and assets
- Theme studio API
apps/api/src/themes/themes.controller.ts - Theme store
apps/api/src/themes/theme-store.ts - Studio generation
apps/api/src/themes/studio.service.ts
Projects and access
- Project management
apps/api/src/projects/projects.controller.ts - Access control
apps/api/src/access/access.service.ts - Authentication
apps/api/src/auth/auth.service.ts - Content import
apps/api/src/imports/imports.controller.ts
Review and delivery
- Video review
apps/api/src/review/review.service.ts - Project sharing
apps/api/src/share/project-share.service.ts - Exports and delivery
apps/api/src/delivery/delivery.service.ts - Publications
apps/api/src/publications/publications.service.ts
Runtime platform
- Run persistence
apps/api/src/generations/run-store.ts - Media storage
apps/api/src/storage/media.service.ts - PostgreSQL
packages/db/src/index.ts
Other components
- Creator
- Web app
apps/web/src/App.tsx - AI services
Connections 23
- Creator → Web app: submits text
- Web app → Generation API: requests generation
- Generation API → Generation pipeline: starts run
apps/api/src/generations/generations.controller.ts - Generation pipeline → Storyboard prompts: builds prompts
apps/api/src/pipeline/pipeline.service.ts - Generation pipeline → Timeline planner: plans shots
apps/api/src/pipeline/pipeline.service.ts - Generation pipeline → AI providers: uses providers
apps/api/src/pipeline/pipeline.service.ts - AI providers → AI services: calls models
- Generation pipeline → Media processing: encodes media
apps/api/src/pipeline/pipeline.service.ts - Generation pipeline → Run persistence: updates run
apps/api/src/pipeline/pipeline.service.ts - Generation pipeline → Theme studio API: uses selected theme
- Theme studio API → Theme store: manages themes
apps/api/src/themes/themes.controller.ts - Theme studio API → Studio generation: generates proposals
apps/api/src/themes/themes.controller.ts - Theme store → PostgreSQL: persists themes
apps/api/src/themes/theme-store.ts - Run persistence → PostgreSQL: persists run state
apps/api/src/generations/run-store.ts - Run persistence → Media storage: stores run files
apps/api/src/generations/run-store.ts - Project management → Access control: checks permissions
apps/api/src/projects/projects.controller.ts - Project management → Run persistence: loads generations
apps/api/src/projects/projects.controller.ts - Authentication → Access control: identifies user
- Content import → Access control: checks permissions
apps/api/src/imports/imports.controller.ts - Video review → Media storage: reads media
apps/api/src/review/review.service.ts - Project sharing → Video review: serves review links
apps/api/src/share/project-share.controller.ts - Exports and delivery → Media storage: reads media
apps/api/src/delivery/delivery.service.ts - Publications → Exports and delivery: uses delivery
apps/api/src/publications/publications.controller.ts