# @pagesmith/docs Changelog Notes

## Unreleased

- Home page `install` frontmatter now accepts an object (`{ code, lang?, title?, frame?, showLineNumbers? }`) in addition to the existing single-line string. The snippet is rendered through the same Pagesmith markdown code pipeline as `\`\`\`<lang>` blocks, so multi-line scripts, arbitrary languages, and any of the standard frame styles (`code`, `terminal`, `plain`) all work and look identical to fenced code blocks elsewhere on the site. Existing string `install`values continue to render as a`bash` terminal block.
- Added `server.logLevel` (default `'info'`) so dev and preview server log levels can be set in `pagesmith.config.json5`. The CLI `--log-level` flag continues to override this value at startup, and now also defaults to `info` instead of `warn`.
- `server.devPort` and `server.previewPort` now also accept the literal `'auto'`, which scans upward from `4000` for the first available port at server startup. The CLI `--port` flag accepts the same value (`--port auto`); a numeric `--port` forces `strictPort` for that run, while `--port auto` always scans. Defaults remain `3000` for dev and `4000` for preview.
- Added a dedicated `skills/setup-docs.md` bootstrap/retrofit prompt for AI agents working in existing repositories.
- Added version-matched JSON schemas under `schemas/` for `pagesmith.config.json5`, `meta.json5`, and docs frontmatter, plus hosted copies on the docs site.
- `pagesmith-docs init` now writes a config `$schema` pointer to the installed docs package schema and safely backfills missing scaffold fields when rerun against an existing config file.
- Footer links now support either a flat link grid or grouped columns with optional headers. On wide screens the footer uses up to 4 evenly spaced columns, prev/next navigation now renders between page metadata and the footer link area, and footer links still fall back to the major top-level nav links when `footerLinks` is omitted.
- The `DocHome` layout now uses the same main content-column width and inline padding as `DocPage`, so the home page and content pages stay visually aligned as sidebars appear or disappear.
- Added `copyright` config for footer legal lines, with `pagesmith-docs init` seeding `startYear` from the first git commit year when available and leaving `endYear: null` for build/browser-time year updates.
- Default footer attribution now links to Pagesmith, can append a maintainer credit from `maintainer` or `package.json` author, and `footerText` now overrides only that sign-off segment inside the footer legal line.
- `editLink` now auto-detects from supported git remotes unless set to `false`.
- `lastUpdated` now defaults to `true`.
- Default prev/next navigation remains enabled on all non-home docs pages.

## v0.3.0

- Documentation restructured for AI/Agent-first approach
- AI setup guide moved to Getting Started series
- New pages: Agent Prompts Cookbook, MCP Server Setup
- Framework guides consolidated (React/Solid/Svelte → one page, EJS/Handlebars → one page)
- Search guide merged into docs-getting-started
- All getting-started pages now lead with agent prompt blocks
- Import map table added to core getting-started guide
- CLI port configuration support added
- Added stable `@pagesmith/docs/theme` export for theme/runtime integration
- Refactored docs config into dedicated modules (`config/types`, `config/resolve`, `config/validate`, `config/shared`)
- Refactored CLI arg parsing and server shared runtime helpers into focused modules
- Added docs MCP server package export and runtime tests for build/render/server/mcp paths
- Example app scripts now use `vite` directly for dev/build consistency
- Added `skills/migration.md` with pre-1.0 upgrade guidance