clienthub/.planning/phases/01-foundation-client-dashboard/01-05-SUMMARY.md

plan, status, commit, date

plan	status	commit	date
05	complete	073eec7	2026-05-14

Plan 01-05 Summary: Seed Script + DNS Configuration

Tasks Completed

Task 1: scripts/seed.ts ✓

• Created seed script with 107 lines
• Inserts 1 client → 3 phases → 6 tasks → 4 deliverables + 2 payments + 2 documents + 2 notes
• Token generated via nanoid (21 chars, ~126 bits entropy)
• Prints shareable URL: http://localhost:3000/c/[token]
• Run via: DATABASE_URL=<url> npx tsx scripts/seed.ts

Task 2: Seed execution verified ✓

• Seed ran successfully against Hetzner Postgres
• Test client created: Test Client Inc. / TestBrand
• Shareable link: http://localhost:3000/c/jXpPhUS-C6pCGAu5Va0Ct

Task 3: E2E dashboard test ✓

• Valid token → HTTP 200 (production build: next build + next start)
• Invalid token → HTTP 404
• Dev server also fixed (see Bug Fix below)

Task 4: DNS CNAME — Pending user action

• Prerequisites not yet met: no Vercel project linked, no deployment
• Steps to complete (after Vercel deployment):
  1. Run vercel --prod or connect via Vercel dashboard
  2. Add domain welcomeclient.iamcavalli.net in Vercel Project Settings → Domains
  3. At domain registrar for iamcavalli.net: add CNAME welcomeclient → cname.vercel-dns.com
  4. Verify: dig welcomeclient.iamcavalli.net +short should return cname.vercel-dns.com

Bug Fixed (outside plan scope)

Tailwind v4 scanning .01_projects/ directory

• Root cause: Tailwind v4 auto-detects and scans ALL files in the repo root
• The .01_projects/sparklingorbit subdirectory contains a Python .venv with markdown_it library
• That library has a regex comment containing [-:|] (a regex character class)
• Tailwind interpreted [-:|] as an arbitrary CSS property class → generates invalid CSS -: |
• Dev server Turbopack was treating this as a fatal CSS parse error → 500 on all pages
• Fix: added @source not directives in globals.css to exclude adjacent projects

Commits

• 073eec7 — feat(seed): add seed script + fix Tailwind scanning adjacent projects