Devsuite docs

A token-driven handbook and the first in-repo DSM client

The docs site now dogfoods the shared component library for catalog browsing, theme review, and long-form handbook content while staying fully static and SSR-safe.

Brand

Color mode

Contrast

Core docs

7

Vision, stack choices, and architecture decisions stay versioned with the code.

Planning docs

3

Roadmaps, operating cadence, and backlog structure live in the same handbook.

Runbooks

7

Server, Docker, and bootstrap guides live alongside the code.

Prompts

2

Prompt patterns are versioned inside the monorepo.

Design system

Interactive component and token tooling

The docs site now includes a live component workbench and a token explorer so the design system can be reviewed in the same product surface that documents it.

Component docs

Component workbench

Browse documented components, switch examples in iframe previews, inspect generated API tables, and track the primitive backlog.

29 ready33 planned

  • components
  • playground
  • api-reference
Token explorer

Interactive token explorer

Search the live token contract, inspect values across modes, and verify the component-level token model as the library grows.

System, brand, and component tokensTheme-aware

  • tokens
  • theming
  • contrast-modes
Catalog

Handbook and prompt library

Search and filter every handbook and prompt entry from one responsive catalog. This is the first reusable foundation for a future CMS-backed DSM surface.

Matches titles, summaries, tags, and prompt variables.

Collection

Showing all 19 catalog entries.

Docs

Architecture decisions

The major decisions already made in phase 1, along with their rationale and consequences.

Updated 2026-03-14Docs

  • adr
  • architecture
  • tradeoffs
Docs

CMS platform decision

Why Directus remains the preferred self-hosted CMS path over hosted options like Sanity for the Devsuite DSM.

Updated 2026-03-14Docs

  • cms
  • directus
  • architecture
Docs

Design system strategy

How tokens, accessibility, theming, Storybook, and future Penpot alignment work together.

Updated 2026-03-14Docs

  • design-system
  • accessibility
  • theming
Docs

DSM platform strategy

A self-hosted CMS-backed path for a future design system manager that dogfoods the Devsuite component library.

Updated 2026-03-14Docs

  • design-system
  • cms
  • strategy
Docs

Platform blueprint

The monorepo layout, dependency flow, and how the major zones of the suite fit together.

Updated 2026-03-14Docs

  • architecture
  • nx
  • platform
Docs

Platform charter

The original brief, the north star, and the success criteria for Devsuite as a personal platform.

Updated 2026-03-14Docs

  • vision
  • strategy
  • foundations
Docs

Stack and tooling

The current stack, why each major tool was chosen, and what tradeoffs come with it.

Updated 2026-03-14Docs

  • stack
  • tooling
  • decisions
Planning

Backlog shape

The seeded epics, spikes, tickets, and QA work that should guide the next iteration cycles.

Updated 2026-03-14Planning

  • backlog
  • epics
  • tickets
Planning

Delivery system

The kanban workflow, work item taxonomy, and quality gates for day-to-day execution.

Updated 2026-03-14Planning

  • delivery
  • kanban
  • qa
Planning

Roadmap and next steps

What phase 1 has already established and what the next product and platform slices should be.

Updated 2026-03-14Planning

  • roadmap
  • milestones
  • planning
Runbooks

Bootstrap macOS

Provision a fresh macOS machine, install the toolchain, and verify the main surfaces all run.

Updated 2026-03-14Runbooks

  • bootstrap
  • macos
Runbooks

Directus MVP

Stand up the local Directus-based CMS foundation and understand the first content model for the DSM path.

Updated 2026-03-14Runbooks

  • cms
  • directus
  • docker
Runbooks

Docker local stack

Bring up Postgres and MySQL locally, understand what they are for, and validate the default stack.

Updated 2026-03-14Runbooks

  • docker
  • databases
Runbooks

Docs delivery

Build and deploy the static docs site to AWS using the same OIDC-backed pattern as Storybook.

Updated 2026-03-14Runbooks

  • docs
  • deployment
  • aws
Runbooks

GitHub repo setup

Mirror the repo-native planning system into GitHub with labels, milestones, issues, and the right auth expectations.

Updated 2026-03-14Runbooks

  • github
  • planning
  • operations
Runbooks

Quality gates

The default verification flow for linting, testing, Storybook, e2e, and release readiness.

Updated 2026-03-14Runbooks

  • qa
  • testing
  • release
Runbooks

Storybook delivery

Build Storybook in GitHub Actions and deploy it to a private AWS-hosted review surface when the repo is ready.

Updated 2026-03-14Runbooks

  • storybook
  • deployment
  • aws
Prompts

System rollout brief

Summarize architecture, rollout order, and operating checks for a new service.

Reusable prompt2 variables

  • service_name
  • environment
Prompts

Component accessibility audit

Review a UI component against keyboard, focus, semantics, and motion expectations.

Reusable prompt1 variables

  • component_name