Portfolio monorepo

Independent applications sharing one repository:

• ctw.studio/: Astro static site for CTW Studio, portfolio, Signals, workshop, legal pages, and design guide.
• about/: canonical Next.js source for NLeSC; exports the committed ctw.studio/nlesc/ subtree.
• jessegonzalez.dev/: SvelteKit portfolio.
• dashboard/: Bun Signals dashboard.
• ctw-kit/: shared Svelte library used by jessegonzalez.dev/.
• ctw.studio2/: historical alternate static portfolio.

Root package.json and bun.lock cover only ctw-kit/ and jessegonzalez.dev/. Every independent app uses its own root and lockfile. Never add a repository-root vercel.json.

CTW Studio

Astro builds a static artifact from ctw.studio/. Browser code remains progressive enhancement: every route has substantive HTML, Signals reads committed JSON, and historical pages pass through byte-identically.

cd ctw.studio
bun install --frozen-lockfile
bun run dev
bun run check
bun run build
bun run preview

bun run preview is canonical built-output preview. astro dev is source development only.

Architecture and route ownership

Sixteen Astro pages own maintained output:

• /, /portfolio/, /signals/
• /signals/ai-work/, /signals/demography/, /signals/education/, /signals/financial-fragility/, /signals/food/, /signals/healthspan/, /signals/housing/, /signals/real-time-ai/, /signals/science/
• /workshop/, /workshop/privacy/, /workshop/terms/
• /design-system/

src/pages/ owns route content; src/layouts/ owns document shells; src/components/DocumentHead.astro owns canonical metadata. SiteLayout.astro enables Astro ClientRouter only for safe landing/portfolio navigation. Signals keeps native reload boundaries. Workshop and design guide use native navigation.

preserve.manifest.json owns deterministic passthrough. Historical root experiments, /new/, workshop pitch/slides, stable runtime assets, and the generated NLeSC export remain source bytes copied into dist/. The preserved /signals/roadmap/ source is a permanent redirect source, not one of the 23 deployed content routes. Maintained source HTML is not preserved.

Legal pages use Astro directory output, matching stable production URLs. Tests reject dotted files, redirects, and extra aliases.

Maintained Astro routes self-host variable Inter and DM Mono 400/500 through app-local Fontsource packages. Historical preserved pages retain their original bytes and font links.

@floating-ui/dom stays pinned but contributes zero output bytes until a real positioned interaction needs it. Svelte is limited to explicit islands; current portfolio controller is the only interactive island.

Design system

Authority order:

1. DESIGN.md: normative language and exportable tokens.
2. design-system/tokens.css: browser roles.
3. design-system/components.css: shared components.
4. design-system/compositions.css: opt-in expressive compositions.
5. src/pages/design-system/index.astro: human guide specimens.
6. design-system/tokens.json: generated DTCG output; never hand-edit.

The guide stays absent from public navigation until separately approved. Signals accents remain page-scoped.

From repository root:

npx --yes @google/design.md@0.3.0 lint DESIGN.md
npx --yes @google/design.md@0.3.0 export --format dtcg DESIGN.md > /tmp/ctw-design-tokens.json
diff -u ctw.studio/design-system/tokens.json /tmp/ctw-design-tokens.json

Signals data

Browser routes read committed JSON only. No visitor-time evidence API or chart runtime belongs in Signals.

Run family gates from ctw.studio/:

bun run test:signals
bun run test:syntax

Official no-key data refreshes are explicit maintainer actions:

python3 signals/scripts/update_fred.py
python3 signals/scripts/update_food_data.py
python3 signals/scripts/update_housing_data.py
python3 signals/scripts/update_science_data.py
python3 signals/scripts/update_healthspan_data.py
python3 signals/scripts/update_demography_data.py
python3 signals/scripts/update_education_data.py
python3 signals/scripts/update_financial_fragility_data.py

Review JSON diffs, definitions, units, geography, period, chronology, and source URLs before accepting output. Papers, forecasts, experiments, interpretations, and maturity judgments remain manually curated.

Verification

Public targeted scripts build fresh output before testing:

bun run check
bun run build
bun run test:signals
bun run test:design
bun run test:syntax
bun run test:dist
bun run test:e2e
bun run test:visual
bun run test:lighthouse
bun run test:transfer

bun run test:ci runs check, one canonical build, then internal :built variants to avoid repeated builds. Use test:signals:built, test:design:built, test:dist:built, test:e2e:built, test:visual:built, test:lighthouse:built, test:lighthouse:quick:built, and test:transfer:built only in a workflow that has just completed bun run build. test:syntax remains source-only. Browser gates require installed Chromium:

bunx playwright install chromium

Lighthouse defaults to three runs per page and checks median values. bun run test:lighthouse:quick is one-run local feedback only.

Budgets:

Page	Performance	Accessibility	Extra
/	≥90	1.0	CLS ≤0.01
/portfolio/	≥80	1.0	LCP ≤2500ms, TBT ≤200ms, CLS ≤0.1, transfer ≤1.25MiB
/signals/	≥90	1.0	CLS ≤0.01
representative Signals brief	≥80	1.0	CLS ≤0.1
/workshop/	≥90	1.0	CLS ≤0.01
/design-system/	≥90	1.0	CLS ≤0.01

test:dist verifies exact 23-route contract, stable legal directories, preservation hashes, metadata, legacy nav.js absence on Astro pages, and zero Floating UI output.

Deployment

Vercel project ctw.studio uses Root Directory ctw.studio, framework Astro, bun run build, and output dist. App-local vercel.json owns redirects and headers. Local success does not authorize deployment, DNS/domain changes, redirect changes, or project deletion.

NLeSC export

about/ remains canonical and its legacy Vercel project stays active until separate cutover approval.

cd about
bun install --frozen-lockfile
bun run static:sync
bun run static:check

Never edit ctw.studio/nlesc/ by hand. Safe cutover order: preview, deploy CTW route, verify production, separately approve redirect, verify redirect, then retire legacy project.

Portfolio projects

Project copy lives in ctw.studio/src/data/projects.ts; stable media lives in ctw.studio/portfolio/projects/<project-id>/. Use AVIF covers and preserve public media URLs. Build generates responsive cover variants without changing source media.

License

MIT