Canonical discovery files
- /agent-setup/ — prompt.md (“Copy prompt” installer)
- /llms.txt — full table of contents
- /AGENTS.md — short agent brief
- /sitemap.xml — crawlable URL list
- Marketing bridge: macrocontent.dev/llms.txt
What this product is
macrocontent is a content layer over existing websites. Sites integrate @macrocontent/sdk (+ optional @macrocontent/overlay), mark editable nodes with data-macro-key, and editors change content inline without redeploying the site for every copy change.
Which handbook to open
| Name | Type | Description |
|---|---|---|
Developers | SDK & components | Integrate @macrocontent/sdk, build custom components, and wire Vite or layouts. → /developers/ |
Dashboard | Sites & admin | Manage websites, team, domains, tokens, activity, webhooks, and site settings. → /dashboard/ |
Store | Buy & library | Browse the component store, claim or purchase, adopt updates, and install on websites. → /store/ |
Editors | Overlay & content | Edit sites with the macrocontent overlay — primitives, drafts, assets, and publish. → /editors/ |
Publishers | Sell & catalog | Ship store listings, packages, payouts, and a quality handbook for components. → /publishers/ |
API reference | OpenAPI / Swagger | Interactive Swagger for Management, Content, Store, and Publisher APIs. → /api/ |
Recommended path (implement a site)
Quickstart + credentials
Mark content
Custom blocks (optional)
Automate via API
Authentication · Swagger UI · OpenAPI catalog /docs.json · Specs /openapi/index.json (fetch JSON — do not scrape Swagger HTML)
Hard rules (do not invent)
Do
- Use trailing slashes on docs paths (
/developers/quickstart/). - Keep locales out of
data-macro-key— locale is a save dimension. - Prefer primitives for single fields; components for multi-field layouts.
- Read OpenAPI / API handbook before calling management or content APIs.
Don’t
- Don’t treat marketing pages as the integration contract.
- Don’t invent endpoint paths or auth headers.
- Don’t put secrets or management tokens in frontend
macro.config.js.
External discovery (marketing site)
| Name | Type | Description |
|---|---|---|
llms.txt | marketing | https://macrocontent.dev/llms.txt — product overview + pointer here |
agent-skills | marketing | https://macrocontent.dev/.well-known/agent-skills/index.json |
agent-setup | docs | https://docs.macrocontent.dev/agent-setup/prompt.md — Copy prompt installer |
api-catalog | marketing | https://macrocontent.dev/.well-known/api-catalog |