Skip to content

Repository files navigation

Traced AI

Marketing site for Traced AI: tamper-evident audit infrastructure for EU AI Act compliance. Static SPA, deployed to Vercel.

Stack

  • Vite 8 + React 19 + TypeScript 6
  • Tailwind CSS v4
  • react-router-dom 7
  • Bun (runtime + package manager)
  • Vercel (hosting + analytics)

Setup

bun install
bun run dev

Commands

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 (no emit)
bun run lint ESLint
bun run preview Preview the production build locally

Docker (optional)

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 typecheck

compose.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.

CI

Every PR and push to main runs typecheck, lint, and build via GitHub Actions (.github/workflows/ci.yml). The check must pass before merging.

Deployments

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.

Docs

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

Contributors

Languages