Welcome to theAmbient Intelligenceplatform.

One monorepo, twelve apps, shared design system, single deploy pipeline. Here is how to maintain it and build on it.

Day-one setup, about thirty minutes
01Access

Make sure you have invites to the ambientintel GitHub org (platform repo at minimum) and the bribradley-7607s-projects Vercel team. Ask Brian if anything is missing.

02Tools

Install Node 24 via nvm. Enable pnpm via corepack (no global install needed). Optional: gh CLI, Vercel CLI.

03Clone

git clone git@github.com:ambientintel/platform.git, cd into it, pnpm install. One command for all 12 apps.

04Run

pnpm dev --filter=@ambientintel/ahg-www opens the homepage on localhost:3000. Swap the filter for any other app.

05Read in

docs/architecture.md, docs/conventions.md, docs/deploy.md, ADR-0001 through ADR-0003. About thirty minutes.

$ git clone git@github.com:ambientintel/platform.git && cd platform && pnpm install
What lives where
SubdomainApp folderPurpose
ambienthealthgroup.comapps/ahg-wwwMarketing site
eng.ambienthealthgroup.comapps/ambient-opsEngineering hub, internal ops
device.ambienthealthgroup.comapps/ambient-deviceFirmware, EE, mechanical, BOM
cloud.ambienthealthgroup.comapps/ambient-cloudCloud Ops Console, AWS runbooks
security.ambienthealthgroup.comapps/ambient-secCybersecurity hub
lab.ambienthealthgroup.comapps/ambient-labLabs hub (Algorithm, Code, Device, Background, Font)
reg.ambienthealthgroup.comapps/ambient-regRegulatory and SaMD
design.ambienthealthgroup.comapps/ambient-designDesign tooling
agentic.ambienthealthgroup.comapps/ambient-agenticAgentic, Biodesign, Clinical Research, Digital Health studios
algorithm.ambienthealthgroup.comapps/ambient-algorithmAlgorithm catalog
capital.ambienthealthgroup.comapps/capitalCapital raise platform
Shared packages
@ambientintel/tsconfig
Shared TypeScript configs (base.json, nextjs.json)
@ambientintel/eslint-config
Shared ESLint flat config
@ambientintel/tokens
Design tokens: colors, container width (1274px), spacing, fonts
@ambientintel/eng-domains
Single source of truth for engineering domain registry
@ambientintel/ui
Cross-app UI components: Footer, hub shells

Adding to packages requires ADR-0003 review. Bar: two apps need the code identically.

Conventions worth knowing
Conventional Commits
feat(scope): summary. Enforced via commitlint.
One approving review on main
No direct pushes. CODEOWNERS auto-requests reviewers.
Squash merge
main has one commit per PR. PR title becomes the squashed message.
Tiempos Fine + Die Grotesk
Klim licensed brand fonts. Never default to Newsreader or Inter.
Container width 1274px
Hub and landing pages. Matches anthropic.com visible content width.
No em dashes in copy
Use periods, commas, parentheses, colons instead.
Cream + parchment palette
#FAF9F6 background, #F0EEE6 cards, #1f1f1e text.
Read further
Architecture overview →
Subdomain map, package structure
Commit + branch conventions →
Conventional Commits, PR rules, code style
Deploy guide →
How a PR becomes production
Full onboarding doc →
Canonical version of this page
ADR-0001 Monorepo adoption →
Why one repo not twelve
ADR-0002 pnpm over npm →
Package manager rationale
ADR-0003 Package extraction →
When something earns packages/
Contributing guide →
Daily workflow, Turborepo filter syntax