Trellis

Trellis generates design-system foundations from a few brand choices — primary/secondary/accent colors, neutrals, status hues, fonts, density and surface style — and emits semantic tokens tuned for WCAG AA contrast. It ships as a pnpm workspace orchestrated by Turborepo, split into a reusable token-generation library and an Astro web app that wraps it in a marketing site, an interactive Configurator, live previews, and one-click exports.

Repository layout

Path	Purpose
packages/generator	@trellis/generator — pure TypeScript library that produces OKLCH ramps, semantic token sets, and CSS / DTCG / Tailwind / shadcn exports. No DOM dependencies; usable from Node or the browser.
apps/web	Astro 5 + React 19 frontend: marketing pages, the /generate Configurator, live component playground, and export dialog. Consumes @trellis/generator via workspace:*.

Requirements

• Node.js 18.20.8+ or 22+ (22+ recommended; pinned in apps/web/.nvmrc).
• pnpm 9 (packageManager in root package.json pins pnpm@9.15.4).

Getting started

pnpm install
pnpm dev      # starts the web app via Turborepo (Astro on http://localhost:4321)

Other root scripts (all delegate through Turborepo):

pnpm build    # build the generator package, then the web app
pnpm test     # run vitest in every workspace that defines `test`
pnpm preview  # serve the production web build

Turbo task wiring lives in turbo.json; ^build ensures @trellis/generator is compiled before apps/web consumes it.

Working on a single package

pnpm --filter @trellis/generator build
pnpm --filter @trellis/generator test
pnpm --filter @trellis/web dev

See each package's README for API docs, scripts, and customization notes.