Skip to content

Under the Hood

oves-decks is a modern React-based, intent-driven, AI-assisted deck creation system.

What That Means

  • The primary product is a React/Spectacle deck app.
  • Human authors edit intent docs in docs/.
  • Deck code in src/decks/ is scaffolded and refined from that intent.
  • AI assistance helps draft, scaffold, and iterate, but the repo intent stays explicit and reviewable.

Core Model

  1. Write or update the deck intent
  2. Scaffold or update one deck at a time
  3. Serve the deck locally
  4. Refine the intent
  5. Repeat until the deck is ready

Main Building Blocks

  • deck designs in docs/decks/
  • system-wide company identity in src/shared/design-system/
  • system-wide layout allocation in src/shared/design-system/
  • page styles in src/page-templates/
  • block styles in src/blocks/
  • deck blueprints in src/deck-templates/
  • live deck apps in src/decks/

Standard Hierarchy

Standards resolve in this order:

system > deck > page > block

That hierarchy is both architectural and operational:

  • system-wide standards define baseline runtime and corporate constraints
  • deck standards are subject to the system layer
  • page standards are subject to the system and deck layers
  • block standards are subject to the system, deck, and page layers

Lower layers should inherit from higher layers and stay within their constraints.

Why This Repo Exists

This repo keeps deck design and deck production in one place:

  • intent docs
  • company identity and shared runtime rules
  • shared React/Spectacle runtime
  • reusable page and block primitives
  • generated deck apps

That is different from an intent-only repo.