A modern Next.js 16 starter with React 19, Tailwind CSS v4, and optional WebGL. Satūs means "beginning" in Latin.

Note: This README is for template developers. For client handoff, see PROD-README.md.

• Next.js 16 + React 19 — App Router with React 19.2 and strict TypeScript out of the box
• Tailwind v4 — Tailwind CSS v4 alongside CSS Modules
• Optional WebGL — React Three Fiber and GSAP, enabled only when you need them
• Pluggable integrations — Sanity, Shopify, and HubSpot wired and ready
• Interactive setup — scaffolds only the integrations you pick
• One-command handoff — strips branding, swaps in the prod README, and generates a component inventory
• Modern tooling — Bun, Biome, and Turbopack

bun install
bun run setup:project    # Interactive setup - choose integrations
cp .env.example .env.local
bun dev

Or skip setup and keep everything: bun install && bun dev

app/                    # Next.js pages and routes
components/             # UI components
lib/                    # Everything non-UI
  ├── hooks/           # Custom React hooks
  ├── integrations/    # Third-party services
  ├── styles/          # CSS & Tailwind
  ├── webgl/           # 3D graphics (optional)
  └── dev/             # Debug tools (optional)

Mental model: UI → components/, everything else → lib/

bun dev              # Development server
bun build            # Production build
bun lint             # Biome linter
bun run generate     # Generate pages/components
bun run setup:project  # Configure integrations
bun run handoff      # Prepare for client delivery

Prepare the codebase for client delivery:

bun run handoff

This interactive script:

• Removes example pages and Satūs branding
• Swaps README with production version
• Generates component inventory
• Updates package.json with project name

• Images: Use @/components/ui/image (never next/image directly)
• Links: Use @/components/ui/link (auto-handles external links)
• CSS Modules: Import as s → import s from './component.module.css'
• Debug Tools: Toggle with Cmd/Ctrl + O

vercel

Required GitHub Secret: VERCEL_TOKEN for Lighthouse CI workflow.

See ARCHITECTURE.md for deployment checklist and cache strategies.

MIT - Built by darkroom.engineering