How alfredoperez/toku works
Toku is a monorepo of reusable content engines and copy-in kits, a CLI for adopting them, and read-only demo applications. The main consumer workflow is to scaffold a deck project, select registry content, copy its dependency closure into the project, then render slides with the deck engine and a theme. The README documents the broader video, HTML-doc, and motion capabilities; their internals are not fully sampled, so those branches are represented at package level. The skills plugin is described but its source is absent from the supplied tree.
Main entry points: cli.ts butai CLI · add.ts Registry installer · SlideEngine.tsx Slide engine · src Read-only studio
Components 18
Project adoption
- butai CLI
packages/cli/src/cli.ts - Project scaffold
packages/cli/src/commands/init.ts - Registry installer
packages/cli/src/commands/add.ts - Copy comparison
packages/cli/src/commands/diff.ts - Registry resolver
packages/cli/src/registry.ts - Copy transforms
packages/cli/src/transform.ts
Presentation runtime
- Slide engine
packages/deck/src/SlideEngine.tsx - Slide navigation
packages/deck/src/useSlides.ts
Content kits
- Slide archetypes
packages/slide-kit/src/slides - Video scenes
packages/scene-kit/src/storyboard.ts - HTML doc patterns
packages/docs-kit/src - Motion recipes
packages/motion-kit/src/recipes
Demo surfaces
- Read-only studio
apps/studio/src - Deck playground
apps/playground/src/App.tsx
Shared substrate
- Design patterns
packages/patterns/src - Theme tokens
packages/themes/src/index.ts - Credit ledger
packages/credits/src
Other components
- Project author
Connections 21
- Project author → butai CLI: runs commands
README.md - butai CLI → Project scaffold: dispatches init
README.md - butai CLI → Registry installer: dispatches add
packages/cli/src/commands/add.ts - butai CLI → Copy comparison: dispatches diff
- Registry installer → Registry resolver: resolves items
packages/cli/src/commands/add.ts - Registry installer → Copy transforms: rewrites copies
packages/cli/src/commands/add.ts - Project author → Slide archetypes: selects archetypes
README.md - Registry installer → Slide archetypes: copies registry files
README.md - Project author → Slide engine: authors deck
README.md - Slide engine → Slide navigation: uses navigation
packages/deck/src/SlideEngine.tsx - Slide engine → Theme tokens: renders with theme
README.md - Project author → Video scenes: authors video
README.md - Project author → HTML doc patterns: authors HTML docs
README.md - Project author → Motion recipes: uses recipes
README.md - Video scenes → Design patterns: uses shared types
packages/scene-kit/src/storyboard.ts - HTML doc patterns → Design patterns: extracts themes
packages/docs-kit/src/node/render-preview.ts - Read-only studio → Video scenes: explores storyboards
- Read-only studio → Design patterns: explores patterns
apps/studio/src/theme-studio/index.tsx - Read-only studio → Theme tokens: explores tokens
- Deck playground → Slide engine: renders demo deck
apps/playground/src/App.tsx - Deck playground → Slide archetypes: browses archetypes