Document the unified refrakt.config.json at site/content/docs/configuration/. Cover the three valid shapes (flat / singular site / plural sites), each section (plugins, plan, site/sites), the multi-site workflow, and the migration story for existing flat-shape configs.
Tracking started May 1 — check back for trends.
site/content/docs/configuration/ directory with at least these pages:overview.md — what refrakt.config.json is, when to create one, the optional-by-default principleplugins.md — declaring plugins, the difference between plugins and site.packages, fallback to dependency scanningplan.md — plan.dir and interaction with plan initsites.md — single-site (site) vs multi-site (sites), the --site flag, picking sites in vite.config.tsmigration.md — moving from flat shape to nested, using refrakt config migrateschema.md — pointer to the JSON Schema, editor setupsite/content/docs/ content that mentions refrakt.config.json audited and updated to reflect the new shape (or noted as transitional)Read existing docs structure under site/content/docs/ to match conventions for page-level frontmatter and cross-referencing.
Audit existing pages with grep -r 'refrakt.config' site/content/docs/ to find every snippet that needs updating.
Write new pages from the most-used to the least-used: overview → sites → plugins → plan → migration → schema.
Confirm the docs build cleanly with cd site && npm run build.
site/content/docs/ — existing docs structure to mirror