rrweb-stack: Instructions file for Claude Code

@AGENTS.md

Claude Code

Deploying the docs sites

Both Astro docs sites (apps/peek-docs → peek.cubenest.in, apps/tracelane-docs → tracelane.cubenest.in) are deployed to Vercel via CLI. Deploy from the monorepo root — deploying from the app subdirectory only uploads that directory and leaves workspace deps (@cubenest/docs-shared, @peekdev/todomvc-demo) unresolvable on Vercel's build server.

Procedure:

1. Create a temporary vercel.json at the repo root (gitignored):

   // peek-docs
   {
     "installCommand": "pnpm install --frozen-lockfile",
     "buildCommand": "pnpm --filter peek-docs... run build",
     "outputDirectory": "apps/peek-docs/dist"
   }
   

2. Deploy with the project's env vars:

   VERCEL_PROJECT_ID=prj_wbLWp8utBFQXFpIxNC10i5ty5DNo \
   VERCEL_ORG_ID=team_ZKvGQO7dXxGBLl1iJ4vXWwnD \
   vercel --prod
   

3. Swap vercel.json for tracelane-docs and repeat:

   {
     "installCommand": "pnpm install --frozen-lockfile",
     "buildCommand": "pnpm --filter tracelane-docs... run build",
     "outputDirectory": "apps/tracelane-docs/dist"
   }
   

   VERCEL_PROJECT_ID=prj_4Lnsk0ODEw2gXUzPPpiz1an8gqzt \
   VERCEL_ORG_ID=team_ZKvGQO7dXxGBLl1iJ4vXWwnD \
   vercel --prod
   

4. Delete vercel.json and .vercel/ from the repo root when done.

Why: the cd ../.. && pnpm install install command in each app's .vercel/project.json was designed for Vercel Git integration (which clones the full repo). CLI deploys from a subdirectory upload only that directory, so the monorepo root is unreachable. Deploying from the root with VERCEL_PROJECT_ID uploads everything (≈15 MB) and pnpm --filter runs the build with correct PATH for cross-env and astro.