Web Workspace
Turborepo (bun) — the marketing site, this docs site, the dashboard, and the shared design system.
web/
├── apps/
│ ├── web/ Marketing/landing site (Next.js) — localhost:3000
│ ├── docs/ This docs site (Next.js + Fumadocs) — localhost:3001
│ └── dashboard/ Internal staff tool — localhost:3002, see /docs/dashboard
├── packages/
│ ├── ui/ Shared design tokens + components — @repo/ui
│ ├── eslint-config/
│ └── typescript-config/
├── turbo.json
├── package.json workspaces: ["apps/*", "packages/*"]
└── bun.lockPackage manager: bun 1.3.8 (devEngines.packageManager in the root
package.json). All scripts delegate through Turborepo:
bun install
bun run dev # every app, in parallel
bun run dev --filter=web # just the marketing site
bun run dev --filter=docs # just this docs site
bun run dev --filter=dashboard # just the dashboard
bun run build
bun run lint
bun run check-types@repo/ui
The design-token package all three apps build on — exported as
"./*": "./src/*.tsx" plus "./styles.css", so any file under
packages/ui/src is importable as @repo/ui/<name>. Not every app uses
every component: the dashboard reuses theme-toggle/providers and the
brand tokens, but deliberately skips the marketing-flavored ones
(cursor, preloader, smooth-scroll) — those read as gimmicks on an
internal admin tool, not polish.
Design tokens (styles.css) — warm-paper light mode, near-black dark mode,
emerald accent, one signature easing curve:
--bg: #f3f0e8; /* light */
--fg: #171612;
--accent: #10b981;
--warn: #f59e0b;
--ease-out-expo: cubic-bezier(0.16, 1, 0.3, 1);Component/utility inventory (packages/ui/src/): barcode-canvas,
button, container, count-up, cursor, hold, label-card,
marquee, parallax, preloader, providers, reveal, scan-demo,
scroll-progress, section-heading, smooth-scroll, sound,
theme-boot, theme-toggle, theme, typewriter, use-media,
use-pointer, plus a three.js scene system under scene/
(barcode-scene, particles-scene, resume) for the marketing site's 3D
elements (@react-three/fiber, @react-three/drei,
@react-three/postprocessing).
This docs site reuses the same tokens, deliberately
apps/docs maps Fumadocs' own --color-fd-* variables onto
@repo/ui's tokens rather than using a framework default palette — see
apps/docs/app/globals.css. A docs site skinned with a generic theme
reads as bolted-on rather than part of the product.
Adding a new app
Follow apps/web/apps/docs's existing shape exactly — same script names
(dev/build/start/lint/check-types), same @repo/eslint-config /
@repo/typescript-config references — so it slots into turbo.json's
existing task graph with no changes needed there. apps/dashboard is a
real example of exactly that: same shape, plus its own prisma/ for
typed local queries against the backend's database (never its own
migration authority — see Dashboard).

