Skip to content

v2.1.0

Choose a tag to compare

@github-actions github-actions released this 04 Jul 06:41
fa99d61

SpecUI 2.1.0

This is the first release since the docs-and-CLI audit. It adds a complete Fumadocs-based docs site with search, TOC, breadcrumbs, and sitemap; AI/LLM-friendly endpoints for agents and crawlers (/llms.txt, /llms-full.txt, per-page /docs-md/<slug>); copy-paste agent prompts for installing SpecUI in existing or new apps; the SpecUI brand mark; a dogfooded brand/ design contract; and fixes six real CLI bugs found by running every documented command end-to-end.

Added

  • Docs site: search, table of contents, breadcrumbs, edit-on-GitHub footer, MDX components (Callout, Steps, Tabs, Accordions, Files), sitemap.xml, robots.txt, OpenGraph image, per-page canonical + OpenGraph/Twitter metadata.
  • AI/LLM-friendly docs: /llms.txt index, /llms-full.txt single-file ingest, per-page /docs-md/<slug> markdown, JSON-LD TechArticle, robots allow for GPTBot/ClaudeBot/PerplexityBot, alternate markdown link tags.
  • Agent prompts page: copy-paste prompts to install SpecUI with a coding agent (existing app + new app).
  • brand/: SpecUI's own design contract, dogfooded with the CLI.
  • SpecUI brand mark (assets/specui-logo.png) across docs site and README.
  • scripts/check-links.mjs — static link checker for built docs.

Changed

  • Docs home is a retro one-pager (no navbar, no cards or badges), with README and all wiki pages rewritten in a human voice.
  • Internal doc links now use /docs/<slug> paths (fixes broken relative links on the GitHub Pages site).
  • Registries doc: --platform example uses real values (react/vue/flutter) instead of web.
  • Agents & MCP doc: AGENTS.md refresh guidance no longer suggests the failing init path.

Fixed

  • --help on all subcommands exits 0 with help text instead of erroring.
  • validate on a missing target now exits 2 (CI-safe) instead of silently passing.
  • get accepts file:// registry items via --from, and gives a clean --force hint on duplicate installs.
  • add, validate, sync, and list now default to the flat layout when SPEC.md is at the repo root.
  • new . works in an empty existing directory.
  • skills templates lists every bundled template.
  • llms.txt now points at /docs-md/<slug> (not the wrong /docs/<slug>.md).
  • JSON-LD SoftwareApplication emitted as a real <script> tag (was rendering as a meta tag).
  • Per-page <title> matches OG/Twitter title (both use <page> · SpecUI).
  • robots.txt Host directive trimmed to host only (was including the /specui path).
  • Sitemap no longer duplicates the docs index URL; correct priority for the index page.
  • Unused imports removed from the site layout.
  • README doctor sample matches actual doctor output.
  • assets/specui-logo.png now shipped in the npm tarball so the relative logo renders on npmjs.com.