Development

Run commands from the repo root unless noted.

Install

bun install

Common Commands

bun dev
bun run dev:plain

bun run web:dev
bun run web:build
bun run web:typecheck

bun run docs:dev
bun run docs:build
bun run docs:typecheck

bun run sales:dev
bun run sales:build
bun run sales:typecheck

bun run shared:typecheck
bun run typecheck

Workspace Layout

apps/
  api/   Hono document API
  web/   A-Grade Contracting website, Next.js App Router, Tailwind v4
  docs/  Fumadocs documentation app
  sales/ Vite invoice and proposal workspace
packages/
  shared/ Framework-neutral shared TypeScript

Keep app-specific dependencies in the app that imports them:

bun add --cwd apps/web package-name
bun add --cwd apps/docs package-name
bun add --cwd apps/sales package-name
bun add --cwd packages/shared package-name

Keep shared types and framework-neutral helpers in packages/shared.

Local Browser Notes

bun dev starts the complete workspace through Portless:

https://web.agrade
https://docs.agrade
https://sales.agrade
https://api.agrade

bun run dev:plain is the direct-port fallback. Web uses 3000, Docs uses 3001, Sales uses 5173, and the API uses 8787:

http://localhost:3000
http://localhost:3001
http://localhost:5173
http://localhost:8787/health

Documentation Assets

UI review screenshots live in:

apps/docs/public/ui-review/

Reference them from MDX as:

![Description](/ui-review/file-name.png)

Before Editing UI

Check these files first:

• apps/web/app/page.tsx for homepage section order and sticky hero mechanics.
• apps/web/components/layout/NavBar.tsx for fixed nav and overlay menu.
• apps/web/components/layout/MiddleNav.tsx for scroll-linked nav collapse.
• apps/web/components/home/ProjectsShowcase.tsx for the homepage projects filmstrip.
• apps/web/components/layout/Footer.tsx for the full-height footer.

Preserve the current bold, minimal, cinematic direction unless the design task explicitly changes it.

Launch Readiness Checklist

• Mobile nav does not overflow.
• Overlay menu works with keyboard and touch.
• Contact form submits to a real destination.
• Form controls have labels, names, validation, and states.
• Placeholder metrics, phone numbers, team entries, and social links are replaced or removed.
• Secondary page imagery is curated and relevant.
• bun run typecheck passes.
• bun run web:build and bun run docs:build pass.