Marketing site for Traced AI: tamper-evident audit infrastructure for EU AI Act compliance. Static SPA, deployed to Vercel.
- Vite 8 + React 19 + TypeScript 6
- Tailwind CSS v4
- react-router 7
- Bun 1.4 (runtime + package manager, pinned via
packageManagerinpackage.json; CI reads the same pin) - Vercel (hosting + analytics)
bun install
bun run dev| Command | What it does |
|---|---|
bun run dev |
Local dev server at localhost:5173 |
bun run build |
Production build to /dist |
bun run typecheck |
TypeScript check for src/ and tests/ (no emit) |
bun run lint |
ESLint |
bun run test |
Unit tests (bun test, in tests/) |
bun run preview |
Preview the production build locally |
Runs the same dev server in a container, so you need nothing but Docker installed. Serves on localhost:5173 with hot reload.
docker compose up # start (add -d to detach)
docker compose down # stop
docker compose exec web bun run typecheckcompose.yaml uses the stock oven/bun:1 image, no Dockerfile. Dependencies live in a named volume rather than the bind mount, so the host's node_modules and the container's stay independent: run bun install on the host too if you want editor type resolution. The DOCKER=1 env var switches Vite's watcher to polling, because bind mounts do not propagate inotify events.
Every PR and push to main runs typecheck, lint, tests, and build via GitHub Actions (.github/workflows/ci.yml). The check must pass before merging.
Dependabot (.github/dependabot.yml) opens weekly grouped PRs for npm and GitHub Actions. TypeScript major bumps are ignored until typescript-eslint's peer range allows them.
Pushes to main deploy automatically to traced-ai.com via Vercel.
Pull requests get a preview URL posted by the Vercel bot. Check the PR before merging.
| File | Contents |
|---|---|
docs/dev-guide.md |
Routing rules, design tokens, component conventions, copy editing |
docs/build-plan.md |
GTM blueprint, pricing tiers, milestone definitions |
docs/site-copy.md |
Structural and editorial summary of site copy; exact strings live in src/copy.ts |
docs/design-system.html |
Visual reference for tokens, fonts, and components (open in browser) |
docs/legal-deferred.md |
Copy and legal content deferred until product launch |
CLAUDE.md |
AI assistant instructions for this repo |