For AI agents

This page orients a coding agent that has been pointed at a Brand Portal codebase. If you are a human, What the portal is and Architecture are a better start.

Ingest the whole docs in one request

This site publishes the llms.txt standard:

• /llms.txt — a structured index of every page, with links and one-line summaries.
• /llms-full.txt — the entire documentation set concatenated as one Markdown file. Fetch this to load all developer and editor docs into context at once.

Which codebase are you in?

Two very different contexts share these docs — identify yours first:

1. A client site repo (e.g. acme-portal) — content and configuration only; the framework comes from the published @drawnagency/* packages. Most “build or run a site” tasks live here. Start with Building a client site.
2. The framework monorepo (Drawn-Agency/portal) — the five packages plus the dev, admin, and docs apps. Start with Monorepo & dev workflow.

Rules that will bite you if you ignore them

• Use pnpm. The monorepo enforces it with a preinstall only-allow pnpm hook; client repos are pnpm-based too (.npmrc + committed lockfile) but without that hook. Either way npm/yarn break the setup — always use pnpm.
• The editor import chain must be browser-safe. portal.config.mjs and src/sections.ts are bundled into the hydrated editor island. No node:*, Buffer, server adapters, or unguarded process.env. See Building custom sections and SSR / Netlify gotchas.
• Publish packages via scripts/publish.sh (which uses pnpm publish), never npm publish. npm publishes workspace:* dependencies literally and silently breaks every consumer install. See Publishing packages.
• The docs site (apps/docs) must not import @drawnagency/* — not even as types — so it builds independently of package dist. Reference the packages in prose and code fences only, never as a real import.
• Custom section types register via root src/sections.ts, not the sections config field. See Building custom sections.

Common tasks → start here

You want to…	Page
Stand up a new client site	Provisioning a new site
Configure a site	Configuration · Config reference
Add a custom section type	Building custom sections
Understand how rendering works	Architecture
Run the monorepo locally	Monorepo & dev workflow
Publish a package release	Publishing packages
Wire auth & audiences	Auth & audiences setup
Set environment variables	Environment variables · reference