Skip to content
MBR Knowledge Base

2026 04 21 Monorepo Template Cleanup

monorepo-Template-cleanup — 2026-04-21

Section titled “monorepo-Template-cleanup — 2026-04-21”

What changed

Section titled “What changed”

1. Template → template rename (global)

Section titled “1. Template → template rename (global)”
  • sites/Template/ folder renamed to sites/template/
  • All references updated in: CLAUDE.md, README.md, apps/CLAUDE.md, rebuild-linux.sh, .claude/commands/test-all.md, docs/*.md (13 files), web-deploy/config.yaml, web-deploy/README.md
  • Remaining visible “Template” text in site UI also lowercased: docs.astro, components.astro, Footer.astro, ContactForm.astro

2. Testing page added

Section titled “2. Testing page added”
  • Created /pages/testing — houses mbr-brand component test content
  • Moved from /blocks/mbr-brand/ (file deleted)
  • “Testing” added as first item in Pages nav submenu (Header.astro)

3. Components sidebar TOC cleanup

Section titled “3. Components sidebar TOC cleanup”
  • “myBetterRates Advisor” card removed from TOC without removing card content
  • Fix: changed <h2 slot="title"> → <h3 slot="title"> in MyBetterRatesShowcase.astro; TableOfContents uses maxLevel={2} so h3 is invisible to it

4. Docs page title

Section titled “4. Docs page title”
  • Changed from “template documentation” → “Documentation”

5. Cloudflare URL resolution

Section titled “5. Cloudflare URL resolution”
  • Original URL (dev.smartdebtcoach.com/docs/) was a custom domain on the site-template CF project
  • Custom domain removed from CF dashboard → project now accessible at its pages.dev URL
  • CF project name: site-template (display name, changeable)
  • CF project subdomain: site-template-183.pages.dev (permanent — assigned at creation, cannot be changed)
  • All docs updated to site-template-183.pages.dev

Key gotcha

Section titled “Key gotcha”

Cloudflare Pages pages.dev subdomains are immutable. The project name in CF Settings is a separate field from the pages.dev subdomain. Renaming the project does not change the subdomain. The -183 suffix was added at project creation because site-template was taken. To get a clean URL you must create a new project. Diagnostic: wrangler pages project list shows both project name and actual subdomain.

Files changed (monorepo)

Section titled “Files changed (monorepo)”
  • sites/template/ (renamed folder + all content)
  • sites/template/deploy.sh
  • sites/template/src/pages/pages/testing.astro (new)
  • sites/template/src/components/layout/Header.astro
  • sites/template/src/components/showcase/MyBetterRatesShowcase.astro
  • sites/template/src/pages/docs.astro
  • sites/template/src/pages/components.astro
  • sites/template/src/pages/health.json.ts
  • packages/components/src/layout/Footer.astro
  • sites/template/src/components/blocks/ContactForm.astro
  • apps/sd-app/static/_headers
  • CLAUDE.md, README.md, apps/CLAUDE.md, .claude/commands/test-all.md
  • docs/ARCHITECTURE.md, docs/COMMANDS.md, docs/DEPLOYMENT.md, docs/MONITORING.md

Files changed (web-deploy)

Section titled “Files changed (web-deploy)”
  • web-deploy/config.yaml
  • web-deploy/README.md