Skip to content
This repository was archived by the owner on May 9, 2026. It is now read-only.

ROADMAP.md

Latest commit

 

History

History
44 lines (30 loc) · 3.47 KB

ROADMAP.md

File metadata and controls

44 lines (30 loc) · 3.47 KB
Raw

clear — roadmap

What's recently shipped and what's coming. For per-package details, see each package's CHANGELOG.md. For protocol-level decisions, see docs/adr/. For "what's true right now," see STATE.md.

Recently shipped (v0.2.x)

  • Schema-first editor (ADR-0020) — Pages and items are edited via a form generated from a JSON schema. TipTap is one widget (widget: "richtext"), not the canvas. Two modes: form (default) and article (full-canvas TipTap, opt-in for long-form prose).
  • Page-scoped data (ADR-0010 v1) — content/pages/<slug>/data.json sibling stores per-page structured fields. cms.pages.get(slug).data reads it across all 4 SDK backends.
  • Pages preview — admin's preview button works on pages, not just collection items.
  • Single CLI (ADR-0018) — clear-admin is the one binary. The old clearctl is removed. Per-project ops live in clear-admin (bootstrap, migrate, import, reindex, sync-pages, scaffold, doctor, config, start).
  • Doctor + per-project config — clear-admin doctor runs 10+ health checks. clear.config.json (env > file > defaults) lives next to each project's bucket+db.
  • Adopter pain killed — every issue filed against v0.1.x is fixed: CLEAR_SKIP_SAMPLE_SEEDS, full env-var documentation in --help, --port/--host flags, fs watch in @clearcms/astro, renderTipTap() helper, scaffolder ships a working /preview route, navigation editor default-on, schema editor default-on.

See package CHANGELOG.md files for the full list.

What's next (themes, not dates)

  • CLI parity — every action that the admin UI can do, clear-admin can do too. Operators can manage settings, users, invites, content from a terminal at 3am without opening a browser.
  • Form-layout polish — explicit row containers, top-level tabs, collapsible field groups for richer schemas.
  • Nav groups — kind: "group" items in content/globals/nav.json for mega-menu / dropdown navs.
  • Backups — clear-admin backup / restore for one-shot tarballs of bucket + db with manifest.
  • fs → R2 migration (ADR-0017) — adopters who started on local filesystem can migrate to R2 without re-bootstrapping.
  • Hosting topology (ADR-0013) — Fly.io + Cloudflare Workers paths for the SaaS deployment.

What's deferred

  • Block-as-files (ADR-0007) — pages-as-folders + block instances. Targeting v1.0 protocol revision; v0.x stays flat.
  • Locale-aware schemas — single schema per collection / layout for now.
  • JWT identity bridge (ADR-0004) — until first paying customer.
  • Multi-tenant / public hosting of the operator console — single-operator scope through v1.

How releases happen

@clearcms/* packages release via Changesets on merges to main. Every PR with a user-facing change includes a .changeset/*.md describing the bump. Releases ship to npm with OIDC provenance (ADR-0014).

How to contribute

Operator-internal (not for adopters)

The operator's day-to-day planning, in-flight prompts, and cross-repo coordination live in a private repo (clearcms/planning). This roadmap is the public-safe surface; full internal scheduling is out of scope here.