Sugartown Monorepo
Mini-monorepo: React + Sanity Studio, pnpm workspaces, Turborepo
Workspaces
Quick Start
pnpm install
pnpm dev # web + studio concurrently
Key Commands
pnpm lint # ESLint across all workspaces
pnpm typecheck # TypeScript across all workspaces
pnpm validate:urls # Validate canonical URLs and nav (requires Sanity env vars)
pnpm validate:filters # Validate archive filter models (requires Sanity env vars)
pnpm build # Production build across all workspaces
pnpm format # Prettier (not a CI gate — run locally)
Architectural Boundaries
packages/ cannot import from apps/apps/web cannot import from apps/studiopackages/design-system is CMS-agnostic — no Sanity imports
These boundaries are enforced by ESLint rules in packages/eslint-config/boundaries.js.
Documentation
All architectural, schema, and operational docs live in /docs:
| Doc | Path |
|---|
| Monorepo overview | docs/architecture/monorepo-overview.md |
| Sanity data flow | docs/architecture/sanity-data-flow.md |
| Schema reference | docs/schemas/schema-reference.md |
| URL namespace | docs/routing/url-namespace.md |
| GROQ query reference | docs/queries/groq-reference.md |
| CI pipeline | docs/operations/ci.md |
CI
GitHub Actions runs on every push and PR to main:
install → lint → typecheck → validate:urls → validate:filters → build
Any step failure halts the pipeline. See docs/operations/ci.md for details.
Release
See RELEASE_CHECKLIST.md before every merge to main.
Sanity Project
| Field | Value |
|---|
| Project ID | poalmzla |
| Dataset | production |
