slide-factory/docs/architecture.md
2026-06-08 21:43:58 -07:00

943 B

Architecture

Components

  • packages/core: deck schemas, style-pack loading, source ingestion, and deck planning.
  • packages/render-pptx: deterministic PPTX rendering from DeckSpec.
  • apps/cli: local creation and regeneration commands.
  • apps/api: HTTP API for deck jobs.
  • apps/web: first human-friendly frontend for paste/upload/download.
  • styles/*: reusable brand/style packs.

Durable Data Model

The durable interface is the DeckSpec. Future LLM prompts, API clients, Google Slides renderers, and web UI revisions should preserve this contract.

Future Hosted Shape

Forgejo repo
  -> /var/www/slide-factory-dev
  -> slide-factory-dev.service
  -> nginx dev.slides.scottfelten.com
  -> /var/www/slide-factory-prod
  -> slide-factory-prod.service
  -> nginx slides.scottfelten.com

No production deploy, DNS, nginx, OAuth, secret projection, or systemd mutation is part of the initial local MVP.