An open source design system that's fully customizable and agent ready
TypeScript
{
"about": [
"Every current doc route with its docs-tree placement. The CLI's own docs are placed (spec:AST-046, phase 1): the namespace rows and the command, function, and enum rows say where the tree puts them, and (d) checks it. Every other row is still a PROPOSED placement that moves nothing. doc-routes.test.mjs fails when a current route has no row, a row names a route that no longer exists, or a row breaks the placement rules below.",
"Rows: one per built-in topic (`astryx docs <topic>`) and per section key (`astryx docs <topic> <key>`); typed descriptors take one row per provider and kind, with `count` and the ids in doc-routes.ids.json under the row id. Placeholders <id> expand per id. Per-item rows would repeat one decision per group hundreds of times (704 templates alone).",
"placement: keep-flat (the route stays where it is), namespace:<path> (the doc becomes <path> in the graph), or generated:<provider>/<kind> (the unorganized bucket for typed descriptors that author no placement). Anything but keep-flat carries a one-line evidence note, and a namespace must be decided `create` under namespaces.",
"aliasNeeded: true when the proposal leaves the old CLI route or docsite URL without its content unless an alias keeps it resolving. Sections move with their topic.",
"oldDocsiteUrl: the public docsite URL (paths on astryx.atmeta.com). Topic and section URLs are checked; section anchors are the docsite outline ids (slugged titles). docsiteExceptions on descriptor rows were measured on 2026-09-24 from a canary data build of apps/docsite and are not rechecked by the test; production documents the latest published core, so a newer component has no page until release."
],
"idsFile": "doc-routes.ids.json",
"namespaces": [
{
"name": "cli",
"decision": "create",
"evidence": "cli/integrations documents the CLI's integration surface (see its row), and the NamespaceDoc contract's own example is a 'cli' namespace for commands, APIs and integration authoring.",
"note": "`astryx docs cli` reads the docs tree (spec:AST-046): its guides and the commands and api namespaces, one level at a time. /docs/cli is still the @astryxdesign/cli package page on the docsite; the namespace page must take that URL before the docsite publishes it. Considered and left out: authoring, whose section docs declare namespace 'authoring', a sibling of 'cli' in the SchemaDoc contract."
},
{
"name": "unorganized",
"decision": "create",
"evidence": "Every flat topic had no home in the tree: no parent, no breadcrumb, and Up went back to the topic list.",
"note": "The docs tree generates it (spec:AST-046 FR12). Each topic keeps its own name, so no route changes; the proposed placements in the rows below move topics out of it into real sections."
},
{
"name": "foundations",
"decision": "reject",
"evidence": "Only the docsite's 'foundations' category label groups color, elevation, icons, illustrations, motion, shape, spacing, tokens and typography. The docsite serves each flat at /docs/<topic>, and icons and illustrations are not token pages."
},
{
"name": "styling",
"decision": "reject",
"evidence": "styling-libraries is linked from styling and from theme; only the hyphen suggests styling/libraries."
},
{
"name": "theme",
"decision": "reject",
"evidence": "No topic is a child of theme: theme descriptors and theme command docs are typed descriptors (generated bucket), and theme's 17 sections stay with it."
},
{
"name": "migration",
"decision": "reject",
"evidence": "migration is one guide with no child topics; the draft shadcn-compatibility doc is not a route, and version upgrades are the upgrade command doc."
},
{
"name": "tokens",
"decision": "reject",
"evidence": "The six token-category pages pull their tables from tokens by token reference; the only other tie is the tokenCategory label. Nothing authored nests them."
}
],
"rows": [
{
"kind": "topic",
"id": "authoring",
"oldCliRoute": "astryx docs authoring",
"oldDocsiteUrl": "/docs/authoring",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Integration-author reference, built from the CLI's authoring self-docs (one section each). Stays top-level: the SchemaDoc contract names 'cli' and 'authoring' as sibling namespace paths, and 12 of its 15 section docs declare namespace 'authoring'. On the docsite, 14 of its 15 anchors come from section titles and differ from the section keys.",
"status": "proposed"
},
{
"kind": "section",
"id": "authoring#integration",
"oldCliRoute": "astryx docs authoring integration",
"oldDocsiteUrl": "/docs/authoring#astryx-integration",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of authoring under the same key. Its content is the schema self-doc `integration` (schema row), which the topic renders as one section.",
"status": "proposed"
},
{
"kind": "section",
"id": "authoring#config",
"oldCliRoute": "astryx docs authoring config",
"oldDocsiteUrl": "/docs/authoring#astryx-config",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of authoring under the same key. Its content is the schema self-doc `config` (schema row), which the topic renders as one section.",
"status": "proposed"
},
{
"kind": "section",
"id": "authoring#debug-event",
"oldCliRoute": "astryx docs authoring debug-event",
"oldDocsiteUrl": "/docs/authoring#debugevent",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of authoring under the same key. Its content is the schema self-doc `debug-event` (schema row), which the topic renders as one section.",
"status": "proposed"
},
{
"kind": "section",
"id": "authoring#gap-report-handler",
"oldCliRoute": "astryx docs authoring gap-report-handler",
"oldDocsiteUrl": "/docs/authoring#gapreporthandler",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of authoring under the same key. Its content is the schema self-doc `gap-report-handler` (schema row), which the topic renders as one section.",
"status": "proposed"
},
{
"kind": "section",
"id": "authoring#codemod",
"oldCliRoute": "astryx docs authoring codemod",
"oldDocsiteUrl": "/docs/authoring#astryx-codemod",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of authoring under the same key. Its content is the schema self-doc `codemod` (schema row), which the topic renders as one section.",
"status": "proposed"
},
{
"kind": "section",
"id": "authoring#provider-identity",
"oldCliRoute": "astryx docs authoring provider-identity",
"oldDocsiteUrl": "/docs/authoring#provider-and-artifact-identity",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of authoring under the same key. Its content is the schema self-doc `provider-identity` (schema row), which the topic renders as one section.",
"status": "proposed"
},
{
"kind": "section",
"id": "authoring#authored-doc-graph-fields",
"oldCliRoute": "astryx docs authoring authored-doc-graph-fields",
"oldDocsiteUrl": "/docs/authoring#authored-doc-graph-fields",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of authoring under the same key. Its content is the schema self-doc `authored-doc-graph-fields` (schema row), which the topic renders as one section.",
"status": "proposed"
},
{
"kind": "section",
"id": "authoring#component-doc",
"oldCliRoute": "astryx docs authoring component-doc",
"oldDocsiteUrl": "/docs/authoring#componentdoc",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of authoring under the same key. Its content is the schema self-doc `component-doc` (schema row), which the topic renders as one section.",
"status": "proposed"
},
{
"kind": "section",
"id": "authoring#hook-doc",
"oldCliRoute": "astryx docs authoring hook-doc",
"oldDocsiteUrl": "/docs/authoring#hookdoc",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of authoring under the same key. Its content is the schema self-doc `hook-doc` (schema row), which the topic renders as one section.",
"status": "proposed"
},
{
"kind": "section",
"id": "authoring#function-doc",
"oldCliRoute": "astryx docs authoring function-doc",
"oldDocsiteUrl": "/docs/authoring#functiondoc",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of authoring under the same key. Its content is the schema self-doc `function-doc` (schema row), which the topic renders as one section.",
"status": "proposed"
},
{
"kind": "section",
"id": "authoring#command-doc",
"oldCliRoute": "astryx docs authoring command-doc",
"oldDocsiteUrl": "/docs/authoring#commanddoc",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of authoring under the same key. Its content is the schema self-doc `command-doc` (schema row), which the topic renders as one section.",
"status": "proposed"
},
{
"kind": "section",
"id": "authoring#enum-doc",
"oldCliRoute": "astryx docs authoring enum-doc",
"oldDocsiteUrl": "/docs/authoring#enumdoc",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of authoring under the same key. Its content is the schema self-doc `enum-doc` (schema row), which the topic renders as one section.",
"status": "proposed"
},
{
"kind": "section",
"id": "authoring#namespace-doc",
"oldCliRoute": "astryx docs authoring namespace-doc",
"oldDocsiteUrl": "/docs/authoring#namespacedoc",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of authoring under the same key. Its content is the schema self-doc `namespace-doc` (schema row), which the topic renders as one section.",
"status": "proposed"
},
{
"kind": "section",
"id": "authoring#reference-doc",
"oldCliRoute": "astryx docs authoring reference-doc",
"oldDocsiteUrl": "/docs/authoring#referencedoc",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of authoring under the same key. Its content is the schema self-doc `reference-doc` (schema row), which the topic renders as one section.",
"status": "proposed"
},
{
"kind": "section",
"id": "authoring#schema-doc",
"oldCliRoute": "astryx docs authoring schema-doc",
"oldDocsiteUrl": "/docs/authoring#schemadoc",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of authoring under the same key. Its content is the schema self-doc `schema-doc` (schema row), which the topic renders as one section.",
"status": "proposed"
},
{
"kind": "section",
"id": "authoring#template-doc",
"oldCliRoute": "astryx docs authoring template-doc",
"oldDocsiteUrl": "/docs/authoring#templatedoc",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of authoring under the same key. Its content is the schema self-doc `template-doc` (schema row), which the topic renders as one section.",
"status": "proposed"
},
{
"kind": "section",
"id": "authoring#theme-doc",
"oldCliRoute": "astryx docs authoring theme-doc",
"oldDocsiteUrl": "/docs/authoring#themedoc",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of authoring under the same key. Its content is the schema self-doc `theme-doc` (schema row), which the topic renders as one section.",
"status": "proposed"
},
{
"kind": "namespace",
"id": "cli",
"oldCliRoute": "astryx docs cli",
"oldDocsiteUrl": null,
"placement": "namespace:cli",
"aliasNeeded": false,
"evidence": "assets/docs/tree/cli.doc.mjs declares it; astryx doctor fails when the tree does not build or a CLI doc in a cli group has no route.",
"rationale": "The top of the CLI docs tree: its guides (cli/integrations) and its reference (cli/commands and cli/api), one level at a time. The docsite does not publish it yet, because /docs/cli is the @astryxdesign/cli package page.",
"status": "proposed"
},
{
"kind": "namespace",
"id": "cli/commands",
"oldCliRoute": "astryx docs cli/commands",
"oldDocsiteUrl": null,
"placement": "namespace:cli/commands",
"aliasNeeded": false,
"evidence": "assets/docs/tree/commands.doc.mjs declares it.",
"rationale": "Adopts every command doc whose namespace is cli/commands, one leaf each at cli/commands/<name>. The docsite does not publish it yet.",
"status": "proposed"
},
{
"kind": "namespace",
"id": "cli/api",
"oldCliRoute": "astryx docs cli/api",
"oldDocsiteUrl": null,
"placement": "namespace:cli/api",
"aliasNeeded": false,
"evidence": "assets/docs/tree/api.doc.mjs declares it.",
"rationale": "Adopts every function, schema, and enum doc whose namespace is cli/api, one generated level per kind. The docsite does not publish it yet.",
"status": "proposed"
},
{
"kind": "namespace",
"id": "cli/api/functions",
"oldCliRoute": "astryx docs cli/api/functions",
"oldDocsiteUrl": null,
"placement": "namespace:cli/api/functions",
"aliasNeeded": false,
"evidence": "The api namespace adopts cli/api with groupBy kind.",
"rationale": "Generated by the api namespace for its function docs, one leaf each at cli/api/functions/<name>. The docsite does not publish it yet.",
"status": "proposed"
},
{
"kind": "namespace",
"id": "cli/api/schemas",
"oldCliRoute": "astryx docs cli/api/schemas",
"oldDocsiteUrl": null,
"placement": "namespace:cli/api/schemas",
"aliasNeeded": false,
"evidence": "The api namespace adopts cli/api with groupBy kind.",
"rationale": "Generated by the api namespace for its schema docs (the JSON output envelope). The docsite does not publish it yet.",
"status": "proposed"
},
{
"kind": "namespace",
"id": "cli/api/enums",
"oldCliRoute": "astryx docs cli/api/enums",
"oldDocsiteUrl": null,
"placement": "namespace:cli/api/enums",
"aliasNeeded": false,
"evidence": "The api namespace adopts cli/api with groupBy kind.",
"rationale": "Generated by the api namespace for its enum docs (error codes and response types). The docsite does not publish it yet.",
"status": "proposed"
},
{
"kind": "namespace",
"id": "unorganized",
"oldCliRoute": "astryx docs unorganized",
"oldDocsiteUrl": null,
"placement": "namespace:unorganized",
"aliasNeeded": false,
"evidence": "The docs tree generates it: every flat topic sits in it, in the order the topic list reads.",
"rationale": "The home of every topic that no section places yet. Each keeps its own name, so no route changes; placing a topic in a real section takes it out.",
"status": "proposed"
},
{
"kind": "topic",
"id": "browser-support",
"oldCliRoute": "astryx docs browser-support",
"oldDocsiteUrl": "/docs/browser-support",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Standalone guide: no topic links to it, and nothing authored places it under another topic.",
"status": "proposed"
},
{
"kind": "section",
"id": "browser-support#overview",
"oldCliRoute": "astryx docs browser-support overview",
"oldDocsiteUrl": "/docs/browser-support#overview",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of browser-support under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "browser-support#support-tiers",
"oldCliRoute": "astryx docs browser-support support-tiers",
"oldDocsiteUrl": "/docs/browser-support#support-tiers",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of browser-support under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "browser-support#which-features-set-the-floor",
"oldCliRoute": "astryx docs browser-support which-features-set-the-floor",
"oldDocsiteUrl": "/docs/browser-support#which-features-set-the-floor",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of browser-support under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "browser-support#which-components-are-affected",
"oldCliRoute": "astryx docs browser-support which-components-are-affected",
"oldDocsiteUrl": "/docs/browser-support#which-components-are-affected",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of browser-support under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "browser-support#what-astryx-guarantees",
"oldCliRoute": "astryx docs browser-support what-astryx-guarantees",
"oldDocsiteUrl": "/docs/browser-support#what-astryx-guarantees",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of browser-support under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "browser-support#supporting-older-browsers",
"oldCliRoute": "astryx docs browser-support supporting-older-browsers",
"oldDocsiteUrl": "/docs/browser-support#supporting-older-browsers",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of browser-support under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "browser-support#how-these-tiers-move-over-time",
"oldCliRoute": "astryx docs browser-support how-these-tiers-move-over-time",
"oldDocsiteUrl": "/docs/browser-support#how-these-tiers-move-over-time",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of browser-support under the same key.",
"status": "proposed"
},
{
"kind": "namespace",
"id": "cli/integrations",
"oldCliRoute": "astryx docs cli/integrations",
"oldDocsiteUrl": null,
"placement": "namespace:cli/integrations",
"aliasNeeded": false,
"evidence": "assets/docs/tree/integrations.doc.mjs declares it, and places it in cli's guides slot.",
"rationale": "The integration guides, one short guide per task in four slots: start, contribute, ship, and help. It replaced the single cli/integrations guide, whose docsite page /docs/cli-integrations redirects to cli/integrations/overview. The docsite does not publish the namespace itself yet.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/overview",
"oldCliRoute": "astryx docs cli/integrations/overview",
"oldDocsiteUrl": "/docs/cli-integrations-overview",
"placement": "namespace:cli/integrations",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:integrations', slot: 'start', order: 10}.",
"rationale": "Overview: An integration is an npm package that hooks into the Astryx CLI and makes it your own. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/overview#what-you-can-do",
"oldCliRoute": "astryx docs cli/integrations/overview what-you-can-do",
"oldDocsiteUrl": "/docs/cli-integrations-overview#what-you-can-do",
"placement": "namespace:cli/integrations/overview",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/overview.",
"rationale": "A section of cli/integrations/overview: What you can do.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/overview#how-an-app-finds-it",
"oldCliRoute": "astryx docs cli/integrations/overview how-an-app-finds-it",
"oldDocsiteUrl": "/docs/cli-integrations-overview#find-and-install-an-integration",
"placement": "namespace:cli/integrations/overview",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/overview.",
"rationale": "A section of cli/integrations/overview: Find and install an integration.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/make-a-package",
"oldCliRoute": "astryx docs cli/integrations/make-a-package",
"oldDocsiteUrl": "/docs/cli-integrations-make-a-package",
"placement": "namespace:cli/integrations",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:integrations', slot: 'start', order: 20}.",
"rationale": "Make a package: Create a new integration package and understand the package files the CLI maintains. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/make-a-package#quick-start",
"oldCliRoute": "astryx docs cli/integrations/make-a-package quick-start",
"oldDocsiteUrl": "/docs/cli-integrations-make-a-package#quick-start",
"placement": "namespace:cli/integrations/make-a-package",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/make-a-package.",
"rationale": "A section of cli/integrations/make-a-package: Quick start.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/make-a-package#fill-in-package-json",
"oldCliRoute": "astryx docs cli/integrations/make-a-package fill-in-package-json",
"oldDocsiteUrl": "/docs/cli-integrations-make-a-package#fill-in-package-json",
"placement": "namespace:cli/integrations/make-a-package",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/make-a-package.",
"rationale": "A section of cli/integrations/make-a-package: Fill in package.json.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/make-a-package#the-integration-file",
"oldCliRoute": "astryx docs cli/integrations/make-a-package the-integration-file",
"oldDocsiteUrl": "/docs/cli-integrations-make-a-package#the-integration-file",
"placement": "namespace:cli/integrations/make-a-package",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/make-a-package.",
"rationale": "A section of cli/integrations/make-a-package: The integration file.",
"status": "proposed"
},
{
"kind": "namespace",
"id": "cli/integrations/components",
"oldCliRoute": "astryx docs cli/integrations/components",
"oldDocsiteUrl": null,
"placement": "namespace:cli/integrations/components",
"aliasNeeded": false,
"evidence": "assets/docs/tree/components.doc.mjs declares it and places it in cli/integrations' contribute slot.",
"rationale": "The guides for adding, documenting, exporting, replacing, and checking integration components, one level at a time. The docsite does not publish the namespace itself yet.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/components/add-a-component",
"oldCliRoute": "astryx docs cli/integrations/components/add-a-component",
"oldDocsiteUrl": "/docs/cli-integrations-components-add-a-component",
"placement": "namespace:cli/integrations/components",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:components', slot: 'build', order: 10}.",
"rationale": "Add a component: Choose a stable component name and generate its source, doc, package export, and integration entry. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/components/add-a-component#pick-a-component-name",
"oldCliRoute": "astryx docs cli/integrations/components/add-a-component pick-a-component-name",
"oldDocsiteUrl": "/docs/cli-integrations-components-add-a-component#pick-a-component-name",
"placement": "namespace:cli/integrations/components/add-a-component",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/components/add-a-component.",
"rationale": "A section of cli/integrations/components/add-a-component: Pick a component name.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/components/add-a-component#run-the-add-command",
"oldCliRoute": "astryx docs cli/integrations/components/add-a-component run-the-add-command",
"oldDocsiteUrl": "/docs/cli-integrations-components-add-a-component#run-the-add-command",
"placement": "namespace:cli/integrations/components/add-a-component",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/components/add-a-component.",
"rationale": "A section of cli/integrations/components/add-a-component: Run the add command.",
"status": "proposed"
},
{
"kind": "namespace",
"id": "cli/integrations/components/describe-the-component",
"oldCliRoute": "astryx docs cli/integrations/components/describe-the-component",
"oldDocsiteUrl": null,
"placement": "namespace:cli/integrations/components/describe-the-component",
"aliasNeeded": false,
"evidence": "assets/docs/tree/describe-the-component.doc.mjs declares it and places it in Components' build slot.",
"rationale": "The component-documentation guides: an overview, the default single-component doc, and adaptations for a family or subcomponent. The docsite does not publish the namespace itself yet.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/components/describe-the-component/component-doc-overview",
"oldCliRoute": "astryx docs cli/integrations/components/describe-the-component/component-doc-overview",
"oldDocsiteUrl": "/docs/cli-integrations-components-describe-the-component-component-doc-overview",
"placement": "namespace:cli/integrations/components/describe-the-component",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:describe-the-component', slot: 'guides', order: 10}.",
"rationale": "Component doc overview: Treat the component doc as a public contract, keep it synchronized with source, and inspect the result consumers receive. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/components/describe-the-component/component-doc-overview#treat-the-doc-as-public-api",
"oldCliRoute": "astryx docs cli/integrations/components/describe-the-component/component-doc-overview treat-the-doc-as-public-api",
"oldDocsiteUrl": "/docs/cli-integrations-components-describe-the-component-component-doc-overview#treat-the-doc-as-public-api",
"placement": "namespace:cli/integrations/components/describe-the-component/component-doc-overview",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/components/describe-the-component/component-doc-overview.",
"rationale": "A section of cli/integrations/components/describe-the-component/component-doc-overview: Treat the doc as public API.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/components/describe-the-component/component-doc-overview#fill-in-the-shared-fields",
"oldCliRoute": "astryx docs cli/integrations/components/describe-the-component/component-doc-overview fill-in-the-shared-fields",
"oldDocsiteUrl": "/docs/cli-integrations-components-describe-the-component-component-doc-overview#fill-in-the-shared-fields",
"placement": "namespace:cli/integrations/components/describe-the-component/component-doc-overview",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/components/describe-the-component/component-doc-overview.",
"rationale": "A section of cli/integrations/components/describe-the-component/component-doc-overview: Fill in the shared fields.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/components/describe-the-component/component-doc-overview#read-the-doc-back",
"oldCliRoute": "astryx docs cli/integrations/components/describe-the-component/component-doc-overview read-the-doc-back",
"oldDocsiteUrl": "/docs/cli-integrations-components-describe-the-component-component-doc-overview#read-the-doc-back",
"placement": "namespace:cli/integrations/components/describe-the-component/component-doc-overview",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/components/describe-the-component/component-doc-overview.",
"rationale": "A section of cli/integrations/components/describe-the-component/component-doc-overview: Read the doc back.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/components/describe-the-component/single-component",
"oldCliRoute": "astryx docs cli/integrations/components/describe-the-component/single-component",
"oldDocsiteUrl": "/docs/cli-integrations-components-describe-the-component-single-component",
"placement": "namespace:cli/integrations/components/describe-the-component",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:describe-the-component', slot: 'guides', order: 20}.",
"rationale": "Single component: Write the default component doc: explain when to use the component, document every public prop, and add focused examples. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/components/describe-the-component/single-component#start-from-the-generated-doc",
"oldCliRoute": "astryx docs cli/integrations/components/describe-the-component/single-component start-from-the-generated-doc",
"oldDocsiteUrl": "/docs/cli-integrations-components-describe-the-component-single-component#start-from-the-generated-doc",
"placement": "namespace:cli/integrations/components/describe-the-component/single-component",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/components/describe-the-component/single-component.",
"rationale": "A section of cli/integrations/components/describe-the-component/single-component: Start from the generated doc.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/components/describe-the-component/single-component#explain-when-to-use-it",
"oldCliRoute": "astryx docs cli/integrations/components/describe-the-component/single-component explain-when-to-use-it",
"oldDocsiteUrl": "/docs/cli-integrations-components-describe-the-component-single-component#explain-when-to-use-it",
"placement": "namespace:cli/integrations/components/describe-the-component/single-component",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/components/describe-the-component/single-component.",
"rationale": "A section of cli/integrations/components/describe-the-component/single-component: Explain when to use it.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/components/describe-the-component/single-component#document-every-public-prop",
"oldCliRoute": "astryx docs cli/integrations/components/describe-the-component/single-component document-every-public-prop",
"oldDocsiteUrl": "/docs/cli-integrations-components-describe-the-component-single-component#document-every-public-prop",
"placement": "namespace:cli/integrations/components/describe-the-component/single-component",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/components/describe-the-component/single-component.",
"rationale": "A section of cli/integrations/components/describe-the-component/single-component: Document every public prop.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/components/describe-the-component/single-component#add-focused-examples",
"oldCliRoute": "astryx docs cli/integrations/components/describe-the-component/single-component add-focused-examples",
"oldDocsiteUrl": "/docs/cli-integrations-components-describe-the-component-single-component#add-focused-examples",
"placement": "namespace:cli/integrations/components/describe-the-component/single-component",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/components/describe-the-component/single-component.",
"rationale": "A section of cli/integrations/components/describe-the-component/single-component: Add focused examples.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/components/describe-the-component/single-component#read-the-result",
"oldCliRoute": "astryx docs cli/integrations/components/describe-the-component/single-component read-the-result",
"oldDocsiteUrl": "/docs/cli-integrations-components-describe-the-component-single-component#read-the-result",
"placement": "namespace:cli/integrations/components/describe-the-component/single-component",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/components/describe-the-component/single-component.",
"rationale": "A section of cli/integrations/components/describe-the-component/single-component: Read the result.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/components/describe-the-component/component-family",
"oldCliRoute": "astryx docs cli/integrations/components/describe-the-component/component-family",
"oldDocsiteUrl": "/docs/cli-integrations-components-describe-the-component-component-family",
"placement": "namespace:cli/integrations/components/describe-the-component",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:describe-the-component', slot: 'guides', order: 30}.",
"rationale": "Component family: Adapt a single-component doc when one module exposes several public components or hooks that belong to one family. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/components/describe-the-component/component-family#choose-the-family-shape",
"oldCliRoute": "astryx docs cli/integrations/components/describe-the-component/component-family choose-the-family-shape",
"oldDocsiteUrl": "/docs/cli-integrations-components-describe-the-component-component-family#choose-the-family-shape",
"placement": "namespace:cli/integrations/components/describe-the-component/component-family",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/components/describe-the-component/component-family.",
"rationale": "A section of cli/integrations/components/describe-the-component/component-family: Choose the family shape.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/components/describe-the-component/component-family#document-the-family-inline",
"oldCliRoute": "astryx docs cli/integrations/components/describe-the-component/component-family document-the-family-inline",
"oldDocsiteUrl": "/docs/cli-integrations-components-describe-the-component-component-family#document-the-family-inline",
"placement": "namespace:cli/integrations/components/describe-the-component/component-family",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/components/describe-the-component/component-family.",
"rationale": "A section of cli/integrations/components/describe-the-component/component-family: Document the family inline.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/components/describe-the-component/component-family#give-a-member-its-own-file",
"oldCliRoute": "astryx docs cli/integrations/components/describe-the-component/component-family give-a-member-its-own-file",
"oldDocsiteUrl": "/docs/cli-integrations-components-describe-the-component-component-family#give-a-member-its-own-file",
"placement": "namespace:cli/integrations/components/describe-the-component/component-family",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/components/describe-the-component/component-family.",
"rationale": "A section of cli/integrations/components/describe-the-component/component-family: Give a member its own file.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/components/describe-the-component/subcomponent",
"oldCliRoute": "astryx docs cli/integrations/components/describe-the-component/subcomponent",
"oldDocsiteUrl": "/docs/cli-integrations-components-describe-the-component-subcomponent",
"placement": "namespace:cli/integrations/components/describe-the-component",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:describe-the-component', slot: 'guides', order: 40}.",
"rationale": "Subcomponent: Move one member of a component family into its own sibling doc without duplicating it in the parent. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/components/describe-the-component/subcomponent#choose-a-separate-doc",
"oldCliRoute": "astryx docs cli/integrations/components/describe-the-component/subcomponent choose-a-separate-doc",
"oldDocsiteUrl": "/docs/cli-integrations-components-describe-the-component-subcomponent#choose-a-separate-doc",
"placement": "namespace:cli/integrations/components/describe-the-component/subcomponent",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/components/describe-the-component/subcomponent.",
"rationale": "A section of cli/integrations/components/describe-the-component/subcomponent: Choose a separate doc.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/components/describe-the-component/subcomponent#reference-it-from-the-parent",
"oldCliRoute": "astryx docs cli/integrations/components/describe-the-component/subcomponent reference-it-from-the-parent",
"oldDocsiteUrl": "/docs/cli-integrations-components-describe-the-component-subcomponent#reference-it-from-the-parent",
"placement": "namespace:cli/integrations/components/describe-the-component/subcomponent",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/components/describe-the-component/subcomponent.",
"rationale": "A section of cli/integrations/components/describe-the-component/subcomponent: Reference it from the parent.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/components/describe-the-component/subcomponent#write-the-subcomponent-doc",
"oldCliRoute": "astryx docs cli/integrations/components/describe-the-component/subcomponent write-the-subcomponent-doc",
"oldDocsiteUrl": "/docs/cli-integrations-components-describe-the-component-subcomponent#write-the-subcomponent-doc",
"placement": "namespace:cli/integrations/components/describe-the-component/subcomponent",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/components/describe-the-component/subcomponent.",
"rationale": "A section of cli/integrations/components/describe-the-component/subcomponent: Write the subcomponent doc.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/components/component-imports",
"oldCliRoute": "astryx docs cli/integrations/components/component-imports",
"oldDocsiteUrl": "/docs/cli-integrations-components-component-imports",
"placement": "namespace:cli/integrations/components",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:components', slot: 'build', order: 30}.",
"rationale": "Resolve the import: Keep the component doc import and package exports map aligned, then verify the packed package. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/components/component-imports#export-the-component",
"oldCliRoute": "astryx docs cli/integrations/components/component-imports export-the-component",
"oldDocsiteUrl": "/docs/cli-integrations-components-component-imports#export-the-component",
"placement": "namespace:cli/integrations/components/component-imports",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/components/component-imports.",
"rationale": "A section of cli/integrations/components/component-imports: Export the component.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/components/component-imports#verify-the-packed-import",
"oldCliRoute": "astryx docs cli/integrations/components/component-imports verify-the-packed-import",
"oldDocsiteUrl": "/docs/cli-integrations-components-component-imports#verify-the-packed-import",
"placement": "namespace:cli/integrations/components/component-imports",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/components/component-imports.",
"rationale": "A section of cli/integrations/components/component-imports: Verify the packed import.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/components/see-it-in-an-app",
"oldCliRoute": "astryx docs cli/integrations/components/see-it-in-an-app",
"oldDocsiteUrl": "/docs/cli-integrations-components-see-it-in-an-app",
"placement": "namespace:cli/integrations/components",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:components', slot: 'build', order: 40}.",
"rationale": "See it in an app: Confirm that an app discovers the component, its package, its public import, and its documentation. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/components/see-it-in-an-app#read-the-installed-component",
"oldCliRoute": "astryx docs cli/integrations/components/see-it-in-an-app read-the-installed-component",
"oldDocsiteUrl": "/docs/cli-integrations-components-see-it-in-an-app#read-the-installed-component",
"placement": "namespace:cli/integrations/components/see-it-in-an-app",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/components/see-it-in-an-app.",
"rationale": "A section of cli/integrations/components/see-it-in-an-app: Read the installed component.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/components/see-it-in-an-app#test-the-packed-package",
"oldCliRoute": "astryx docs cli/integrations/components/see-it-in-an-app test-the-packed-package",
"oldDocsiteUrl": "/docs/cli-integrations-components-see-it-in-an-app#test-the-packed-package",
"placement": "namespace:cli/integrations/components/see-it-in-an-app",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/components/see-it-in-an-app.",
"rationale": "A section of cli/integrations/components/see-it-in-an-app: Test the packed package.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/components/replace-a-core-component",
"oldCliRoute": "astryx docs cli/integrations/components/replace-a-core-component",
"oldDocsiteUrl": "/docs/cli-integrations-components-replace-a-core-component",
"placement": "namespace:cli/integrations/components",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:components', slot: 'advanced', order: 10}.",
"rationale": "Replace a Core component: Use a component replacement only when an integration must intentionally own a Core component identity. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/components/replace-a-core-component#decide-whether-to-replace",
"oldCliRoute": "astryx docs cli/integrations/components/replace-a-core-component decide-whether-to-replace",
"oldDocsiteUrl": "/docs/cli-integrations-components-replace-a-core-component#decide-whether-to-replace",
"placement": "namespace:cli/integrations/components/replace-a-core-component",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/components/replace-a-core-component.",
"rationale": "A section of cli/integrations/components/replace-a-core-component: Decide whether to replace.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/components/replace-a-core-component#set-the-replacement",
"oldCliRoute": "astryx docs cli/integrations/components/replace-a-core-component set-the-replacement",
"oldDocsiteUrl": "/docs/cli-integrations-components-replace-a-core-component#set-the-replacement",
"placement": "namespace:cli/integrations/components/replace-a-core-component",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/components/replace-a-core-component.",
"rationale": "A section of cli/integrations/components/replace-a-core-component: Set the replacement.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/components/replace-a-core-component#check-replacement-resolution",
"oldCliRoute": "astryx docs cli/integrations/components/replace-a-core-component check-replacement-resolution",
"oldDocsiteUrl": "/docs/cli-integrations-components-replace-a-core-component#check-replacement-resolution",
"placement": "namespace:cli/integrations/components/replace-a-core-component",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/components/replace-a-core-component.",
"rationale": "A section of cli/integrations/components/replace-a-core-component: Check replacement resolution.",
"status": "proposed"
},
{
"kind": "namespace",
"id": "cli/integrations/templates",
"oldCliRoute": "astryx docs cli/integrations/templates",
"oldDocsiteUrl": null,
"placement": "namespace:cli/integrations/templates",
"aliasNeeded": false,
"evidence": "assets/docs/tree/templates.doc.mjs declares this namespace and places it with placement {parent: 'namespace:integrations', slot: 'contribute', order: 20}.",
"rationale": "Templates: Templates are ready-made UI pages or page sections built with Astryx. Apps copy them into their code and adapt them to their product. The route stays the same while the former flat guide becomes a navigable namespace.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/templates/start-a-template",
"oldCliRoute": "astryx docs cli/integrations/templates/start-a-template",
"oldDocsiteUrl": "/docs/cli-integrations-templates-start-a-template",
"placement": "namespace:cli/integrations/templates",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:templates', slot: 'build', order: 10}.",
"rationale": "Start a template: Help others build apps faster and share a consistent visual language by turning your UI idea into a full page or page section. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/start-a-template#what-a-template-is",
"oldCliRoute": "astryx docs cli/integrations/templates/start-a-template what-a-template-is",
"oldDocsiteUrl": "/docs/cli-integrations-templates-start-a-template#what-a-template-is",
"placement": "namespace:cli/integrations/templates/start-a-template",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/start-a-template.",
"rationale": "A section of cli/integrations/templates/start-a-template: What a template is.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/start-a-template#why-share-one",
"oldCliRoute": "astryx docs cli/integrations/templates/start-a-template why-share-one",
"oldDocsiteUrl": "/docs/cli-integrations-templates-start-a-template#why-share-one",
"placement": "namespace:cli/integrations/templates/start-a-template",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/start-a-template.",
"rationale": "A section of cli/integrations/templates/start-a-template: Why share one.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/start-a-template#choose-page-or-block",
"oldCliRoute": "astryx docs cli/integrations/templates/start-a-template choose-page-or-block",
"oldDocsiteUrl": "/docs/cli-integrations-templates-start-a-template#choose-a-page-or-block",
"placement": "namespace:cli/integrations/templates/start-a-template",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/start-a-template.",
"rationale": "A section of cli/integrations/templates/start-a-template: Choose a page or block.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/start-a-template#pick-a-template-id",
"oldCliRoute": "astryx docs cli/integrations/templates/start-a-template pick-a-template-id",
"oldDocsiteUrl": "/docs/cli-integrations-templates-start-a-template#pick-a-template-id",
"placement": "namespace:cli/integrations/templates/start-a-template",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/start-a-template.",
"rationale": "A section of cli/integrations/templates/start-a-template: Pick a template id.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/start-a-template#run-the-add-command",
"oldCliRoute": "astryx docs cli/integrations/templates/start-a-template run-the-add-command",
"oldDocsiteUrl": "/docs/cli-integrations-templates-start-a-template#run-the-add-command",
"placement": "namespace:cli/integrations/templates/start-a-template",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/start-a-template.",
"rationale": "A section of cli/integrations/templates/start-a-template: Run the add command.",
"status": "proposed"
},
{
"kind": "namespace",
"id": "cli/integrations/templates/document-the-template",
"oldCliRoute": "astryx docs cli/integrations/templates/document-the-template",
"oldDocsiteUrl": null,
"placement": "namespace:cli/integrations/templates/document-the-template",
"aliasNeeded": false,
"evidence": "assets/docs/tree/document-the-template.doc.mjs declares this namespace and places it with placement {parent: 'namespace:templates', slot: 'build', order: 20}.",
"rationale": "Document the template: Write the doc that helps people and agents find, choose, and trust your template: its name, description, readiness, preview, and any Core replacement. This namespace is new in this change, so it has no older route or docsite page.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/templates/document-the-template/template-doc-overview",
"oldCliRoute": "astryx docs cli/integrations/templates/document-the-template/template-doc-overview",
"oldDocsiteUrl": "/docs/cli-integrations-templates-document-the-template-template-doc-overview",
"placement": "namespace:cli/integrations/templates/document-the-template",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:document-the-template', slot: 'guides', order: 10}.",
"rationale": "Template doc overview: Understand what the template doc controls, keep it accurate as the UI changes, and check how Astryx lists the template. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/document-the-template/template-doc-overview#understand-the-two-files",
"oldCliRoute": "astryx docs cli/integrations/templates/document-the-template/template-doc-overview understand-the-two-files",
"oldDocsiteUrl": "/docs/cli-integrations-templates-document-the-template-template-doc-overview#understand-the-two-files",
"placement": "namespace:cli/integrations/templates/document-the-template/template-doc-overview",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/document-the-template/template-doc-overview.",
"rationale": "A section of cli/integrations/templates/document-the-template/template-doc-overview: Understand the two files.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/document-the-template/template-doc-overview#document-the-shared-fields",
"oldCliRoute": "astryx docs cli/integrations/templates/document-the-template/template-doc-overview document-the-shared-fields",
"oldDocsiteUrl": "/docs/cli-integrations-templates-document-the-template-template-doc-overview#document-the-shared-fields",
"placement": "namespace:cli/integrations/templates/document-the-template/template-doc-overview",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/document-the-template/template-doc-overview.",
"rationale": "A section of cli/integrations/templates/document-the-template/template-doc-overview: Document the shared fields.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/document-the-template/template-doc-overview#check-how-astryx-lists-it",
"oldCliRoute": "astryx docs cli/integrations/templates/document-the-template/template-doc-overview check-how-astryx-lists-it",
"oldDocsiteUrl": "/docs/cli-integrations-templates-document-the-template-template-doc-overview#check-how-astryx-lists-it",
"placement": "namespace:cli/integrations/templates/document-the-template/template-doc-overview",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/document-the-template/template-doc-overview.",
"rationale": "A section of cli/integrations/templates/document-the-template/template-doc-overview: Check how Astryx lists it.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/templates/document-the-template/page-template",
"oldCliRoute": "astryx docs cli/integrations/templates/document-the-template/page-template",
"oldDocsiteUrl": "/docs/cli-integrations-templates-document-the-template-page-template",
"placement": "namespace:cli/integrations/templates/document-the-template",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:document-the-template', slot: 'guides', order: 20}.",
"rationale": "Page template: Help people find a page: give it a category for `astryx search` and template listings, and flag a sparse starting shell as a scaffold. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/document-the-template/page-template#start-from-the-generated-page-doc",
"oldCliRoute": "astryx docs cli/integrations/templates/document-the-template/page-template start-from-the-generated-page-doc",
"oldDocsiteUrl": "/docs/cli-integrations-templates-document-the-template-page-template#start-from-the-generated-page-doc",
"placement": "namespace:cli/integrations/templates/document-the-template/page-template",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/document-the-template/page-template.",
"rationale": "A section of cli/integrations/templates/document-the-template/page-template: Start from the generated page doc.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/document-the-template/page-template#help-people-find-the-page",
"oldCliRoute": "astryx docs cli/integrations/templates/document-the-template/page-template help-people-find-the-page",
"oldDocsiteUrl": "/docs/cli-integrations-templates-document-the-template-page-template#help-people-find-the-page",
"placement": "namespace:cli/integrations/templates/document-the-template/page-template",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/document-the-template/page-template.",
"rationale": "A section of cli/integrations/templates/document-the-template/page-template: Help people find the page.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/templates/document-the-template/block-template",
"oldCliRoute": "astryx docs cli/integrations/templates/document-the-template/block-template",
"oldDocsiteUrl": "/docs/cli-integrations-templates-document-the-template-block-template",
"placement": "namespace:cli/integrations/templates/document-the-template",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:document-the-template', slot: 'guides', order: 30}.",
"rationale": "Block template: Describe a smaller composition, choose its preview shape, and connect it to component examples only when that relationship is real. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/document-the-template/block-template#start-with-a-standalone-block",
"oldCliRoute": "astryx docs cli/integrations/templates/document-the-template/block-template start-with-a-standalone-block",
"oldDocsiteUrl": "/docs/cli-integrations-templates-document-the-template-block-template#start-with-a-standalone-block",
"placement": "namespace:cli/integrations/templates/document-the-template/block-template",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/document-the-template/block-template.",
"rationale": "A section of cli/integrations/templates/document-the-template/block-template: Start with a standalone block.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/document-the-template/block-template#choose-the-component-relationship",
"oldCliRoute": "astryx docs cli/integrations/templates/document-the-template/block-template choose-the-component-relationship",
"oldDocsiteUrl": "/docs/cli-integrations-templates-document-the-template-block-template#choose-the-component-relationship",
"placement": "namespace:cli/integrations/templates/document-the-template/block-template",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/document-the-template/block-template.",
"rationale": "A section of cli/integrations/templates/document-the-template/block-template: Choose the component relationship.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/document-the-template/block-template#choose-a-useful-preview",
"oldCliRoute": "astryx docs cli/integrations/templates/document-the-template/block-template choose-a-useful-preview",
"oldDocsiteUrl": "/docs/cli-integrations-templates-document-the-template-block-template#choose-a-useful-preview",
"placement": "namespace:cli/integrations/templates/document-the-template/block-template",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/document-the-template/block-template.",
"rationale": "A section of cli/integrations/templates/document-the-template/block-template: Choose a useful preview.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/templates/document-the-template/replace-a-core-template",
"oldCliRoute": "astryx docs cli/integrations/templates/document-the-template/replace-a-core-template",
"oldDocsiteUrl": "/docs/cli-integrations-templates-document-the-template-replace-a-core-template",
"placement": "namespace:cli/integrations/templates/document-the-template",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:document-the-template', slot: 'guides', order: 40}.",
"rationale": "Replace a Core template: Use a template replacement only when an integration intentionally changes the default source returned for one Core template id. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/document-the-template/replace-a-core-template#replace-only-on-purpose",
"oldCliRoute": "astryx docs cli/integrations/templates/document-the-template/replace-a-core-template replace-only-on-purpose",
"oldDocsiteUrl": "/docs/cli-integrations-templates-document-the-template-replace-a-core-template#replace-only-on-purpose",
"placement": "namespace:cli/integrations/templates/document-the-template/replace-a-core-template",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/document-the-template/replace-a-core-template.",
"rationale": "A section of cli/integrations/templates/document-the-template/replace-a-core-template: Replace only on purpose.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/document-the-template/replace-a-core-template#declare-the-replacement",
"oldCliRoute": "astryx docs cli/integrations/templates/document-the-template/replace-a-core-template declare-the-replacement",
"oldDocsiteUrl": "/docs/cli-integrations-templates-document-the-template-replace-a-core-template#declare-the-replacement",
"placement": "namespace:cli/integrations/templates/document-the-template/replace-a-core-template",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/document-the-template/replace-a-core-template.",
"rationale": "A section of cli/integrations/templates/document-the-template/replace-a-core-template: Declare the replacement.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/document-the-template/replace-a-core-template#require-a-compatible-cli",
"oldCliRoute": "astryx docs cli/integrations/templates/document-the-template/replace-a-core-template require-a-compatible-cli",
"oldDocsiteUrl": "/docs/cli-integrations-templates-document-the-template-replace-a-core-template#require-a-compatible-cli",
"placement": "namespace:cli/integrations/templates/document-the-template/replace-a-core-template",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/document-the-template/replace-a-core-template.",
"rationale": "A section of cli/integrations/templates/document-the-template/replace-a-core-template: Require a compatible CLI.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/document-the-template/replace-a-core-template#what-apps-receive",
"oldCliRoute": "astryx docs cli/integrations/templates/document-the-template/replace-a-core-template what-apps-receive",
"oldDocsiteUrl": "/docs/cli-integrations-templates-document-the-template-replace-a-core-template#what-apps-receive",
"placement": "namespace:cli/integrations/templates/document-the-template/replace-a-core-template",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/document-the-template/replace-a-core-template.",
"rationale": "A section of cli/integrations/templates/document-the-template/replace-a-core-template: What apps receive.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/document-the-template/replace-a-core-template#check-the-replacement",
"oldCliRoute": "astryx docs cli/integrations/templates/document-the-template/replace-a-core-template check-the-replacement",
"oldDocsiteUrl": "/docs/cli-integrations-templates-document-the-template-replace-a-core-template#check-the-replacement",
"placement": "namespace:cli/integrations/templates/document-the-template/replace-a-core-template",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/document-the-template/replace-a-core-template.",
"rationale": "A section of cli/integrations/templates/document-the-template/replace-a-core-template: Check the replacement.",
"status": "proposed"
},
{
"kind": "namespace",
"id": "cli/integrations/templates/build-the-template",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template",
"oldDocsiteUrl": null,
"placement": "namespace:cli/integrations/templates/build-the-template",
"aliasNeeded": false,
"evidence": "assets/docs/tree/build-the-template.doc.mjs declares this namespace and places it with placement {parent: 'namespace:templates', slot: 'build', order: 30}.",
"rationale": "Build the template: Make sure your template works when an app copies it: write the template file, set up its styles, fonts, icons, and images, then package and test it. This namespace is new in this change, so it has no older route or docsite page.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/templates/build-the-template/write-the-template-file",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/write-the-template-file",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-write-the-template-file",
"placement": "namespace:cli/integrations/templates/build-the-template",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:build-the-template', slot: 'guides', order: 10}.",
"rationale": "Write the template file: Astryx copies just this one file into an app, so write it to work on its own there: where it lands, what it can import, and what it exports. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/write-the-template-file#know-what-gets-copied",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/write-the-template-file know-what-gets-copied",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-write-the-template-file#know-what-gets-copied",
"placement": "namespace:cli/integrations/templates/build-the-template/write-the-template-file",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/write-the-template-file.",
"rationale": "A section of cli/integrations/templates/build-the-template/write-the-template-file: Know what gets copied.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/write-the-template-file#keep-edited-code-in-one-file",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/write-the-template-file keep-edited-code-in-one-file",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-write-the-template-file#keep-edited-code-in-one-file",
"placement": "namespace:cli/integrations/templates/build-the-template/write-the-template-file",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/write-the-template-file.",
"rationale": "A section of cli/integrations/templates/build-the-template/write-the-template-file: Keep edited code in one file.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/write-the-template-file#use-imports-that-work",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/write-the-template-file use-imports-that-work",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-write-the-template-file#use-imports-that-work-in-the-app",
"placement": "namespace:cli/integrations/templates/build-the-template/write-the-template-file",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/write-the-template-file.",
"rationale": "A section of cli/integrations/templates/build-the-template/write-the-template-file: Use imports that work in the app.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/write-the-template-file#export-one-component",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/write-the-template-file export-one-component",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-write-the-template-file#export-one-component",
"placement": "namespace:cli/integrations/templates/build-the-template/write-the-template-file",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/write-the-template-file.",
"rationale": "A section of cli/integrations/templates/build-the-template/write-the-template-file: Export one component.",
"status": "proposed"
},
{
"kind": "namespace",
"id": "cli/integrations/templates/build-the-template/template-assets",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/template-assets",
"oldDocsiteUrl": null,
"placement": "namespace:cli/integrations/templates/build-the-template/template-assets",
"aliasNeeded": false,
"evidence": "assets/docs/tree/template-assets.doc.mjs declares this namespace and places it with placement {parent: 'namespace:build-the-template', slot: 'guides', order: 20}.",
"rationale": "Assets: Make sure the template's styles, fonts, icons, images, and video still show up after an app copies it. This namespace is new in this change, so it has no older route or docsite page.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/templates/build-the-template/template-assets/template-assets-overview",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/template-assets/template-assets-overview",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-template-assets-template-assets-overview",
"placement": "namespace:cli/integrations/templates/build-the-template/template-assets",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:template-assets', slot: 'guides', order: 10}.",
"rationale": "Asset overview: Decide whether each style, font, icon, image, or video travels in the copied file, stays in your package, or comes from the app. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/template-assets/template-assets-overview#choose-the-owner",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/template-assets/template-assets-overview choose-the-owner",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-template-assets-template-assets-overview#choose-the-owner",
"placement": "namespace:cli/integrations/templates/build-the-template/template-assets/template-assets-overview",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/template-assets/template-assets-overview.",
"rationale": "A section of cli/integrations/templates/build-the-template/template-assets/template-assets-overview: Choose the owner.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/templates/build-the-template/template-assets/template-styles",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/template-assets/template-styles",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-template-assets-template-styles",
"placement": "namespace:cli/integrations/templates/build-the-template/template-assets",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:template-assets', slot: 'guides', order: 20}.",
"rationale": "Styles: Keep the copied UI on the app's theme: use Astryx props and tokens first, keep editable styles in the file, and ship shared CSS from your package. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/template-assets/template-styles#start-with-astryx",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/template-assets/template-styles start-with-astryx",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-template-assets-template-styles#start-with-astryx",
"placement": "namespace:cli/integrations/templates/build-the-template/template-assets/template-styles",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/template-assets/template-styles.",
"rationale": "A section of cli/integrations/templates/build-the-template/template-assets/template-styles: Start with Astryx.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/template-assets/template-styles#keep-editable-styles-with-the-source",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/template-assets/template-styles keep-editable-styles-with-the-source",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-template-assets-template-styles#keep-editable-styles-with-the-source",
"placement": "namespace:cli/integrations/templates/build-the-template/template-assets/template-styles",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/template-assets/template-styles.",
"rationale": "A section of cli/integrations/templates/build-the-template/template-assets/template-styles: Keep editable styles with the source.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/template-assets/template-styles#publish-shared-css",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/template-assets/template-styles publish-shared-css",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-template-assets-template-styles#publish-shared-css-deliberately",
"placement": "namespace:cli/integrations/templates/build-the-template/template-assets/template-styles",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/template-assets/template-styles.",
"rationale": "A section of cli/integrations/templates/build-the-template/template-assets/template-styles: Publish shared CSS deliberately.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/templates/build-the-template/template-assets/template-fonts",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/template-assets/template-fonts",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-template-assets-template-fonts",
"placement": "namespace:cli/integrations/templates/build-the-template/template-assets",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:template-assets', slot: 'guides', order: 30}.",
"rationale": "Fonts: Keep text in the app's typeface unless the template truly needs its own, and ship every font file it uses when it does. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/template-assets/template-fonts#prefer-host-typography",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/template-assets/template-fonts prefer-host-typography",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-template-assets-template-fonts#prefer-host-typography",
"placement": "namespace:cli/integrations/templates/build-the-template/template-assets/template-fonts",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/template-assets/template-fonts.",
"rationale": "A section of cli/integrations/templates/build-the-template/template-assets/template-fonts: Prefer host typography.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/template-assets/template-fonts#package-a-required-font",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/template-assets/template-fonts package-a-required-font",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-template-assets-template-fonts#package-a-required-font",
"placement": "namespace:cli/integrations/templates/build-the-template/template-assets/template-fonts",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/template-assets/template-fonts.",
"rationale": "A section of cli/integrations/templates/build-the-template/template-assets/template-fonts: Package a required font.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/template-assets/template-fonts#check-fonts-in-the-app",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/template-assets/template-fonts check-fonts-in-the-app",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-template-assets-template-fonts#check-fonts-in-the-app",
"placement": "namespace:cli/integrations/templates/build-the-template/template-assets/template-fonts",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/template-assets/template-fonts.",
"rationale": "A section of cli/integrations/templates/build-the-template/template-assets/template-fonts: Check fonts in the app.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/templates/build-the-template/template-assets/template-icons",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/template-assets/template-icons",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-template-assets-template-icons",
"placement": "namespace:cli/integrations/templates/build-the-template/template-assets",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:template-assets', slot: 'guides', order: 40}.",
"rationale": "Icons: Keep icons consistent and accessible by rendering them through Astryx, and ship custom product icons from your package. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/template-assets/template-icons#use-astryx-icon",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/template-assets/template-icons use-astryx-icon",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-template-assets-template-icons#use-astryx-icon",
"placement": "namespace:cli/integrations/templates/build-the-template/template-assets/template-icons",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/template-assets/template-icons.",
"rationale": "A section of cli/integrations/templates/build-the-template/template-assets/template-icons: Use Astryx Icon.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/template-assets/template-icons#ship-a-custom-icon",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/template-assets/template-icons ship-a-custom-icon",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-template-assets-template-icons#ship-a-custom-icon-deliberately",
"placement": "namespace:cli/integrations/templates/build-the-template/template-assets/template-icons",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/template-assets/template-icons.",
"rationale": "A section of cli/integrations/templates/build-the-template/template-assets/template-icons: Ship a custom icon deliberately.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/template-assets/template-icons#check-icons-in-the-app",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/template-assets/template-icons check-icons-in-the-app",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-template-assets-template-icons#check-icons-in-the-app",
"placement": "namespace:cli/integrations/templates/build-the-template/template-assets/template-icons",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/template-assets/template-icons.",
"rationale": "A section of cli/integrations/templates/build-the-template/template-assets/template-icons: Check icons in the app.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/templates/build-the-template/template-assets/template-images-media",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/template-assets/template-images-media",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-template-assets-template-images-media",
"placement": "namespace:cli/integrations/templates/build-the-template/template-assets",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:template-assets', slot: 'guides', order: 50}.",
"rationale": "Images and media: Make sure every image and video still works after the copy, or becomes a clear placeholder the app replaces. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/template-assets/template-images-media#do-not-copy-relative-media",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/template-assets/template-images-media do-not-copy-relative-media",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-template-assets-template-images-media#do-not-rely-on-sibling-media",
"placement": "namespace:cli/integrations/templates/build-the-template/template-assets/template-images-media",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/template-assets/template-images-media.",
"rationale": "A section of cli/integrations/templates/build-the-template/template-assets/template-images-media: Do not rely on sibling media.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/template-assets/template-images-media#understand-template-assets",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/template-assets/template-images-media understand-template-assets",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-template-assets-template-images-media#understand-template-assets",
"placement": "namespace:cli/integrations/templates/build-the-template/template-assets/template-images-media",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/template-assets/template-images-media.",
"rationale": "A section of cli/integrations/templates/build-the-template/template-assets/template-images-media: Understand `/template-assets`.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/template-assets/template-images-media#design-a-useful-placeholder",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/template-assets/template-images-media design-a-useful-placeholder",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-template-assets-template-images-media#design-a-useful-placeholder",
"placement": "namespace:cli/integrations/templates/build-the-template/template-assets/template-images-media",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/template-assets/template-images-media.",
"rationale": "A section of cli/integrations/templates/build-the-template/template-assets/template-images-media: Design a useful placeholder.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/template-assets/template-images-media#check-media-in-the-app",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/template-assets/template-images-media check-media-in-the-app",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-template-assets-template-images-media#check-media-in-the-app",
"placement": "namespace:cli/integrations/templates/build-the-template/template-assets/template-images-media",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/template-assets/template-images-media.",
"rationale": "A section of cli/integrations/templates/build-the-template/template-assets/template-images-media: Check media in the app.",
"status": "proposed"
},
{
"kind": "namespace",
"id": "cli/integrations/templates/build-the-template/package-and-test",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/package-and-test",
"oldDocsiteUrl": null,
"placement": "namespace:cli/integrations/templates/build-the-template/package-and-test",
"aliasNeeded": false,
"evidence": "assets/docs/tree/package-and-test.doc.mjs declares this namespace and places it with placement {parent: 'namespace:build-the-template', slot: 'guides', order: 30}.",
"rationale": "Package and test: Publish a package that works the first time: include everything the template needs, check the package before you publish, and try the template in a real app. This namespace is new in this change, so it has no older route or docsite page.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/templates/build-the-template/package-and-test/export-template-assets",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/package-and-test/export-template-assets",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-package-and-test-export-template-assets",
"placement": "namespace:cli/integrations/templates/build-the-template/package-and-test",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:package-and-test', slot: 'guides', order: 10}.",
"rationale": "Export the template and assets: Make sure the published package contains and exposes everything the copied template imports. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/package-and-test/export-template-assets#keep-the-generated-template-export",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/package-and-test/export-template-assets keep-the-generated-template-export",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-package-and-test-export-template-assets#keep-the-generated-template-export",
"placement": "namespace:cli/integrations/templates/build-the-template/package-and-test/export-template-assets",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/package-and-test/export-template-assets.",
"rationale": "A section of cli/integrations/templates/build-the-template/package-and-test/export-template-assets: Keep the generated template export.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/package-and-test/export-template-assets#export-package-owned-support-files",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/package-and-test/export-template-assets export-package-owned-support-files",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-package-and-test-export-template-assets#export-package-owned-support-files",
"placement": "namespace:cli/integrations/templates/build-the-template/package-and-test/export-template-assets",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/package-and-test/export-template-assets.",
"rationale": "A section of cli/integrations/templates/build-the-template/package-and-test/export-template-assets: Export package-owned support files.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/package-and-test/export-template-assets#include-every-file",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/package-and-test/export-template-assets include-every-file",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-package-and-test-export-template-assets#include-every-file",
"placement": "namespace:cli/integrations/templates/build-the-template/package-and-test/export-template-assets",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/package-and-test/export-template-assets.",
"rationale": "A section of cli/integrations/templates/build-the-template/package-and-test/export-template-assets: Include every file.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/package-and-test/export-template-assets#declare-what-the-copied-file-imports",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/package-and-test/export-template-assets declare-what-the-copied-file-imports",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-package-and-test-export-template-assets#declare-what-the-copied-file-imports",
"placement": "namespace:cli/integrations/templates/build-the-template/package-and-test/export-template-assets",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/package-and-test/export-template-assets.",
"rationale": "A section of cli/integrations/templates/build-the-template/package-and-test/export-template-assets: Declare what the copied file imports.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/templates/build-the-template/package-and-test/verify-packed-template",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/package-and-test/verify-packed-template",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-package-and-test-verify-packed-template",
"placement": "namespace:cli/integrations/templates/build-the-template/package-and-test",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:package-and-test', slot: 'guides', order: 20}.",
"rationale": "Verify the packed package: Catch missing files, exports, and CLI requirements before you publish, and know what still needs the app test. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/package-and-test/verify-packed-template#run-the-package-check",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/package-and-test/verify-packed-template run-the-package-check",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-package-and-test-verify-packed-template#run-the-package-check",
"placement": "namespace:cli/integrations/templates/build-the-template/package-and-test/verify-packed-template",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/package-and-test/verify-packed-template.",
"rationale": "A section of cli/integrations/templates/build-the-template/package-and-test/verify-packed-template: Run the package check.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/package-and-test/verify-packed-template#know-what-it-does-not-prove",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/package-and-test/verify-packed-template know-what-it-does-not-prove",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-package-and-test-verify-packed-template#know-what-it-does-not-prove",
"placement": "namespace:cli/integrations/templates/build-the-template/package-and-test/verify-packed-template",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/package-and-test/verify-packed-template.",
"rationale": "A section of cli/integrations/templates/build-the-template/package-and-test/verify-packed-template: Know what it does not prove.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/templates/build-the-template/package-and-test/test-template-in-app",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/package-and-test/test-template-in-app",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-package-and-test-test-template-in-app",
"placement": "namespace:cli/integrations/templates/build-the-template/package-and-test",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:package-and-test', slot: 'guides', order: 30}.",
"rationale": "Test in an app: Prove the template works the way apps use it: installed from the packed package, copied, built, and rendered. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/package-and-test/test-template-in-app#install-the-packed-package",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/package-and-test/test-template-in-app install-the-packed-package",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-package-and-test-test-template-in-app#install-the-packed-package",
"placement": "namespace:cli/integrations/templates/build-the-template/package-and-test/test-template-in-app",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/package-and-test/test-template-in-app.",
"rationale": "A section of cli/integrations/templates/build-the-template/package-and-test/test-template-in-app: Install the packed package.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/package-and-test/test-template-in-app#copy-the-template",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/package-and-test/test-template-in-app copy-the-template",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-package-and-test-test-template-in-app#copy-the-template",
"placement": "namespace:cli/integrations/templates/build-the-template/package-and-test/test-template-in-app",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/package-and-test/test-template-in-app.",
"rationale": "A section of cli/integrations/templates/build-the-template/package-and-test/test-template-in-app: Copy the template.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/package-and-test/test-template-in-app#build-every-supported-app",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/package-and-test/test-template-in-app build-every-supported-app",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-package-and-test-test-template-in-app#build-every-supported-app",
"placement": "namespace:cli/integrations/templates/build-the-template/package-and-test/test-template-in-app",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/package-and-test/test-template-in-app.",
"rationale": "A section of cli/integrations/templates/build-the-template/package-and-test/test-template-in-app: Build every supported app.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/package-and-test/test-template-in-app#render-the-behavior-matrix",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/package-and-test/test-template-in-app render-the-behavior-matrix",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-package-and-test-test-template-in-app#render-the-behavior-matrix",
"placement": "namespace:cli/integrations/templates/build-the-template/package-and-test/test-template-in-app",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/package-and-test/test-template-in-app.",
"rationale": "A section of cli/integrations/templates/build-the-template/package-and-test/test-template-in-app: Render the behavior matrix.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/build-the-template/package-and-test/test-template-in-app#grade-the-result",
"oldCliRoute": "astryx docs cli/integrations/templates/build-the-template/package-and-test/test-template-in-app grade-the-result",
"oldDocsiteUrl": "/docs/cli-integrations-templates-build-the-template-package-and-test-test-template-in-app#grade-the-result",
"placement": "namespace:cli/integrations/templates/build-the-template/package-and-test/test-template-in-app",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/build-the-template/package-and-test/test-template-in-app.",
"rationale": "A section of cli/integrations/templates/build-the-template/package-and-test/test-template-in-app: Grade the result.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/templates/template-quality",
"oldCliRoute": "astryx docs cli/integrations/templates/template-quality",
"oldDocsiteUrl": "/docs/cli-integrations-templates-template-quality",
"placement": "namespace:cli/integrations/templates",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:templates', slot: 'quality', order: 10}.",
"rationale": "Quality overview: Learn what makes a template useful, reliable, and ready to publish, and review those qualities throughout authoring. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/template-quality#what-good-means",
"oldCliRoute": "astryx docs cli/integrations/templates/template-quality what-good-means",
"oldDocsiteUrl": "/docs/cli-integrations-templates-template-quality#what-good-means",
"placement": "namespace:cli/integrations/templates/template-quality",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/template-quality.",
"rationale": "A section of cli/integrations/templates/template-quality: What good means.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/template-quality#understand-the-score",
"oldCliRoute": "astryx docs cli/integrations/templates/template-quality understand-the-score",
"oldDocsiteUrl": "/docs/cli-integrations-templates-template-quality#understand-the-score",
"placement": "namespace:cli/integrations/templates/template-quality",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/template-quality.",
"rationale": "A section of cli/integrations/templates/template-quality: Understand the score.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/template-quality#review-while-you-build",
"oldCliRoute": "astryx docs cli/integrations/templates/template-quality review-while-you-build",
"oldDocsiteUrl": "/docs/cli-integrations-templates-template-quality#review-while-you-build",
"placement": "namespace:cli/integrations/templates/template-quality",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/template-quality.",
"rationale": "A section of cli/integrations/templates/template-quality: Review while you build.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/templates/template-grading-rubric",
"oldCliRoute": "astryx docs cli/integrations/templates/template-grading-rubric",
"oldDocsiteUrl": "/docs/cli-integrations-templates-template-grading-rubric",
"placement": "namespace:cli/integrations/templates",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:templates', slot: 'quality', order: 20}.",
"rationale": "Full grading rubric: Use a shared set of heuristics to score template quality consistently across Astryx usage, icons, CSS, layout, metadata, images, and code quality. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/template-grading-rubric#component-purity",
"oldCliRoute": "astryx docs cli/integrations/templates/template-grading-rubric component-purity",
"oldDocsiteUrl": "/docs/cli-integrations-templates-template-grading-rubric#astryx-component-purity-30-points",
"placement": "namespace:cli/integrations/templates/template-grading-rubric",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/template-grading-rubric.",
"rationale": "A section of cli/integrations/templates/template-grading-rubric: Astryx component purity: 30 points.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/template-grading-rubric#icon-purity",
"oldCliRoute": "astryx docs cli/integrations/templates/template-grading-rubric icon-purity",
"oldDocsiteUrl": "/docs/cli-integrations-templates-template-grading-rubric#icon-purity-15-points",
"placement": "namespace:cli/integrations/templates/template-grading-rubric",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/template-grading-rubric.",
"rationale": "A section of cli/integrations/templates/template-grading-rubric: Icon purity: 15 points.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/template-grading-rubric#custom-css",
"oldCliRoute": "astryx docs cli/integrations/templates/template-grading-rubric custom-css",
"oldDocsiteUrl": "/docs/cli-integrations-templates-template-grading-rubric#custom-css-15-points",
"placement": "namespace:cli/integrations/templates/template-grading-rubric",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/template-grading-rubric.",
"rationale": "A section of cli/integrations/templates/template-grading-rubric: Custom CSS: 15 points.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/template-grading-rubric#layout-and-structure",
"oldCliRoute": "astryx docs cli/integrations/templates/template-grading-rubric layout-and-structure",
"oldDocsiteUrl": "/docs/cli-integrations-templates-template-grading-rubric#layout-and-structure-15-points",
"placement": "namespace:cli/integrations/templates/template-grading-rubric",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/template-grading-rubric.",
"rationale": "A section of cli/integrations/templates/template-grading-rubric: Layout and structure: 15 points.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/template-grading-rubric#doc-metadata",
"oldCliRoute": "astryx docs cli/integrations/templates/template-grading-rubric doc-metadata",
"oldDocsiteUrl": "/docs/cli-integrations-templates-template-grading-rubric#doc-metadata-10-points",
"placement": "namespace:cli/integrations/templates/template-grading-rubric",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/template-grading-rubric.",
"rationale": "A section of cli/integrations/templates/template-grading-rubric: Doc metadata: 10 points.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/template-grading-rubric#image-handling",
"oldCliRoute": "astryx docs cli/integrations/templates/template-grading-rubric image-handling",
"oldDocsiteUrl": "/docs/cli-integrations-templates-template-grading-rubric#image-handling-5-points",
"placement": "namespace:cli/integrations/templates/template-grading-rubric",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/template-grading-rubric.",
"rationale": "A section of cli/integrations/templates/template-grading-rubric: Image handling: 5 points.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/template-grading-rubric#code-quality",
"oldCliRoute": "astryx docs cli/integrations/templates/template-grading-rubric code-quality",
"oldDocsiteUrl": "/docs/cli-integrations-templates-template-grading-rubric#code-quality-10-points",
"placement": "namespace:cli/integrations/templates/template-grading-rubric",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/template-grading-rubric.",
"rationale": "A section of cli/integrations/templates/template-grading-rubric: Code quality: 10 points.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/templates/grade-template-with-agent",
"oldCliRoute": "astryx docs cli/integrations/templates/grade-template-with-agent",
"oldDocsiteUrl": "/docs/cli-integrations-templates-grade-template-with-agent",
"placement": "namespace:cli/integrations/templates",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:templates', slot: 'quality', order: 30}.",
"rationale": "Grade and improve with an agent: Give an agent the rubric and evidence it needs to find problems, produce a reproducible scorecard, and improve the template. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/grade-template-with-agent#give-the-agent-the-rubric",
"oldCliRoute": "astryx docs cli/integrations/templates/grade-template-with-agent give-the-agent-the-rubric",
"oldDocsiteUrl": "/docs/cli-integrations-templates-grade-template-with-agent#give-the-agent-the-rubric",
"placement": "namespace:cli/integrations/templates/grade-template-with-agent",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/grade-template-with-agent.",
"rationale": "A section of cli/integrations/templates/grade-template-with-agent: Give the agent the rubric.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/grade-template-with-agent#require-a-scorecard",
"oldCliRoute": "astryx docs cli/integrations/templates/grade-template-with-agent require-a-scorecard",
"oldDocsiteUrl": "/docs/cli-integrations-templates-grade-template-with-agent#require-a-scorecard",
"placement": "namespace:cli/integrations/templates/grade-template-with-agent",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/grade-template-with-agent.",
"rationale": "A section of cli/integrations/templates/grade-template-with-agent: Require a scorecard.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/templates/grade-template-with-agent#improve-and-regrade",
"oldCliRoute": "astryx docs cli/integrations/templates/grade-template-with-agent improve-and-regrade",
"oldDocsiteUrl": "/docs/cli-integrations-templates-grade-template-with-agent#improve-and-regrade",
"placement": "namespace:cli/integrations/templates/grade-template-with-agent",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/templates/grade-template-with-agent.",
"rationale": "A section of cli/integrations/templates/grade-template-with-agent: Improve and regrade.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/themes",
"oldCliRoute": "astryx docs cli/integrations/themes",
"oldDocsiteUrl": "/docs/cli-integrations-themes",
"placement": "namespace:cli/integrations",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:integrations', slot: 'contribute', order: 30}.",
"rationale": "Themes: Ship an editable source theme with a generated palette that apps copy into their code and build. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/themes#add-a-theme",
"oldCliRoute": "astryx docs cli/integrations/themes add-a-theme",
"oldDocsiteUrl": "/docs/cli-integrations-themes#add-a-theme",
"placement": "namespace:cli/integrations/themes",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/themes.",
"rationale": "A section of cli/integrations/themes: Add a theme.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/themes#generate-a-palette",
"oldCliRoute": "astryx docs cli/integrations/themes generate-a-palette",
"oldDocsiteUrl": "/docs/cli-integrations-themes#generate-a-palette",
"placement": "namespace:cli/integrations/themes",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/themes.",
"rationale": "A section of cli/integrations/themes: Generate a palette.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/themes#use-the-palette",
"oldCliRoute": "astryx docs cli/integrations/themes use-the-palette",
"oldDocsiteUrl": "/docs/cli-integrations-themes#use-the-palette-in-the-theme",
"placement": "namespace:cli/integrations/themes",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/themes.",
"rationale": "A section of cli/integrations/themes: Use the palette in the theme.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/themes#use-a-theme-in-an-app",
"oldCliRoute": "astryx docs cli/integrations/themes use-a-theme-in-an-app",
"oldDocsiteUrl": "/docs/cli-integrations-themes#use-the-theme-in-an-app",
"placement": "namespace:cli/integrations/themes",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/themes.",
"rationale": "A section of cli/integrations/themes: Use the theme in an app.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/themes#themes-on-older-clis",
"oldCliRoute": "astryx docs cli/integrations/themes themes-on-older-clis",
"oldDocsiteUrl": "/docs/cli-integrations-themes#fix-missing-themes-on-older-clis",
"placement": "namespace:cli/integrations/themes",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/themes.",
"rationale": "A section of cli/integrations/themes: Fix missing themes on older CLIs.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/codemods",
"oldCliRoute": "astryx docs cli/integrations/codemods",
"oldDocsiteUrl": "/docs/cli-integrations-codemods",
"placement": "namespace:cli/integrations",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:integrations', slot: 'contribute', order: 50}.",
"rationale": "Codemods: Ship codemods that `astryx upgrade` runs to migrate app code, and know which of them an app runs. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/codemods#add-a-codemod",
"oldCliRoute": "astryx docs cli/integrations/codemods add-a-codemod",
"oldDocsiteUrl": "/docs/cli-integrations-codemods#add-a-codemod",
"placement": "namespace:cli/integrations/codemods",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/codemods.",
"rationale": "A section of cli/integrations/codemods: Add a codemod.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/codemods#write-the-transform",
"oldCliRoute": "astryx docs cli/integrations/codemods write-the-transform",
"oldDocsiteUrl": "/docs/cli-integrations-codemods#write-the-transform",
"placement": "namespace:cli/integrations/codemods",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/codemods.",
"rationale": "A section of cli/integrations/codemods: Write the transform.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/codemods#which-codemods-run",
"oldCliRoute": "astryx docs cli/integrations/codemods which-codemods-run",
"oldDocsiteUrl": "/docs/cli-integrations-codemods#choose-when-a-codemod-runs",
"placement": "namespace:cli/integrations/codemods",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/codemods.",
"rationale": "A section of cli/integrations/codemods: Choose when a codemod runs.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/codemods#run-codemods-in-an-app",
"oldCliRoute": "astryx docs cli/integrations/codemods run-codemods-in-an-app",
"oldDocsiteUrl": "/docs/cli-integrations-codemods#run-codemods-in-an-app",
"placement": "namespace:cli/integrations/codemods",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/codemods.",
"rationale": "A section of cli/integrations/codemods: Run codemods in an app.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/agent-guidance",
"oldCliRoute": "astryx docs cli/integrations/agent-guidance",
"oldDocsiteUrl": "/docs/cli-integrations-agent-guidance",
"placement": "namespace:cli/integrations",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:integrations', slot: 'contribute', order: 60}.",
"rationale": "Agent guidance: Add a few lines of guidance that apps put in front of the AI agents working in their code. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/agent-guidance#add-a-guidance-line",
"oldCliRoute": "astryx docs cli/integrations/agent-guidance add-a-guidance-line",
"oldDocsiteUrl": "/docs/cli-integrations-agent-guidance#add-a-line-of-guidance",
"placement": "namespace:cli/integrations/agent-guidance",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/agent-guidance.",
"rationale": "A section of cli/integrations/agent-guidance: Add a line of guidance.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/agent-guidance#keep-within-the-limits",
"oldCliRoute": "astryx docs cli/integrations/agent-guidance keep-within-the-limits",
"oldDocsiteUrl": "/docs/cli-integrations-agent-guidance#keep-within-the-limits",
"placement": "namespace:cli/integrations/agent-guidance",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/agent-guidance.",
"rationale": "A section of cli/integrations/agent-guidance: Keep within the limits.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/agent-guidance#see-what-agents-read",
"oldCliRoute": "astryx docs cli/integrations/agent-guidance see-what-agents-read",
"oldDocsiteUrl": "/docs/cli-integrations-agent-guidance#see-what-agents-read",
"placement": "namespace:cli/integrations/agent-guidance",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/agent-guidance.",
"rationale": "A section of cli/integrations/agent-guidance: See what agents read.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/agent-guidance#refresh-the-block",
"oldCliRoute": "astryx docs cli/integrations/agent-guidance refresh-the-block",
"oldDocsiteUrl": "/docs/cli-integrations-agent-guidance#refresh-the-block-in-an-app",
"placement": "namespace:cli/integrations/agent-guidance",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/agent-guidance.",
"rationale": "A section of cli/integrations/agent-guidance: Refresh the block in an app.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/debug-and-gap-reports",
"oldCliRoute": "astryx docs cli/integrations/debug-and-gap-reports",
"oldDocsiteUrl": "/docs/cli-integrations-debug-and-gap-reports",
"placement": "namespace:cli/integrations",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:integrations', slot: 'contribute', order: 70}.",
"rationale": "Debug and gap reports: Receive a record of each CLI run in apps that use your package, and handle the gap reports they send about it. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/debug-and-gap-reports#record-runs-with-debug",
"oldCliRoute": "astryx docs cli/integrations/debug-and-gap-reports record-runs-with-debug",
"oldDocsiteUrl": "/docs/cli-integrations-debug-and-gap-reports#record-runs-with-debug",
"placement": "namespace:cli/integrations/debug-and-gap-reports",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/debug-and-gap-reports.",
"rationale": "A section of cli/integrations/debug-and-gap-reports: Record runs with debug.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/debug-and-gap-reports#turn-off-debug-in-an-app",
"oldCliRoute": "astryx docs cli/integrations/debug-and-gap-reports turn-off-debug-in-an-app",
"oldDocsiteUrl": "/docs/cli-integrations-debug-and-gap-reports#turn-off-debug-in-an-app",
"placement": "namespace:cli/integrations/debug-and-gap-reports",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/debug-and-gap-reports.",
"rationale": "A section of cli/integrations/debug-and-gap-reports: Turn off debug in an app.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/debug-and-gap-reports#handle-gap-reports",
"oldCliRoute": "astryx docs cli/integrations/debug-and-gap-reports handle-gap-reports",
"oldDocsiteUrl": "/docs/cli-integrations-debug-and-gap-reports#handle-gap-reports",
"placement": "namespace:cli/integrations/debug-and-gap-reports",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/debug-and-gap-reports.",
"rationale": "A section of cli/integrations/debug-and-gap-reports: Handle gap reports.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/debug-and-gap-reports#ask-before-filing-in-public",
"oldCliRoute": "astryx docs cli/integrations/debug-and-gap-reports ask-before-filing-in-public",
"oldDocsiteUrl": "/docs/cli-integrations-debug-and-gap-reports#ask-before-filing-in-public",
"placement": "namespace:cli/integrations/debug-and-gap-reports",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/debug-and-gap-reports.",
"rationale": "A section of cli/integrations/debug-and-gap-reports: Ask before filing in public.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/debug-and-gap-reports#fall-back-to-issues-url",
"oldCliRoute": "astryx docs cli/integrations/debug-and-gap-reports fall-back-to-issues-url",
"oldDocsiteUrl": "/docs/cli-integrations-debug-and-gap-reports#fall-back-to-issuesurl",
"placement": "namespace:cli/integrations/debug-and-gap-reports",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/debug-and-gap-reports.",
"rationale": "A section of cli/integrations/debug-and-gap-reports: Fall back to issuesUrl.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/test-in-an-app",
"oldCliRoute": "astryx docs cli/integrations/test-in-an-app",
"oldDocsiteUrl": "/docs/cli-integrations-test-in-an-app",
"placement": "namespace:cli/integrations",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:integrations', slot: 'ship', order: 10}.",
"rationale": "Test an integration in an app: Install your packed package in an app and run the commands its users will run. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/test-in-an-app#install-the-tarball",
"oldCliRoute": "astryx docs cli/integrations/test-in-an-app install-the-tarball",
"oldDocsiteUrl": "/docs/cli-integrations-test-in-an-app#install-the-tarball-in-an-app",
"placement": "namespace:cli/integrations/test-in-an-app",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/test-in-an-app.",
"rationale": "A section of cli/integrations/test-in-an-app: Install the tarball in an app.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/test-in-an-app#check-what-the-app-sees",
"oldCliRoute": "astryx docs cli/integrations/test-in-an-app check-what-the-app-sees",
"oldDocsiteUrl": "/docs/cli-integrations-test-in-an-app#check-what-the-app-sees",
"placement": "namespace:cli/integrations/test-in-an-app",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/test-in-an-app.",
"rationale": "A section of cli/integrations/test-in-an-app: Check what the app sees.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/test-in-an-app#run-doctor-in-the-app",
"oldCliRoute": "astryx docs cli/integrations/test-in-an-app run-doctor-in-the-app",
"oldDocsiteUrl": "/docs/cli-integrations-test-in-an-app#run-doctor-in-the-app",
"placement": "namespace:cli/integrations/test-in-an-app",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/test-in-an-app.",
"rationale": "A section of cli/integrations/test-in-an-app: Run doctor in the app.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/checks",
"oldCliRoute": "astryx docs cli/integrations/checks",
"oldDocsiteUrl": "/docs/cli-integrations-checks",
"placement": "namespace:cli/integrations",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:integrations', slot: 'ship', order: 20}.",
"rationale": "Check an integration: Pick the check for each problem, learn what fails and what only warns, and run every check in CI. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/checks#pick-a-check",
"oldCliRoute": "astryx docs cli/integrations/checks pick-a-check",
"oldDocsiteUrl": "/docs/cli-integrations-checks#pick-a-check",
"placement": "namespace:cli/integrations/checks",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/checks.",
"rationale": "A section of cli/integrations/checks: Pick a check.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/checks#run-every-check-in-ci",
"oldCliRoute": "astryx docs cli/integrations/checks run-every-check-in-ci",
"oldDocsiteUrl": "/docs/cli-integrations-checks#run-every-check-in-ci",
"placement": "namespace:cli/integrations/checks",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/checks.",
"rationale": "A section of cli/integrations/checks: Run every check in CI.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/checks#what-integration-verify-does",
"oldCliRoute": "astryx docs cli/integrations/checks what-integration-verify-does",
"oldDocsiteUrl": "/docs/cli-integrations-checks#verify-the-packed-package",
"placement": "namespace:cli/integrations/checks",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/checks.",
"rationale": "A section of cli/integrations/checks: Verify the packed package.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/versioning",
"oldCliRoute": "astryx docs cli/integrations/versioning",
"oldDocsiteUrl": "/docs/cli-integrations-versioning",
"placement": "namespace:cli/integrations",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:integrations', slot: 'ship', order: 30}.",
"rationale": "Versioning: Version your package, declare its peers, and keep apps on older CLIs working. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/versioning#pick-a-version",
"oldCliRoute": "astryx docs cli/integrations/versioning pick-a-version",
"oldDocsiteUrl": "/docs/cli-integrations-versioning#pick-a-version",
"placement": "namespace:cli/integrations/versioning",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/versioning.",
"rationale": "A section of cli/integrations/versioning: Pick a version.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/versioning#know-what-breaks-apps",
"oldCliRoute": "astryx docs cli/integrations/versioning know-what-breaks-apps",
"oldDocsiteUrl": "/docs/cli-integrations-versioning#know-what-breaks-apps",
"placement": "namespace:cli/integrations/versioning",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/versioning.",
"rationale": "A section of cli/integrations/versioning: Know what breaks apps.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/versioning#declare-peer-ranges",
"oldCliRoute": "astryx docs cli/integrations/versioning declare-peer-ranges",
"oldDocsiteUrl": "/docs/cli-integrations-versioning#declare-peer-ranges",
"placement": "namespace:cli/integrations/versioning",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/versioning.",
"rationale": "A section of cli/integrations/versioning: Declare peer ranges.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/versioning#support-older-clis",
"oldCliRoute": "astryx docs cli/integrations/versioning support-older-clis",
"oldDocsiteUrl": "/docs/cli-integrations-versioning#support-older-clis",
"placement": "namespace:cli/integrations/versioning",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/versioning.",
"rationale": "A section of cli/integrations/versioning: Support older CLIs.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/versioning#codemods-and-versions",
"oldCliRoute": "astryx docs cli/integrations/versioning codemods-and-versions",
"oldDocsiteUrl": "/docs/cli-integrations-versioning#name-codemod-folders-after-core-versions",
"placement": "namespace:cli/integrations/versioning",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/versioning.",
"rationale": "A section of cli/integrations/versioning: Name codemod folders after Core versions.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/publishing",
"oldCliRoute": "astryx docs cli/integrations/publishing",
"oldDocsiteUrl": "/docs/cli-integrations-publishing",
"placement": "namespace:cli/integrations",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:integrations', slot: 'ship', order: 40}.",
"rationale": "Publish an integration: Publish your package to npm under the right release tag, and check it before and after. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/publishing#check-before-you-publish",
"oldCliRoute": "astryx docs cli/integrations/publishing check-before-you-publish",
"oldDocsiteUrl": "/docs/cli-integrations-publishing#check-before-you-publish",
"placement": "namespace:cli/integrations/publishing",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/publishing.",
"rationale": "A section of cli/integrations/publishing: Check before you publish.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/publishing#keep-private-files-out",
"oldCliRoute": "astryx docs cli/integrations/publishing keep-private-files-out",
"oldDocsiteUrl": "/docs/cli-integrations-publishing#keep-private-files-out",
"placement": "namespace:cli/integrations/publishing",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/publishing.",
"rationale": "A section of cli/integrations/publishing: Keep private files out.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/publishing#publish-to-npm",
"oldCliRoute": "astryx docs cli/integrations/publishing publish-to-npm",
"oldDocsiteUrl": "/docs/cli-integrations-publishing#publish-to-npm",
"placement": "namespace:cli/integrations/publishing",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/publishing.",
"rationale": "A section of cli/integrations/publishing: Publish to npm.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/publishing#check-the-published-package",
"oldCliRoute": "astryx docs cli/integrations/publishing check-the-published-package",
"oldDocsiteUrl": "/docs/cli-integrations-publishing#check-the-published-package",
"placement": "namespace:cli/integrations/publishing",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/publishing.",
"rationale": "A section of cli/integrations/publishing: Check the published package.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/upgrading",
"oldCliRoute": "astryx docs cli/integrations/upgrading",
"oldDocsiteUrl": "/docs/cli-integrations-upgrading",
"placement": "namespace:cli/integrations",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:integrations', slot: 'ship', order: 50}.",
"rationale": "Upgrading: Update your package for each Astryx release, and help apps upgrade with it. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/upgrading#update-for-a-new-astryx-release",
"oldCliRoute": "astryx docs cli/integrations/upgrading update-for-a-new-astryx-release",
"oldDocsiteUrl": "/docs/cli-integrations-upgrading#update-for-a-new-astryx-release",
"placement": "namespace:cli/integrations/upgrading",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/upgrading.",
"rationale": "A section of cli/integrations/upgrading: Update for a new Astryx release.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/upgrading#upgrade-an-app",
"oldCliRoute": "astryx docs cli/integrations/upgrading upgrade-an-app",
"oldDocsiteUrl": "/docs/cli-integrations-upgrading#upgrade-an-app",
"placement": "namespace:cli/integrations/upgrading",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/upgrading.",
"rationale": "A section of cli/integrations/upgrading: Upgrade an app.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/upgrading#know-which-files-upgrades-skip",
"oldCliRoute": "astryx docs cli/integrations/upgrading know-which-files-upgrades-skip",
"oldDocsiteUrl": "/docs/cli-integrations-upgrading#know-which-files-upgrades-skip",
"placement": "namespace:cli/integrations/upgrading",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/upgrading.",
"rationale": "A section of cli/integrations/upgrading: Know which files upgrades skip.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/troubleshooting",
"oldCliRoute": "astryx docs cli/integrations/troubleshooting",
"oldDocsiteUrl": "/docs/cli-integrations-troubleshooting",
"placement": "namespace:cli/integrations",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:integrations', slot: 'help', order: 10}.",
"rationale": "Troubleshooting: Find the message the CLI printed while you build, verify, or install an integration, and apply its fix. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/troubleshooting#fix-setup-errors",
"oldCliRoute": "astryx docs cli/integrations/troubleshooting fix-setup-errors",
"oldDocsiteUrl": "/docs/cli-integrations-troubleshooting#fix-setup-errors",
"placement": "namespace:cli/integrations/troubleshooting",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/troubleshooting.",
"rationale": "A section of cli/integrations/troubleshooting: Fix setup errors.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/troubleshooting#fix-verify-failures",
"oldCliRoute": "astryx docs cli/integrations/troubleshooting fix-verify-failures",
"oldDocsiteUrl": "/docs/cli-integrations-troubleshooting#fix-integration-verify-failures",
"placement": "namespace:cli/integrations/troubleshooting",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/troubleshooting.",
"rationale": "A section of cli/integrations/troubleshooting: Fix integration verify failures.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/troubleshooting#fix-problems-in-an-app",
"oldCliRoute": "astryx docs cli/integrations/troubleshooting fix-problems-in-an-app",
"oldDocsiteUrl": "/docs/cli-integrations-troubleshooting#fix-problems-in-an-app",
"placement": "namespace:cli/integrations/troubleshooting",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/troubleshooting.",
"rationale": "A section of cli/integrations/troubleshooting: Fix problems in an app.",
"status": "proposed"
},
{
"kind": "namespace",
"id": "cli/integrations/docs",
"oldCliRoute": "astryx docs cli/integrations/docs",
"oldDocsiteUrl": null,
"placement": "namespace:cli/integrations/docs",
"aliasNeeded": false,
"evidence": "assets/docs/tree/docs.doc.mjs declares it, and places it in cli/integrations' contribute slot.",
"rationale": "The guides to writing docs for an integration package. They replace cli/writing-docs, whose docsite page /docs/cli-writing-docs redirects to cli/integrations/docs/add-a-topic. The docsite does not publish the namespace itself yet.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/docs/add-a-topic",
"oldCliRoute": "astryx docs cli/integrations/docs/add-a-topic",
"oldDocsiteUrl": "/docs/cli-integrations-docs-add-a-topic",
"placement": "namespace:cli/integrations/docs",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:docs', slot: 'guides', order: 10}.",
"rationale": "Add a topic: Add a doc topic to your package and write its sections. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/docs/add-a-topic#add-a-topic-with-the-cli",
"oldCliRoute": "astryx docs cli/integrations/docs/add-a-topic add-a-topic-with-the-cli",
"oldDocsiteUrl": "/docs/cli-integrations-docs-add-a-topic#add-a-topic-with-the-cli",
"placement": "namespace:cli/integrations/docs/add-a-topic",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/docs/add-a-topic.",
"rationale": "A section of cli/integrations/docs/add-a-topic: Add a topic with the CLI.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/docs/add-a-topic#write-the-sections",
"oldCliRoute": "astryx docs cli/integrations/docs/add-a-topic write-the-sections",
"oldDocsiteUrl": "/docs/cli-integrations-docs-add-a-topic#write-the-sections",
"placement": "namespace:cli/integrations/docs/add-a-topic",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/docs/add-a-topic.",
"rationale": "A section of cli/integrations/docs/add-a-topic: Write the sections.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/docs/add-a-topic#pick-the-doc-kind",
"oldCliRoute": "astryx docs cli/integrations/docs/add-a-topic pick-the-doc-kind",
"oldDocsiteUrl": "/docs/cli-integrations-docs-add-a-topic#pick-the-doc-kind",
"placement": "namespace:cli/integrations/docs/add-a-topic",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/docs/add-a-topic.",
"rationale": "A section of cli/integrations/docs/add-a-topic: Pick the doc kind.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/docs/add-a-topic#keep-topics-in-the-docs-root",
"oldCliRoute": "astryx docs cli/integrations/docs/add-a-topic keep-topics-in-the-docs-root",
"oldDocsiteUrl": "/docs/cli-integrations-docs-add-a-topic#keep-topics-in-the-docs-root",
"placement": "namespace:cli/integrations/docs/add-a-topic",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/docs/add-a-topic.",
"rationale": "A section of cli/integrations/docs/add-a-topic: Keep topics in the docs root.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/docs/sections-and-placement",
"oldCliRoute": "astryx docs cli/integrations/docs/sections-and-placement",
"oldDocsiteUrl": "/docs/cli-integrations-docs-sections-and-placement",
"placement": "namespace:cli/integrations/docs",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:docs', slot: 'guides', order: 20}.",
"rationale": "Sections and placement: Give your package its own docs section and place guides in it. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/docs/sections-and-placement#add-a-docs-section",
"oldCliRoute": "astryx docs cli/integrations/docs/sections-and-placement add-a-docs-section",
"oldDocsiteUrl": "/docs/cli-integrations-docs-sections-and-placement#add-a-docs-section",
"placement": "namespace:cli/integrations/docs/sections-and-placement",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/docs/sections-and-placement.",
"rationale": "A section of cli/integrations/docs/sections-and-placement: Add a docs section.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/docs/sections-and-placement#place-a-doc",
"oldCliRoute": "astryx docs cli/integrations/docs/sections-and-placement place-a-doc",
"oldDocsiteUrl": "/docs/cli-integrations-docs-sections-and-placement#place-a-doc",
"placement": "namespace:cli/integrations/docs/sections-and-placement",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/docs/sections-and-placement.",
"rationale": "A section of cli/integrations/docs/sections-and-placement: Place a doc.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/docs/sections-and-placement#fix-a-failed-placement",
"oldCliRoute": "astryx docs cli/integrations/docs/sections-and-placement fix-a-failed-placement",
"oldDocsiteUrl": "/docs/cli-integrations-docs-sections-and-placement#fix-a-failed-placement",
"placement": "namespace:cli/integrations/docs/sections-and-placement",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/docs/sections-and-placement.",
"rationale": "A section of cli/integrations/docs/sections-and-placement: Fix a failed placement.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/docs/links",
"oldCliRoute": "astryx docs cli/integrations/docs/links",
"oldDocsiteUrl": "/docs/cli-integrations-docs-links",
"placement": "namespace:cli/integrations/docs",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:docs', slot: 'guides', order: 30}.",
"rationale": "Links: Link one doc to another so the link keeps working when the doc moves. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/docs/links#link-another-doc",
"oldCliRoute": "astryx docs cli/integrations/docs/links link-another-doc",
"oldDocsiteUrl": "/docs/cli-integrations-docs-links#link-another-doc",
"placement": "namespace:cli/integrations/docs/links",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/docs/links.",
"rationale": "A section of cli/integrations/docs/links: Link another doc.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/docs/links#link-another-packages-docs",
"oldCliRoute": "astryx docs cli/integrations/docs/links link-another-packages-docs",
"oldDocsiteUrl": "/docs/cli-integrations-docs-links#link-another-package-s-docs",
"placement": "namespace:cli/integrations/docs/links",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/docs/links.",
"rationale": "A section of cli/integrations/docs/links: Link another package's docs.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/docs/links#fix-a-link-that-names-no-doc",
"oldCliRoute": "astryx docs cli/integrations/docs/links fix-a-link-that-names-no-doc",
"oldDocsiteUrl": "/docs/cli-integrations-docs-links#fix-a-link-that-names-no-doc",
"placement": "namespace:cli/integrations/docs/links",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/docs/links.",
"rationale": "A section of cli/integrations/docs/links: Fix a link that names no doc.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/docs/extend-or-replace",
"oldCliRoute": "astryx docs cli/integrations/docs/extend-or-replace",
"oldDocsiteUrl": "/docs/cli-integrations-docs-extend-or-replace",
"placement": "namespace:cli/integrations/docs",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:docs', slot: 'guides', order: 40}.",
"rationale": "Extend or replace a topic: Take over a topic, or merge sections into it. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/docs/extend-or-replace#replace-a-topic",
"oldCliRoute": "astryx docs cli/integrations/docs/extend-or-replace replace-a-topic",
"oldDocsiteUrl": "/docs/cli-integrations-docs-extend-or-replace#replace-a-topic",
"placement": "namespace:cli/integrations/docs/extend-or-replace",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/docs/extend-or-replace.",
"rationale": "A section of cli/integrations/docs/extend-or-replace: Replace a topic.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/docs/extend-or-replace#extend-a-topic",
"oldCliRoute": "astryx docs cli/integrations/docs/extend-or-replace extend-a-topic",
"oldDocsiteUrl": "/docs/cli-integrations-docs-extend-or-replace#extend-a-topic",
"placement": "namespace:cli/integrations/docs/extend-or-replace",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/docs/extend-or-replace.",
"rationale": "A section of cli/integrations/docs/extend-or-replace: Extend a topic.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/docs/extend-or-replace#check-overlaps-with-core-topics",
"oldCliRoute": "astryx docs cli/integrations/docs/extend-or-replace check-overlaps-with-core-topics",
"oldDocsiteUrl": "/docs/cli-integrations-docs-extend-or-replace#check-overlaps-with-core-topics",
"placement": "namespace:cli/integrations/docs/extend-or-replace",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/docs/extend-or-replace.",
"rationale": "A section of cli/integrations/docs/extend-or-replace: Check overlaps with Core topics.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/docs/short-and-findable",
"oldCliRoute": "astryx docs cli/integrations/docs/short-and-findable",
"oldDocsiteUrl": "/docs/cli-integrations-docs-short-and-findable",
"placement": "namespace:cli/integrations/docs",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:docs', slot: 'guides', order: 50}.",
"rationale": "Short and findable: Write short sections that people and agents find by search. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/docs/short-and-findable#keep-each-read-short",
"oldCliRoute": "astryx docs cli/integrations/docs/short-and-findable keep-each-read-short",
"oldDocsiteUrl": "/docs/cli-integrations-docs-short-and-findable#keep-each-read-short",
"placement": "namespace:cli/integrations/docs/short-and-findable",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/docs/short-and-findable.",
"rationale": "A section of cli/integrations/docs/short-and-findable: Keep each read short.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/docs/short-and-findable#lead-with-the-summary",
"oldCliRoute": "astryx docs cli/integrations/docs/short-and-findable lead-with-the-summary",
"oldDocsiteUrl": "/docs/cli-integrations-docs-short-and-findable#lead-with-the-summary",
"placement": "namespace:cli/integrations/docs/short-and-findable",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/docs/short-and-findable.",
"rationale": "A section of cli/integrations/docs/short-and-findable: Lead with the summary.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/docs/short-and-findable#make-docs-findable",
"oldCliRoute": "astryx docs cli/integrations/docs/short-and-findable make-docs-findable",
"oldDocsiteUrl": "/docs/cli-integrations-docs-short-and-findable#make-docs-findable",
"placement": "namespace:cli/integrations/docs/short-and-findable",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/docs/short-and-findable.",
"rationale": "A section of cli/integrations/docs/short-and-findable: Make docs findable.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/docs/short-and-findable#test-with-search",
"oldCliRoute": "astryx docs cli/integrations/docs/short-and-findable test-with-search",
"oldDocsiteUrl": "/docs/cli-integrations-docs-short-and-findable#test-with-search",
"placement": "namespace:cli/integrations/docs/short-and-findable",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/docs/short-and-findable.",
"rationale": "A section of cli/integrations/docs/short-and-findable: Test with search.",
"status": "proposed"
},
{
"kind": "topic",
"id": "cli/integrations/docs/check-your-docs",
"oldCliRoute": "astryx docs cli/integrations/docs/check-your-docs",
"oldDocsiteUrl": "/docs/cli-integrations-docs-check-your-docs",
"placement": "namespace:cli/integrations/docs",
"aliasNeeded": false,
"evidence": "It places itself: placement {parent: 'namespace:docs', slot: 'guides', order: 60}.",
"rationale": "Check your docs: Check the docs tree, links, overlaps, read size, and CLI peer. New in this change, so it has no older route.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/docs/check-your-docs#run-the-docs-check",
"oldCliRoute": "astryx docs cli/integrations/docs/check-your-docs run-the-docs-check",
"oldDocsiteUrl": "/docs/cli-integrations-docs-check-your-docs#run-the-docs-check",
"placement": "namespace:cli/integrations/docs/check-your-docs",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/docs/check-your-docs.",
"rationale": "A section of cli/integrations/docs/check-your-docs: Run the docs check.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/docs/check-your-docs#know-what-fails-the-check",
"oldCliRoute": "astryx docs cli/integrations/docs/check-your-docs know-what-fails-the-check",
"oldDocsiteUrl": "/docs/cli-integrations-docs-check-your-docs#know-what-fails-the-check",
"placement": "namespace:cli/integrations/docs/check-your-docs",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/docs/check-your-docs.",
"rationale": "A section of cli/integrations/docs/check-your-docs: Know what fails the check.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/docs/check-your-docs#check-read-size",
"oldCliRoute": "astryx docs cli/integrations/docs/check-your-docs check-read-size",
"oldDocsiteUrl": "/docs/cli-integrations-docs-check-your-docs#check-read-size",
"placement": "namespace:cli/integrations/docs/check-your-docs",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/docs/check-your-docs.",
"rationale": "A section of cli/integrations/docs/check-your-docs: Check read size.",
"status": "proposed"
},
{
"kind": "section",
"id": "cli/integrations/docs/check-your-docs#check-the-cli-peer",
"oldCliRoute": "astryx docs cli/integrations/docs/check-your-docs check-the-cli-peer",
"oldDocsiteUrl": "/docs/cli-integrations-docs-check-your-docs#check-the-cli-peer",
"placement": "namespace:cli/integrations/docs/check-your-docs",
"aliasNeeded": false,
"evidence": "Moves with cli/integrations/docs/check-your-docs.",
"rationale": "A section of cli/integrations/docs/check-your-docs: Check the CLI peer.",
"status": "proposed"
},
{
"kind": "topic",
"id": "color",
"oldCliRoute": "astryx docs color",
"oldDocsiteUrl": "/docs/color",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Token-category page (tokenCategory 'color') whose tables come from `tokens` through token references. Only the docsite's 'foundations' category label groups it with the other token pages, and a label alone is not evidence for a route segment.",
"status": "proposed"
},
{
"kind": "section",
"id": "color#overview",
"oldCliRoute": "astryx docs color overview",
"oldDocsiteUrl": "/docs/color#overview",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of color under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "color#surface-colors",
"oldCliRoute": "astryx docs color surface-colors",
"oldDocsiteUrl": "/docs/color#color-tokens",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of color under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "color#usage",
"oldCliRoute": "astryx docs color usage",
"oldDocsiteUrl": "/docs/color#use-color-tokens-in-stylex",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of color under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "color#best-practices",
"oldCliRoute": "astryx docs color best-practices",
"oldDocsiteUrl": "/docs/color#best-practices",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of color under the same key.",
"status": "proposed"
},
{
"kind": "topic",
"id": "elevation",
"oldCliRoute": "astryx docs elevation",
"oldDocsiteUrl": "/docs/elevation",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Token-category page (tokenCategory 'shadow') whose tables come from `tokens` through token references. Only the docsite's 'foundations' category label groups it with the other token pages, and a label alone is not evidence for a route segment.",
"status": "proposed"
},
{
"kind": "section",
"id": "elevation#overview",
"oldCliRoute": "astryx docs elevation overview",
"oldDocsiteUrl": "/docs/elevation#overview",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of elevation under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "elevation#elevation-scale",
"oldCliRoute": "astryx docs elevation elevation-scale",
"oldDocsiteUrl": "/docs/elevation#elevation-scale",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of elevation under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "elevation#choosing-a-level",
"oldCliRoute": "astryx docs elevation choosing-a-level",
"oldDocsiteUrl": "/docs/elevation#choosing-a-level",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of elevation under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "elevation#the-elevation-prop",
"oldCliRoute": "astryx docs elevation the-elevation-prop",
"oldDocsiteUrl": "/docs/elevation#the-elevation-prop",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of elevation under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "elevation#usage",
"oldCliRoute": "astryx docs elevation usage",
"oldDocsiteUrl": "/docs/elevation#usage",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of elevation under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "elevation#best-practices",
"oldCliRoute": "astryx docs elevation best-practices",
"oldDocsiteUrl": "/docs/elevation#best-practices",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of elevation under the same key.",
"status": "proposed"
},
{
"kind": "topic",
"id": "getting-started",
"oldCliRoute": "astryx docs getting-started",
"oldDocsiteUrl": "/docs/getting-started",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Entry guide: the docsite redirects /docs here, and it links out to migration, styling, theme and tokens. Nothing places it under another topic.",
"status": "proposed"
},
{
"kind": "section",
"id": "getting-started#quick-start-with-ai",
"oldCliRoute": "astryx docs getting-started quick-start-with-ai",
"oldDocsiteUrl": "/docs/getting-started#quick-start-with-ai",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of getting-started under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "getting-started#install",
"oldCliRoute": "astryx docs getting-started install",
"oldDocsiteUrl": "/docs/getting-started#install",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of getting-started under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "getting-started#add-base-css-and-a-theme",
"oldCliRoute": "astryx docs getting-started add-base-css-and-a-theme",
"oldDocsiteUrl": "/docs/getting-started#add-base-css-and-a-theme",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of getting-started under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "getting-started#add-your-first-component",
"oldCliRoute": "astryx docs getting-started add-your-first-component",
"oldDocsiteUrl": "/docs/getting-started#add-your-first-component",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of getting-started under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "getting-started#customize-with-stylex",
"oldCliRoute": "astryx docs getting-started customize-with-stylex",
"oldDocsiteUrl": "/docs/getting-started#customize-with-stylex",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of getting-started under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "getting-started#example-apps",
"oldCliRoute": "astryx docs getting-started example-apps",
"oldDocsiteUrl": "/docs/getting-started#example-apps",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of getting-started under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "getting-started#explore-the-cli",
"oldCliRoute": "astryx docs getting-started explore-the-cli",
"oldDocsiteUrl": "/docs/getting-started#explore-the-cli",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of getting-started under the same key.",
"status": "proposed"
},
{
"kind": "topic",
"id": "icons",
"oldCliRoute": "astryx docs icons",
"oldDocsiteUrl": "/docs/icons",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Shares only the 'foundations' category label with the token pages; it has no tokenCategory and no topic links to it.",
"status": "proposed"
},
{
"kind": "section",
"id": "icons#available-names",
"oldCliRoute": "astryx docs icons available-names",
"oldDocsiteUrl": "/docs/icons#available-names",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of icons under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "icons#custom-icons",
"oldCliRoute": "astryx docs icons custom-icons",
"oldDocsiteUrl": "/docs/icons#custom-icons",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of icons under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "icons#theme-overrides",
"oldCliRoute": "astryx docs icons theme-overrides",
"oldDocsiteUrl": "/docs/icons#theme-overrides",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of icons under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "icons#component-and-library-icons",
"oldCliRoute": "astryx docs icons component-and-library-icons",
"oldDocsiteUrl": "/docs/icons#component-and-library-icons",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of icons under the same key.",
"status": "proposed"
},
{
"kind": "topic",
"id": "illustrations",
"oldCliRoute": "astryx docs illustrations",
"oldDocsiteUrl": "/docs/illustrations",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Shares only the 'foundations' category label with the token pages; it has no tokenCategory and no topic links to it.",
"status": "proposed"
},
{
"kind": "section",
"id": "illustrations#when-to-use",
"oldCliRoute": "astryx docs illustrations when-to-use",
"oldDocsiteUrl": "/docs/illustrations#when-to-use",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of illustrations under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "illustrations#guidelines",
"oldCliRoute": "astryx docs illustrations guidelines",
"oldDocsiteUrl": "/docs/illustrations#guidelines",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of illustrations under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "illustrations#placement",
"oldCliRoute": "astryx docs illustrations placement",
"oldDocsiteUrl": "/docs/illustrations#placement",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of illustrations under the same key.",
"status": "proposed"
},
{
"kind": "topic",
"id": "internationalization",
"oldCliRoute": "astryx docs internationalization",
"oldDocsiteUrl": "/docs/internationalization",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Standalone guide: no topic links to it, and nothing authored places it under another topic.",
"status": "proposed"
},
{
"kind": "section",
"id": "internationalization#quick-start",
"oldCliRoute": "astryx docs internationalization quick-start",
"oldDocsiteUrl": "/docs/internationalization#set-the-locale",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of internationalization under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "internationalization#runtime-language-swap",
"oldCliRoute": "astryx docs internationalization runtime-language-swap",
"oldDocsiteUrl": "/docs/internationalization#change-the-language-at-runtime",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of internationalization under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "internationalization#text-direction-rtl",
"oldCliRoute": "astryx docs internationalization text-direction-rtl",
"oldDocsiteUrl": "/docs/internationalization#text-direction-rtl",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of internationalization under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "internationalization#override-text",
"oldCliRoute": "astryx docs internationalization override-text",
"oldDocsiteUrl": "/docs/internationalization#overriding-astryx-s-default-text",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of internationalization, under a shorter key (was `overriding-astryx-s-default-text`).",
"status": "proposed"
},
{
"kind": "section",
"id": "internationalization#own-i18n-library",
"oldCliRoute": "astryx docs internationalization own-i18n-library",
"oldDocsiteUrl": "/docs/internationalization#using-astryx-with-your-own-i18n-library",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of internationalization, under a shorter key (was `using-astryx-with-your-own-i18n-library`).",
"status": "proposed"
},
{
"kind": "section",
"id": "internationalization#astryx-as-i18n",
"oldCliRoute": "astryx docs internationalization astryx-as-i18n",
"oldDocsiteUrl": "/docs/internationalization#using-astryx-as-your-i18n-library",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of internationalization, under a shorter key (was `using-astryx-as-your-i18n-library`).",
"status": "proposed"
},
{
"kind": "section",
"id": "internationalization#testing-your-translations",
"oldCliRoute": "astryx docs internationalization testing-your-translations",
"oldDocsiteUrl": "/docs/internationalization#testing-your-translations",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of internationalization under the same key.",
"status": "proposed"
},
{
"kind": "topic",
"id": "layout",
"oldCliRoute": "astryx docs layout",
"oldDocsiteUrl": "/docs/layout",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Standalone guide, linked from principles. The `layout` command group has its own command docs (generated bucket), so they are not children of this topic.",
"status": "proposed"
},
{
"kind": "section",
"id": "layout#overview",
"oldCliRoute": "astryx docs layout overview",
"oldDocsiteUrl": "/docs/layout#overview",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of layout under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "layout#scaffold",
"oldCliRoute": "astryx docs layout scaffold",
"oldDocsiteUrl": "/docs/layout#scaffold",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of layout under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "layout#shell",
"oldCliRoute": "astryx docs layout shell",
"oldDocsiteUrl": "/docs/layout#shell",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of layout: split out of Scaffold, where it was the Shell heading.",
"status": "proposed"
},
{
"kind": "section",
"id": "layout#navigation",
"oldCliRoute": "astryx docs layout navigation",
"oldDocsiteUrl": "/docs/layout#navigation",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of layout: split out of Scaffold, where it was the Navigation heading.",
"status": "proposed"
},
{
"kind": "section",
"id": "layout#structure",
"oldCliRoute": "astryx docs layout structure",
"oldDocsiteUrl": "/docs/layout#structure",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of layout under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "layout#type-hierarchy",
"oldCliRoute": "astryx docs layout type-hierarchy",
"oldDocsiteUrl": "/docs/layout#type-hierarchy",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of layout: split out of Structure, where it was the Type hierarchy heading.",
"status": "proposed"
},
{
"kind": "section",
"id": "layout#containers",
"oldCliRoute": "astryx docs layout containers",
"oldDocsiteUrl": "/docs/layout#card-or-rows",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of layout: split out of Structure, where it was the Containers heading.",
"status": "proposed"
},
{
"kind": "section",
"id": "layout#headers-and-footers",
"oldCliRoute": "astryx docs layout headers-and-footers",
"oldDocsiteUrl": "/docs/layout#headers-and-footers",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of layout: split out of Structure, where it was the Headers and footers heading.",
"status": "proposed"
},
{
"kind": "section",
"id": "layout#side-panels",
"oldCliRoute": "astryx docs layout side-panels",
"oldDocsiteUrl": "/docs/layout#side-panels",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of layout: split out of Structure, where it was the Side panels heading.",
"status": "proposed"
},
{
"kind": "section",
"id": "layout#spacing",
"oldCliRoute": "astryx docs layout spacing",
"oldDocsiteUrl": "/docs/layout#spacing",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of layout under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "layout#alignment",
"oldCliRoute": "astryx docs layout alignment",
"oldDocsiteUrl": "/docs/layout#alignment",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of layout: split out of Spacing, where it was the Alignment heading.",
"status": "proposed"
},
{
"kind": "section",
"id": "layout#rhythm",
"oldCliRoute": "astryx docs layout rhythm",
"oldDocsiteUrl": "/docs/layout#rhythm",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of layout: split out of Spacing, where it was the Rhythm heading.",
"status": "proposed"
},
{
"kind": "section",
"id": "layout#density",
"oldCliRoute": "astryx docs layout density",
"oldDocsiteUrl": "/docs/layout#density-and-size",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of layout: split out of Spacing, where it was the Density and size heading.",
"status": "proposed"
},
{
"kind": "section",
"id": "layout#breakpoints",
"oldCliRoute": "astryx docs layout breakpoints",
"oldDocsiteUrl": "/docs/layout#breakpoints",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of layout under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "layout#responsive-contract",
"oldCliRoute": "astryx docs layout responsive-contract",
"oldDocsiteUrl": "/docs/layout#responsive-contract",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of layout: split out of Breakpoints, where it was the Responsive contract heading.",
"status": "proposed"
},
{
"kind": "topic",
"id": "migration",
"oldCliRoute": "astryx docs migration",
"oldDocsiteUrl": "/docs/migration",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "One incremental guide (Tailwind, shadcn, Radix): its sections are the steps of that guide, and it only links out (styling, theme). Version upgrades are the `upgrade` command doc, and the draft shadcn-compatibility file is not a route, so no topic would sit under a migration namespace.",
"status": "proposed"
},
{
"kind": "section",
"id": "migration#overview",
"oldCliRoute": "astryx docs migration overview",
"oldDocsiteUrl": "/docs/migration#overview",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of migration under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "migration#recommended-order",
"oldCliRoute": "astryx docs migration recommended-order",
"oldDocsiteUrl": "/docs/migration#recommended-order",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of migration under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "migration#cli-workflow",
"oldCliRoute": "astryx docs migration cli-workflow",
"oldDocsiteUrl": "/docs/migration#cli-workflow",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of migration under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "migration#theme-and-css-setup",
"oldCliRoute": "astryx docs migration theme-and-css-setup",
"oldDocsiteUrl": "/docs/migration#theme-and-css-setup",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of migration under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "migration#cascade-layer-safety",
"oldCliRoute": "astryx docs migration cascade-layer-safety",
"oldDocsiteUrl": "/docs/migration#why-resets-break-cascade-layers",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of migration under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "migration#layer-audit",
"oldCliRoute": "astryx docs migration layer-audit",
"oldDocsiteUrl": "/docs/migration#cascade-layer-audit",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of migration: split out of Cascade Layer Safety (its audit checklist).",
"status": "proposed"
},
{
"kind": "section",
"id": "migration#foundation-smoke-test",
"oldCliRoute": "astryx docs migration foundation-smoke-test",
"oldDocsiteUrl": "/docs/migration#foundation-smoke-test",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of migration under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "migration#move-the-app-frame-first",
"oldCliRoute": "astryx docs migration move-the-app-frame-first",
"oldDocsiteUrl": "/docs/migration#move-the-app-frame-first",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of migration under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "migration#map-shadcn-and-radix-primitives",
"oldCliRoute": "astryx docs migration map-shadcn-and-radix-primitives",
"oldDocsiteUrl": "/docs/migration#map-shadcn-and-radix-primitives",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of migration under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "migration#command-palette",
"oldCliRoute": "astryx docs migration command-palette",
"oldDocsiteUrl": "/docs/migration#command-palette-settings-and-theme",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of migration, under a shorter key (was `command-palette-settings-and-theme`).",
"status": "proposed"
},
{
"kind": "section",
"id": "migration#verification-checklist",
"oldCliRoute": "astryx docs migration verification-checklist",
"oldDocsiteUrl": "/docs/migration#verification-checklist",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of migration under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "migration#ai-migration-prompt",
"oldCliRoute": "astryx docs migration ai-migration-prompt",
"oldDocsiteUrl": "/docs/migration#ai-migration-prompt",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of migration under the same key.",
"status": "proposed"
},
{
"kind": "topic",
"id": "motion",
"oldCliRoute": "astryx docs motion",
"oldDocsiteUrl": "/docs/motion",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Token-category page (tokenCategory 'duration') whose tables come from `tokens` through token references. Only the docsite's 'foundations' category label groups it with the other token pages, and a label alone is not evidence for a route segment.",
"status": "proposed"
},
{
"kind": "section",
"id": "motion#overview",
"oldCliRoute": "astryx docs motion overview",
"oldDocsiteUrl": "/docs/motion#overview",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of motion under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "motion#duration",
"oldCliRoute": "astryx docs motion duration",
"oldDocsiteUrl": "/docs/motion#duration",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of motion under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "motion#easing",
"oldCliRoute": "astryx docs motion easing",
"oldDocsiteUrl": "/docs/motion#easing",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of motion under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "motion#where-motion-helps",
"oldCliRoute": "astryx docs motion where-motion-helps",
"oldDocsiteUrl": "/docs/motion#where-motion-helps",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of motion under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "motion#where-motion-hurts",
"oldCliRoute": "astryx docs motion where-motion-hurts",
"oldDocsiteUrl": "/docs/motion#where-motion-hurts",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of motion under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "motion#movement-principles",
"oldCliRoute": "astryx docs motion movement-principles",
"oldDocsiteUrl": "/docs/motion#movement-principles",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of motion under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "motion#respecting-user-preferences",
"oldCliRoute": "astryx docs motion respecting-user-preferences",
"oldDocsiteUrl": "/docs/motion#respecting-user-preferences",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of motion under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "motion#usage",
"oldCliRoute": "astryx docs motion usage",
"oldDocsiteUrl": "/docs/motion#animate-with-motion-tokens",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of motion under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "motion#best-practices",
"oldCliRoute": "astryx docs motion best-practices",
"oldDocsiteUrl": "/docs/motion#best-practices",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of motion under the same key.",
"status": "proposed"
},
{
"kind": "topic",
"id": "principles",
"oldCliRoute": "astryx docs principles",
"oldDocsiteUrl": "/docs/principles",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Cross-cutting rules that link out to layout, styling and tokens. No topic links to it, and nothing places it under another topic.",
"status": "proposed"
},
{
"kind": "section",
"id": "principles#design-philosophy",
"oldCliRoute": "astryx docs principles design-philosophy",
"oldDocsiteUrl": "/docs/principles#design-philosophy",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of principles under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "principles#rules",
"oldCliRoute": "astryx docs principles rules",
"oldDocsiteUrl": "/docs/principles#rules",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of principles under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "principles#styling-approach",
"oldCliRoute": "astryx docs principles styling-approach",
"oldDocsiteUrl": "/docs/principles#styling-approach",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of principles under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "principles#anti-patterns",
"oldCliRoute": "astryx docs principles anti-patterns",
"oldDocsiteUrl": "/docs/principles#anti-patterns",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of principles under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "principles#design-tokens",
"oldCliRoute": "astryx docs principles design-tokens",
"oldDocsiteUrl": "/docs/principles#design-tokens",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of principles under the same key.",
"status": "proposed"
},
{
"kind": "topic",
"id": "shape",
"oldCliRoute": "astryx docs shape",
"oldDocsiteUrl": "/docs/shape",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Token-category page (tokenCategory 'radius') whose tables come from `tokens` through token references. Only the docsite's 'foundations' category label groups it with the other token pages, and a label alone is not evidence for a route segment.",
"status": "proposed"
},
{
"kind": "section",
"id": "shape#overview",
"oldCliRoute": "astryx docs shape overview",
"oldDocsiteUrl": "/docs/shape#overview",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of shape under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "shape#radius-scale",
"oldCliRoute": "astryx docs shape radius-scale",
"oldDocsiteUrl": "/docs/shape#radius-scale",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of shape under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "shape#concentric-radius",
"oldCliRoute": "astryx docs shape concentric-radius",
"oldDocsiteUrl": "/docs/shape#concentric-radius",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of shape under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "shape#best-practices",
"oldCliRoute": "astryx docs shape best-practices",
"oldDocsiteUrl": "/docs/shape#best-practices",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of shape under the same key.",
"status": "proposed"
},
{
"kind": "topic",
"id": "spacing",
"oldCliRoute": "astryx docs spacing",
"oldDocsiteUrl": "/docs/spacing",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Token-category page (tokenCategory 'spacing') whose tables come from `tokens` through token references. Only the docsite's 'foundations' category label groups it with the other token pages, and a label alone is not evidence for a route segment.",
"status": "proposed"
},
{
"kind": "section",
"id": "spacing#overview",
"oldCliRoute": "astryx docs spacing overview",
"oldDocsiteUrl": "/docs/spacing#overview",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of spacing under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "spacing#scale",
"oldCliRoute": "astryx docs spacing scale",
"oldDocsiteUrl": "/docs/spacing#scale",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of spacing under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "spacing#usage",
"oldCliRoute": "astryx docs spacing usage",
"oldDocsiteUrl": "/docs/spacing#usage",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of spacing under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "spacing#best-practices",
"oldCliRoute": "astryx docs spacing best-practices",
"oldDocsiteUrl": "/docs/spacing#best-practices",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of spacing under the same key.",
"status": "proposed"
},
{
"kind": "topic",
"id": "styling-libraries",
"oldCliRoute": "astryx docs styling-libraries",
"oldDocsiteUrl": "/docs/styling-libraries",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Two topics send readers here: styling (Overview, Tailwind Integration) and theme (useTheme Hook). With no single parent, only the hyphen would put it under styling, and a hyphen alone is not evidence.",
"status": "proposed"
},
{
"kind": "section",
"id": "styling-libraries#core-principle",
"oldCliRoute": "astryx docs styling-libraries core-principle",
"oldDocsiteUrl": "/docs/styling-libraries#core-principle",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of styling-libraries under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "styling-libraries#choose-an-integration-path",
"oldCliRoute": "astryx docs styling-libraries choose-an-integration-path",
"oldDocsiteUrl": "/docs/styling-libraries#choose-an-integration-path",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of styling-libraries under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "styling-libraries#best-practices",
"oldCliRoute": "astryx docs styling-libraries best-practices",
"oldDocsiteUrl": "/docs/styling-libraries#best-practices",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of styling-libraries under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "styling-libraries#plain-css-and-css-modules",
"oldCliRoute": "astryx docs styling-libraries plain-css-and-css-modules",
"oldDocsiteUrl": "/docs/styling-libraries#plain-css-and-css-modules",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of styling-libraries under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "styling-libraries#stylex",
"oldCliRoute": "astryx docs styling-libraries stylex",
"oldDocsiteUrl": "/docs/styling-libraries#stylex",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of styling-libraries under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "styling-libraries#tailwind",
"oldCliRoute": "astryx docs styling-libraries tailwind",
"oldDocsiteUrl": "/docs/styling-libraries#tailwind",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of styling-libraries under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "styling-libraries#semantic-token-systems",
"oldCliRoute": "astryx docs styling-libraries semantic-token-systems",
"oldDocsiteUrl": "/docs/styling-libraries#panda-chakra-and-other-semantic-token-systems",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of styling-libraries, under a shorter key (was `panda-chakra-and-other-semantic-token-systems`).",
"status": "proposed"
},
{
"kind": "section",
"id": "styling-libraries#mui-and-palette-based-themes",
"oldCliRoute": "astryx docs styling-libraries mui-and-palette-based-themes",
"oldDocsiteUrl": "/docs/styling-libraries#mui-and-palette-based-themes",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of styling-libraries under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "styling-libraries#css-in-js",
"oldCliRoute": "astryx docs styling-libraries css-in-js",
"oldDocsiteUrl": "/docs/styling-libraries#emotion-styled-components-theme-ui-and-styled-system",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of styling-libraries, under a shorter key (was `emotion-styled-components-theme-ui-and-styled-system`).",
"status": "proposed"
},
{
"kind": "section",
"id": "styling-libraries#unocss",
"oldCliRoute": "astryx docs styling-libraries unocss",
"oldDocsiteUrl": "/docs/styling-libraries#unocss-and-custom-utility-systems",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of styling-libraries, under a shorter key (was `unocss-and-custom-utility-systems`).",
"status": "proposed"
},
{
"kind": "section",
"id": "styling-libraries#non-css-processing",
"oldCliRoute": "astryx docs styling-libraries non-css-processing",
"oldDocsiteUrl": "/docs/styling-libraries#non-css-processing",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of styling-libraries under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "styling-libraries#non-css-best-practices",
"oldCliRoute": "astryx docs styling-libraries non-css-best-practices",
"oldDocsiteUrl": "/docs/styling-libraries#non-css-processing-best-practices",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of styling-libraries, under a shorter key (was `non-css-processing-best-practices`).",
"status": "proposed"
},
{
"kind": "section",
"id": "styling-libraries#interop-checklist",
"oldCliRoute": "astryx docs styling-libraries interop-checklist",
"oldDocsiteUrl": "/docs/styling-libraries#interop-checklist",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of styling-libraries under the same key.",
"status": "proposed"
},
{
"kind": "topic",
"id": "styling",
"oldCliRoute": "astryx docs styling",
"oldDocsiteUrl": "/docs/styling",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Linked from six topics (getting-started, migration, principles, theme, tokens, working-with-ai). No topic or authored field places it under another topic.",
"status": "proposed"
},
{
"kind": "section",
"id": "styling#overview",
"oldCliRoute": "astryx docs styling overview",
"oldDocsiteUrl": "/docs/styling#overview",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of styling under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "styling#xstyle-prop",
"oldCliRoute": "astryx docs styling xstyle-prop",
"oldDocsiteUrl": "/docs/styling#xstyle-prop",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of styling under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "styling#tailwind-integration",
"oldCliRoute": "astryx docs styling tailwind-integration",
"oldDocsiteUrl": "/docs/styling#tailwind-integration",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of styling under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "styling#classname-and-style-props",
"oldCliRoute": "astryx docs styling classname-and-style-props",
"oldDocsiteUrl": "/docs/styling#classname-and-style-props",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of styling under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "styling#rest-props-prop-drilling",
"oldCliRoute": "astryx docs styling rest-props-prop-drilling",
"oldDocsiteUrl": "/docs/styling#rest-props-prop-drilling",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of styling under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "styling#compound-components",
"oldCliRoute": "astryx docs styling compound-components",
"oldDocsiteUrl": "/docs/styling#compound-components",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of styling under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "styling#preferred-selector-surface-data-attributes",
"oldCliRoute": "astryx docs styling preferred-selector-surface-data-attributes",
"oldDocsiteUrl": "/docs/styling#data-attribute-selectors",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of styling under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "styling#deprecated-classes",
"oldCliRoute": "astryx docs styling deprecated-classes",
"oldDocsiteUrl": "/docs/styling#deprecated-bare-prop-and-state-classes",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of styling, under a shorter key (was `deprecated-bare-prop-and-state-classes`).",
"status": "proposed"
},
{
"kind": "section",
"id": "styling#design-tokens",
"oldCliRoute": "astryx docs styling design-tokens",
"oldDocsiteUrl": "/docs/styling#design-tokens",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of styling under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "styling#stylex-setup",
"oldCliRoute": "astryx docs styling stylex-setup",
"oldDocsiteUrl": "/docs/styling#stylex-build-setup-required-for-swizzled-components",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of styling, under a shorter key (was `stylex-build-setup-required-for-swizzled-components`).",
"status": "proposed"
},
{
"kind": "section",
"id": "styling#what-not-to-do",
"oldCliRoute": "astryx docs styling what-not-to-do",
"oldDocsiteUrl": "/docs/styling#what-not-to-do",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of styling under the same key.",
"status": "proposed"
},
{
"kind": "topic",
"id": "theme",
"oldCliRoute": "astryx docs theme",
"oldDocsiteUrl": "/docs/theme",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Linked from getting-started, migration, styling and tokens, and its --dense and --zh overlays resolve by this route. The theme descriptors and the `theme` command docs are typed descriptors (generated bucket), so nothing authored would sit under a theme namespace.",
"status": "proposed"
},
{
"kind": "section",
"id": "theme#quick-start",
"oldCliRoute": "astryx docs theme quick-start",
"oldDocsiteUrl": "/docs/theme#wrap-your-app-in-a-theme",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of theme under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "theme#available-themes",
"oldCliRoute": "astryx docs theme available-themes",
"oldDocsiteUrl": "/docs/theme#available-themes",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of theme under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "theme#migrating-earlier-theme-copies",
"oldCliRoute": "astryx docs theme migrating-earlier-theme-copies",
"oldDocsiteUrl": "/docs/theme#migrating-earlier-theme-copies",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of theme under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "theme#theme-props",
"oldCliRoute": "astryx docs theme theme-props",
"oldDocsiteUrl": "/docs/theme#theme-props",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of theme under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "theme#integration-themes",
"oldCliRoute": "astryx docs theme integration-themes",
"oldDocsiteUrl": "/docs/theme#using-a-theme-from-an-integration",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of theme, under a shorter key (was `using-a-theme-from-an-integration`).",
"status": "proposed"
},
{
"kind": "section",
"id": "theme#creating-a-custom-theme",
"oldCliRoute": "astryx docs theme creating-a-custom-theme",
"oldDocsiteUrl": "/docs/theme#custom-themes",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of theme under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "theme#definetheme",
"oldCliRoute": "astryx docs theme definetheme",
"oldDocsiteUrl": "/docs/theme#definetheme",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of theme under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "theme#extending-a-theme",
"oldCliRoute": "astryx docs theme extending-a-theme",
"oldDocsiteUrl": "/docs/theme#extending-a-theme",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of theme under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "theme#theme-adaptations",
"oldCliRoute": "astryx docs theme theme-adaptations",
"oldDocsiteUrl": "/docs/theme#theme-adaptations",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of theme under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "theme#adaptation-rules",
"oldCliRoute": "astryx docs theme adaptation-rules",
"oldDocsiteUrl": "/docs/theme#adaptation-order-and-validation",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of theme: split out of Theme Adaptations (rule order and validation).",
"status": "proposed"
},
{
"kind": "section",
"id": "theme#component-style-overrides",
"oldCliRoute": "astryx docs theme component-style-overrides",
"oldDocsiteUrl": "/docs/theme#component-style-overrides",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of theme under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "theme#custom-variants",
"oldCliRoute": "astryx docs theme custom-variants",
"oldDocsiteUrl": "/docs/theme#custom-variants",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of theme under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "theme#building-themes-for-production",
"oldCliRoute": "astryx docs theme building-themes-for-production",
"oldDocsiteUrl": "/docs/theme#build-a-theme",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of theme under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "theme#icon-registry",
"oldCliRoute": "astryx docs theme icon-registry",
"oldDocsiteUrl": "/docs/theme#built-themes-with-an-icon-registry",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of theme: split out of Building Themes for Production (the icon registry sidecar).",
"status": "proposed"
},
{
"kind": "section",
"id": "theme#building-a-theme-family",
"oldCliRoute": "astryx docs theme building-a-theme-family",
"oldDocsiteUrl": "/docs/theme#building-a-theme-family",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of theme under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "theme#runtime-vs-built-themes",
"oldCliRoute": "astryx docs theme runtime-vs-built-themes",
"oldDocsiteUrl": "/docs/theme#runtime-vs-built-themes",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of theme under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "theme#light-dark-mode",
"oldCliRoute": "astryx docs theme light-dark-mode",
"oldDocsiteUrl": "/docs/theme#dark-mode",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of theme under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "theme#nesting-themes",
"oldCliRoute": "astryx docs theme nesting-themes",
"oldDocsiteUrl": "/docs/theme#nested-themes",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of theme under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "theme#token-utilities",
"oldCliRoute": "astryx docs theme token-utilities",
"oldDocsiteUrl": "/docs/theme#token-utilities",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of theme under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "theme#usetheme-hook",
"oldCliRoute": "astryx docs theme usetheme-hook",
"oldDocsiteUrl": "/docs/theme#usetheme-hook",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of theme under the same key.",
"status": "proposed"
},
{
"kind": "topic",
"id": "tokens",
"oldCliRoute": "astryx docs tokens",
"oldDocsiteUrl": "/docs/tokens",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Complete token reference. The six token-category pages pull their tables from it by token reference, which is a reference, not containment: each keeps its own route.",
"status": "proposed"
},
{
"kind": "section",
"id": "tokens#color-tokens",
"oldCliRoute": "astryx docs tokens color-tokens",
"oldDocsiteUrl": "/docs/tokens#color-tokens",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of tokens under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "tokens#data-visualization-tokens",
"oldCliRoute": "astryx docs tokens data-visualization-tokens",
"oldDocsiteUrl": "/docs/tokens#data-visualization-tokens",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of tokens: the data visualization token group, which the token docs generator now emits.",
"status": "proposed"
},
{
"kind": "section",
"id": "tokens#syntax-tokens",
"oldCliRoute": "astryx docs tokens syntax-tokens",
"oldDocsiteUrl": "/docs/tokens#syntax-tokens",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of tokens: the syntax token group, which the token docs generator now emits.",
"status": "proposed"
},
{
"kind": "section",
"id": "tokens#spacing-tokens",
"oldCliRoute": "astryx docs tokens spacing-tokens",
"oldDocsiteUrl": "/docs/tokens#spacing-tokens",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of tokens under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "tokens#size-tokens",
"oldCliRoute": "astryx docs tokens size-tokens",
"oldDocsiteUrl": "/docs/tokens#size-tokens",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of tokens under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "tokens#border-tokens",
"oldCliRoute": "astryx docs tokens border-tokens",
"oldDocsiteUrl": "/docs/tokens#border-tokens",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of tokens under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "tokens#focus-tokens",
"oldCliRoute": "astryx docs tokens focus-tokens",
"oldDocsiteUrl": "/docs/tokens#focus-tokens",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of tokens under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "tokens#radius-tokens",
"oldCliRoute": "astryx docs tokens radius-tokens",
"oldDocsiteUrl": "/docs/tokens#radius-tokens",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of tokens under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "tokens#shadow-tokens",
"oldCliRoute": "astryx docs tokens shadow-tokens",
"oldDocsiteUrl": "/docs/tokens#shadow-tokens",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of tokens under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "tokens#duration-tokens",
"oldCliRoute": "astryx docs tokens duration-tokens",
"oldDocsiteUrl": "/docs/tokens#duration-tokens",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of tokens under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "tokens#easing-tokens",
"oldCliRoute": "astryx docs tokens easing-tokens",
"oldDocsiteUrl": "/docs/tokens#easing-tokens",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of tokens under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "tokens#font-family-tokens",
"oldCliRoute": "astryx docs tokens font-family-tokens",
"oldDocsiteUrl": "/docs/tokens#font-family-tokens",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of tokens under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "tokens#font-size-tokens",
"oldCliRoute": "astryx docs tokens font-size-tokens",
"oldDocsiteUrl": "/docs/tokens#font-size-tokens",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of tokens under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "tokens#font-weight-tokens",
"oldCliRoute": "astryx docs tokens font-weight-tokens",
"oldDocsiteUrl": "/docs/tokens#font-weight-tokens",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of tokens under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "tokens#type-scale-tokens",
"oldCliRoute": "astryx docs tokens type-scale-tokens",
"oldDocsiteUrl": "/docs/tokens#type-scale-tokens",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of tokens under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "tokens#usage-in-stylex",
"oldCliRoute": "astryx docs tokens usage-in-stylex",
"oldDocsiteUrl": "/docs/tokens#usage-in-stylex",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of tokens under the same key.",
"status": "proposed"
},
{
"kind": "topic",
"id": "typography",
"oldCliRoute": "astryx docs typography",
"oldDocsiteUrl": "/docs/typography",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Token-category page (tokenCategory 'typography') whose tables come from `tokens` through token references. Only the docsite's 'foundations' category label groups it with the other token pages, and a label alone is not evidence for a route segment.",
"status": "proposed"
},
{
"kind": "section",
"id": "typography#overview",
"oldCliRoute": "astryx docs typography overview",
"oldDocsiteUrl": "/docs/typography#overview",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of typography under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "typography#font-families",
"oldCliRoute": "astryx docs typography font-families",
"oldDocsiteUrl": "/docs/typography#font-families",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of typography under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "typography#loading-custom-fonts",
"oldCliRoute": "astryx docs typography loading-custom-fonts",
"oldDocsiteUrl": "/docs/typography#custom-fonts",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of typography under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "typography#font-sizes",
"oldCliRoute": "astryx docs typography font-sizes",
"oldDocsiteUrl": "/docs/typography#font-sizes",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of typography under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "typography#font-weights",
"oldCliRoute": "astryx docs typography font-weights",
"oldDocsiteUrl": "/docs/typography#font-weights",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of typography under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "typography#line-height",
"oldCliRoute": "astryx docs typography line-height",
"oldDocsiteUrl": "/docs/typography#line-height",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of typography under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "typography#type-scale",
"oldCliRoute": "astryx docs typography type-scale",
"oldDocsiteUrl": "/docs/typography#type-scale",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of typography under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "typography#display-text",
"oldCliRoute": "astryx docs typography display-text",
"oldDocsiteUrl": "/docs/typography#display-text",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of typography under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "typography#usage",
"oldCliRoute": "astryx docs typography usage",
"oldDocsiteUrl": "/docs/typography#headings-and-text",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of typography under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "typography#custom-type-scale",
"oldCliRoute": "astryx docs typography custom-type-scale",
"oldDocsiteUrl": "/docs/typography#custom-type-scale",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of typography: split out of Usage (the defineTheme type scale).",
"status": "proposed"
},
{
"kind": "section",
"id": "typography#best-practices",
"oldCliRoute": "astryx docs typography best-practices",
"oldDocsiteUrl": "/docs/typography#best-practices",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of typography under the same key.",
"status": "proposed"
},
{
"kind": "topic",
"id": "working-with-ai",
"oldCliRoute": "astryx docs working-with-ai",
"oldDocsiteUrl": "/docs/working-with-ai",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Setup guide for AI coding tools (agent files, the hosted MCP server). It covers the reader's tooling, none of its sections is a CLI command's doc, and nothing places it under cli.",
"status": "proposed"
},
{
"kind": "section",
"id": "working-with-ai#overview",
"oldCliRoute": "astryx docs working-with-ai overview",
"oldDocsiteUrl": "/docs/working-with-ai#overview",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of working-with-ai under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "working-with-ai#quick-start",
"oldCliRoute": "astryx docs working-with-ai quick-start",
"oldDocsiteUrl": "/docs/working-with-ai#set-up-agent-docs",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of working-with-ai under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "working-with-ai#what-gets-generated",
"oldCliRoute": "astryx docs working-with-ai what-gets-generated",
"oldDocsiteUrl": "/docs/working-with-ai#what-gets-generated",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of working-with-ai under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "working-with-ai#cursor-setup",
"oldCliRoute": "astryx docs working-with-ai cursor-setup",
"oldDocsiteUrl": "/docs/working-with-ai#cursor-setup",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of working-with-ai under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "working-with-ai#checking-your-setup",
"oldCliRoute": "astryx docs working-with-ai checking-your-setup",
"oldDocsiteUrl": "/docs/working-with-ai#checking-your-setup",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of working-with-ai under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "working-with-ai#the-astryx-pattern",
"oldCliRoute": "astryx docs working-with-ai the-astryx-pattern",
"oldDocsiteUrl": "/docs/working-with-ai#the-astryx-pattern",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of working-with-ai under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "working-with-ai#the-dense-flag",
"oldCliRoute": "astryx docs working-with-ai the-dense-flag",
"oldDocsiteUrl": "/docs/working-with-ai#shorter-output-detail-and-dense",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of working-with-ai under the same key.",
"status": "proposed"
},
{
"kind": "section",
"id": "working-with-ai#mcp-server",
"oldCliRoute": "astryx docs working-with-ai mcp-server",
"oldDocsiteUrl": "/docs/working-with-ai#mcp-server",
"placement": "keep-flat",
"aliasNeeded": false,
"rationale": "Stays a section of working-with-ai under the same key.",
"status": "proposed"
},
{
"kind": "component",
"id": "@astryxdesign/core/component",
"provider": "@astryxdesign/core",
"count": 179,
"oldCliRoute": "astryx component <id>",
"oldDocsiteUrl": "/components/<id>",
"docsiteExceptions": {
"Chat": "No page: a family doc with no props of its own; its members have pages.",
"Indicator": "No page: a family doc with no props of its own; its members have pages.",
"Layer": "No page: a family doc with no props of its own; its members have pages.",
"NavMenu": "No page under this id: the doc declares the name NavHeadingMenu, and the page is /components/NavHeadingMenu.",
"Resizable": "No page: a family doc with no props of its own; its members have pages."
},
"placement": "generated:@astryxdesign/core/component",
"aliasNeeded": false,
"evidence": "No component doc authors a docs-graph placement.",
"rationale": "Unplaced typed descriptors go to their provider's generated bucket, not a guessed hierarchy; group and category fields are labels. The ids include the 10 core docs that `component <Name>` reads but `component --list` omits. No alias: `astryx component <id>` and /components/<id> are not docs-graph routes, and nothing here moves them.",
"status": "proposed"
},
{
"kind": "component-member",
"id": "@astryxdesign/core/component-member",
"provider": "@astryxdesign/core",
"count": 10,
"oldCliRoute": "astryx component <id>",
"oldDocsiteUrl": "/components/<id>",
"placement": "generated:@astryxdesign/core/component",
"aliasNeeded": true,
"evidence": "No doc of its own: `component <id>` resolves into another component doc, as a member of its components list or as the name the doc declares (NavMenu declares NavHeadingMenu).",
"rationale": "Neither `component --list` nor the compiler inputs list these names, yet each reads by name and has its own docsite page. The docs graph keeps one identity per doc file, so each name needs an alias to its parent doc.",
"status": "proposed"
},
{
"kind": "hook",
"id": "@astryxdesign/core/hook",
"provider": "@astryxdesign/core",
"count": 56,
"oldCliRoute": "astryx hook <id>",
"oldDocsiteUrl": "/components/<id>",
"placement": "generated:@astryxdesign/core/hook",
"aliasNeeded": false,
"evidence": "No hook doc authors a docs-graph placement.",
"rationale": "Unplaced typed descriptors go to their provider's generated bucket. The docsite serves hooks under /components/, next to components. No alias: neither route is a docs-graph route.",
"status": "proposed"
},
{
"kind": "page",
"id": "@astryxdesign/core/page",
"provider": "@astryxdesign/core",
"count": 55,
"oldCliRoute": "astryx template <id> --type page",
"oldDocsiteUrl": "/templates?preview=<id>",
"docsiteExceptions": {
"blank": "No docsite route: the docsite skips scaffold templates.",
"incident-console": "Not ready: /templates/<id> redirects to the gallery, which drops the preview without a message.",
"login": "Hidden from the overview: /templates/<id> redirects to the gallery, which drops the preview without a message.",
"messaging-shell": "Not ready: /templates/<id> redirects to the gallery, which drops the preview without a message.",
"table": "Hidden and not ready: /templates/<id> redirects to the gallery, which drops the preview without a message.",
"theme-showcase": "Hidden from the overview: /templates/<id> redirects to the gallery, which drops the preview without a message."
},
"placement": "generated:@astryxdesign/core/page",
"aliasNeeded": false,
"evidence": "No template doc authors a docs-graph placement; its category (for example 'Dashboard - Analytics') is a label.",
"rationale": "Unplaced typed descriptors go to their provider's generated bucket. Discovery reports built-in templates as @astryxdesign/core (the `template --list` package field) although the files ship in @astryxdesign/cli, and the provider follows discovery. /templates/<id> redirects to this canonical preview URL.",
"status": "proposed"
},
{
"kind": "block",
"id": "@astryxdesign/core/block",
"provider": "@astryxdesign/core",
"count": 669,
"oldCliRoute": "astryx template <id> --type block",
"oldDocsiteUrl": null,
"placement": "generated:@astryxdesign/core/block",
"aliasNeeded": false,
"evidence": "No block doc authors a docs-graph placement; its directory and category are not placements.",
"rationale": "Unplaced typed descriptors go to their provider's generated bucket. The docsite renders blocks inside component pages as showcases and examples; no block has a URL of its own. Provider follows discovery, as for pages.",
"status": "proposed"
},
{
"kind": "theme",
"id": "@astryxdesign/theme-butter/theme",
"provider": "@astryxdesign/theme-butter",
"count": 1,
"oldCliRoute": "astryx theme add <id>",
"oldDocsiteUrl": "/themes?theme=<id>",
"placement": "generated:@astryxdesign/theme-butter/theme",
"aliasNeeded": false,
"evidence": "The theme descriptor authors no docs-graph placement.",
"rationale": "Unplaced typed descriptors go to their provider's generated bucket. Discovery reports the installable theme package as the provider; `astryx theme list` reads every descriptor, and `theme add <id>` takes the slug.",
"status": "proposed"
},
{
"kind": "theme",
"id": "@astryxdesign/theme-chocolate/theme",
"provider": "@astryxdesign/theme-chocolate",
"count": 1,
"oldCliRoute": "astryx theme add <id>",
"oldDocsiteUrl": "/themes?theme=<id>",
"docsiteExceptions": {
"chocolate": "Not a docsite dependency: /themes?theme=chocolate shows Neutral without a message."
},
"placement": "generated:@astryxdesign/theme-chocolate/theme",
"aliasNeeded": false,
"evidence": "The theme descriptor authors no docs-graph placement.",
"rationale": "Unplaced typed descriptors go to their provider's generated bucket. Discovery reports the installable theme package as the provider; `astryx theme list` reads every descriptor, and `theme add <id>` takes the slug.",
"status": "proposed"
},
{
"kind": "theme",
"id": "@astryxdesign/theme-gothic/theme",
"provider": "@astryxdesign/theme-gothic",
"count": 1,
"oldCliRoute": "astryx theme add <id>",
"oldDocsiteUrl": "/themes?theme=<id>",
"placement": "generated:@astryxdesign/theme-gothic/theme",
"aliasNeeded": false,
"evidence": "The theme descriptor authors no docs-graph placement.",
"rationale": "Unplaced typed descriptors go to their provider's generated bucket. Discovery reports the installable theme package as the provider; `astryx theme list` reads every descriptor, and `theme add <id>` takes the slug.",
"status": "proposed"
},
{
"kind": "theme",
"id": "@astryxdesign/theme-matcha/theme",
"provider": "@astryxdesign/theme-matcha",
"count": 1,
"oldCliRoute": "astryx theme add <id>",
"oldDocsiteUrl": "/themes?theme=<id>",
"placement": "generated:@astryxdesign/theme-matcha/theme",
"aliasNeeded": false,
"evidence": "The theme descriptor authors no docs-graph placement.",
"rationale": "Unplaced typed descriptors go to their provider's generated bucket. Discovery reports the installable theme package as the provider; `astryx theme list` reads every descriptor, and `theme add <id>` takes the slug.",
"status": "proposed"
},
{
"kind": "theme",
"id": "@astryxdesign/theme-neutral/theme",
"provider": "@astryxdesign/theme-neutral",
"count": 1,
"oldCliRoute": "astryx theme add <id>",
"oldDocsiteUrl": "/themes?theme=<id>",
"placement": "generated:@astryxdesign/theme-neutral/theme",
"aliasNeeded": false,
"evidence": "The theme descriptor authors no docs-graph placement.",
"rationale": "Unplaced typed descriptors go to their provider's generated bucket. Discovery reports the installable theme package as the provider; `astryx theme list` reads every descriptor, and `theme add <id>` takes the slug.",
"status": "proposed"
},
{
"kind": "theme",
"id": "@astryxdesign/theme-stone/theme",
"provider": "@astryxdesign/theme-stone",
"count": 1,
"oldCliRoute": "astryx theme add <id>",
"oldDocsiteUrl": "/themes?theme=<id>",
"placement": "generated:@astryxdesign/theme-stone/theme",
"aliasNeeded": false,
"evidence": "The theme descriptor authors no docs-graph placement.",
"rationale": "Unplaced typed descriptors go to their provider's generated bucket. Discovery reports the installable theme package as the provider; `astryx theme list` reads every descriptor, and `theme add <id>` takes the slug.",
"status": "proposed"
},
{
"kind": "theme",
"id": "@astryxdesign/theme-y2k/theme",
"provider": "@astryxdesign/theme-y2k",
"count": 1,
"oldCliRoute": "astryx theme add <id>",
"oldDocsiteUrl": "/themes?theme=<id>",
"placement": "generated:@astryxdesign/theme-y2k/theme",
"aliasNeeded": false,
"evidence": "The theme descriptor authors no docs-graph placement.",
"rationale": "Unplaced typed descriptors go to their provider's generated bucket. Discovery reports the installable theme package as the provider; `astryx theme list` reads every descriptor, and `theme add <id>` takes the slug.",
"status": "proposed"
},
{
"kind": "command",
"id": "@astryxdesign/cli/command",
"provider": "@astryxdesign/cli",
"count": 34,
"oldCliRoute": "astryx <id> --help",
"oldDocsiteUrl": null,
"placement": "namespace:cli/commands",
"aliasNeeded": false,
"evidence": "Every command doc declares namespace cli/commands, which the commands namespace adopts.",
"rationale": "Each CommandDoc builds its command's --help, and is read as the leaf cli/commands/<name> of the docs tree.",
"status": "proposed"
},
{
"kind": "function",
"id": "@astryxdesign/cli/function",
"provider": "@astryxdesign/cli",
"count": 41,
"oldCliRoute": null,
"oldDocsiteUrl": null,
"placement": "namespace:cli/api/functions",
"aliasNeeded": false,
"evidence": "Every function doc declares namespace cli/api, which the api namespace adopts by kind.",
"rationale": "API reference for @astryxdesign/cli/api, read as the leaf cli/api/functions/<name> of the docs tree.",
"status": "proposed"
},
{
"kind": "schema",
"id": "@astryxdesign/cli/schema",
"provider": "@astryxdesign/cli",
"count": 18,
"oldCliRoute": null,
"oldDocsiteUrl": null,
"placement": "generated:@astryxdesign/cli/schema",
"aliasNeeded": false,
"evidence": "No schema doc authors a placement; output declares cli/api and the other 17 declare authoring.",
"rationale": "17 declare namespace 'authoring' and are read as sections of `astryx docs authoring`; `output` declares cli/api and is read as the leaf cli/api/schemas/output. Their home in the tree for authoring is a later phase.",
"status": "proposed"
},
{
"kind": "enum",
"id": "@astryxdesign/cli/enum",
"provider": "@astryxdesign/cli",
"count": 2,
"oldCliRoute": null,
"oldDocsiteUrl": null,
"placement": "namespace:cli/api/enums",
"aliasNeeded": false,
"evidence": "Both enum docs declare namespace cli/api, which the api namespace adopts by kind.",
"rationale": "Error codes and response types, read as the leaves cli/api/enums/error-codes and cli/api/enums/response-types.",
"status": "proposed"
}
]
}