Changelog
A record of what has been added, changed, and improved in the ClearCMS documentation.
March 27, 2026 — Sprint 4: Correctness & Screenshots
Fixed
- 18 accuracy issues found by auditing docs against Core codebase:
- 5 critical: missing required flags on collection fields, missing avatar
srcfield in hero section - 13 minor: wrong field types (phone, url, color, icon), incorrect token names, missing spacing tokens
- 5 critical: missing required flags on collection fields, missing avatar
Added
- Troubleshooting page with 15 expandable FAQ items covering common issues (DNS, images, forms, API, accounts)
- "Was this helpful?" feedback widget on every doc page (Yes/No buttons, stores locally)
- Integrations placeholder page listing built-in and upcoming integrations
- Migrate from WordPress step-by-step migration guide
March 27, 2026 — Sprint 3
Added
- This changelog page
Updated
- Added Collections Reference and Templates to the guides hub page
- Added Section-Collection Matrix to the sections hub page
March 27, 2026 — Sprint 2: Polish & Simplify
A full pass over every page to simplify wording, enforce the two-audience split, and add UX polish.
Changed
- Getting started + guides (15 pages): Simplified language for non-technical users. Removed jargon (hex code, canvas, modal, JSON, endpoint). Shortened sentences to ~20 words max. Switched to active voice throughout.
- Developer docs (7 pages): Tightened prose while keeping technical precision. Standardized base URL to
your-site.clearcms.app. Added language tags to all code blocks. Consistent settings paths (Settings > Developer > API Keys). - Section docs (11 pages): Trimmed "When to use" and "Tips" sections. Removed generic advice. Kept only non-obvious, actionable tips.
- Audience split: Moved API references out of guide pages into
:::info For developerscallouts. Guide pages no longer mention REST, endpoints, JSON, or tokens in body text.
Added
- Table striping and hover highlighting (CSS)
- External link arrow indicators
- Sidebar group separators for section categories
- Dark mode fixes for tables and separators
Updated
- Roadmap: Moved Bridge Mode, API keys, Design Tokens API, content-only editing mode, and honeypot spam protection from "Coming Soon" to "Shipped"
- FAQ: Simplified answers, fixed broken anchor link
- Section components verified in sync with Core (no changes needed)
March 26–27, 2026 — Sprint 1: Content Expansion
Major content additions: new reference pages, interactive components, and expanded developer docs.
Added
- Collections Reference — All 36 collection types with fields, relationships, industry presets, and API access
- Section-Collection Matrix — Visual compatibility table showing which sections work with which collections
- Templates Guide — All 4 site templates and 6 page templates, how to choose and customize
- Interactive API Explorer — Live endpoint tester added to Headless API, Media API, and Forms API
- Interactive DNS Checker — Domain verification tool added to Custom Domains
Updated
- Design Tokens — Expanded with Simple vs Advanced mode, full token reference (spacing, radius, shadows, layout, typography), spacing and radius presets
- Converted headless-api, media-api, forms-api, and custom-domain pages from
.mdto.mdxfor component imports - Fixed broken links in developer and guides index pages
March 26, 2026 — Sprint 0: Initial Documentation Site
The docs site launched with Docusaurus 3, covering all ClearCMS features.
Added
Getting Started
- Editing Pages — How to add sections, edit content, and use the visual editor
- Managing Media — Uploading images, setting focal points, and organizing files
- Getting Started Wizard — Interactive guide to pick your first steps
Guides
- Blog — Writing posts, setting authors and tags, publishing
- Branding — Colors, fonts, logo, Simple vs Advanced mode
- SEO — Page titles, descriptions, social sharing, with interactive preview
- Custom Domains — Connecting your own domain with SSL
- Teams & Permissions — Roles, invitations, with interactive permissions matrix
- Forms — Building forms, managing responses, spam protection
- Content Types — Overview of 36 collection types
- Publishing & Versions — Draft workflow, version history, rollback
- Importing Content — Migrating from other platforms
Developer Docs
- Headless API — REST API reference with pagination, filtering, drafts
- Headless Quickstart — Next.js integration tutorial
- Bridge Mode — Visual editing overlay for custom frontends
- Media API — Upload, manage, presigned URLs, folders
- Forms API — Form CRUD, public submissions, webhooks
- Design Tokens — CSS/JSON/Tailwind token endpoints with interactive customizer
Sections (16 built-in)
- All section pages with live interactive demos, field tables, usage tips
- Sections Overview with interactive gallery browser
Other