Monorepo — Portal

KB portal for the monorepo ongoing project. The repo is the SSOT; this note is the KB’s single window into it. Owner dept: IT (IT Job Description). Registry: Ongoing-Projects.

What it is

Multi-site Astro monorepo + SvelteKit PWAs — the technical foundation for every business website. Houses the canonical UI component library, brand assets, shared packages, and the Template showcase that production sites (MBR, SDC, sd-app) are built from.

SSOT home (repo)

WSL: ~/projects/monorepo/ (= /home/ta/projects/monorepo/) · Windows: \\wsl$\Ubuntu-24.04\home\ta\projects\monorepo (WSL-home repo — not on D:)

Repo doc	Purpose
`README.md`	Human-first: structure, quick start, commands
`AGENTS.md`	SSOT AI context (all LLMs)
`CLAUDE.md` / `GEMINI.md`	Thin wrappers → AGENTS.md
`STATUS.md`	Live state ✓
`ROADMAP.md` / `UPGRADES.md`	Long-term plan + ideas (SSOT, in-repo) ✓
`CHANGELOG.md` / `LESSONS.md`	History + gotchas

Sub-projects (2026-07-10)

The monorepo is a mega ongoing project: each site/app is an ongoing sub-project with its own STATUS.md (state + backlog) inside its folder — root STATUS.md is the index. KB tasks stay in Core/IT/Tasks/ (repo-backed convention), named monorepo-<site>-…, ideally one rolling task note per active sub-project thread (e.g. monorepo-tscom-rebuild for ts.com).

Sub-project	Folder	Sub-STATUS
MBR site	`sites/mbr/`	`sites/mbr/STATUS.md` ✓
TS site (talbotstevens.com)	`sites/ts/`	`sites/ts/STATUS.md` ✓
SDC site	`sites/sdc/`	pending (create at rebuild kickoff)
Template (master library)	`sites/template/`	— (foundation)
sd-app (PWA)	`apps/sd-app/`	`apps/sd-app/STATUS.md` ✓

Structure (top level)

sites/ — Astro marketing sites: template/ (master library), mbr/ (active), sdc/, ts/
apps/ — SvelteKit PWAs: sd-app/ (leveraged-investing analysis)
packages/ — components/ (canonical UI), design-tokens/, i18n/, sd-api/ (FastAPI/uv), sd-math/ (financial math/uv)
src/brand/ — sd / ts / mbr brand assets
docs/ — design system + setup/deploy guides

Stack

pnpm only · Astro-first (90%) → AlpineJS (10%) → Svelte/React last · Tailwind · Playwright E2E (7 projects) + Vitest · WCAG AA · OKLCH tokens · Cloudflare Pages · branch main.

Working on it

A unit of work = an SMTM task in Core/IT/Tasks/ pointing here for context. Active: monorepo-tscom-rebuild (ts.com sub-project thread).

Dev logs → Core/IT/Logs/
Roadmap / upgrades live in the repo (ROADMAP.md / UPGRADES.md), not here (SSOT).

Project hygiene (✓ 2026-06-25 — monorepo-cleanup-upgrade)

Repo STATUS.md created (live state)
Repo ROADMAP.md + UPGRADES.md created per registry standard
Portal ↔ repo bidirectional links verified (repo AGENTS.md KB Note → this note)
Repo CLAUDE.md stale KB paths rewritten to the v5.2 model
Old _WorkingOn/Projects/monorepo/ + Core/Logs/Projects/monorepo/ trees retired; logs migrated to Core/IT/Logs/Projects/monorepo/