TopBuilder Next.js Rebuild

Next.js recreation of topbuilder.dev to replace Framer-hosted delivery and deploy on a VPS.

Local Development

npm install
npm run dev

App runs at http://localhost:3000.

Project Layout

• src/app/page.tsx: Landing page composition
• src/data/topbuilder-content.ts: Editable content model
• src/app/globals.css: Visual system and responsive styles
• Dockerfile: Production image
• docker-compose.yml: VPS service orchestration
• Caddyfile: HTTPS reverse proxy config

VPS Deployment

1. Set DNS A records for topbuilder.dev and www.topbuilder.dev to your VPS.
2. On VPS, clone repo and enter site/.
3. Update Caddyfile domain values if needed.
4. Start services:

docker compose up -d --build

5. Verify:

curl -I https://topbuilder.dev

Migration Notes

The migration plan is documented in:

• ../llm/project/topbuilder-migration-plan.md

Operations Notes (2026-03-17)

• Production app path (VPS): /home/thrillerx/.openclaw/workspace/topbuilder-site
• Production process: pm2 topbuilder-site
• Standard deploy path currently used:
  • sync changed files from omarchy to VPS
  • npm run build
  • pm2 restart topbuilder-site
• Known runtime fixes deployed on this date:
  • hero/top overlap fixes on desktop
  • FAQ toggle behavior fixed with resilient delegated click handlers
  • FAQ question/answer mapping updated from cfb uploads
• Terminology update:
  • cfb = Codex File Bridge