@reeka/minisite-cms

Ghost-style inline CMS overlay for Reeka host mini-sites and agent listing sites.

Usage

npm i @reeka/minisite-cms

import "@reeka/minisite-cms/style.css";
import { installSiteCms } from "@reeka/minisite-cms";

void installSiteCms({ apiBase: "https://api.example.com" });

Behavior

• Mounts only when ?cms=<jwt> is present (or a prior sessionStorage session).
• Guests never pay for the editor UI when this returns early.
• Publishes via str-backend (PUT /site-cms/content); never talks to GitHub.
• Selection toolbar: Bold / Italic / Underline (stored as **text** / *text* / __text__), plus image (![alt](url)) and video ([[video:url|poster]]) markers. External video accepts any https URL (YouTube/Vimeo get native embeds when recognized; other hosts iframe the URL; .mp4/.webm use <video>).
• Page jump menu in the edit bar (auto-discovers nav links + known content pages; optional pages / navigate in installSiteCms).
• Guest pages should render with cmsInlineToHtml() (exported) instead of raw {{ }} so formatting shows.
• Optional list editors (toggle via installSiteCms({ features }); blog defaults off):
  • features.heroImages (default true) + data-cms-list="hero.imageUrls" → Hero images panel
  • features.gallery (default true) + data-cms-list="gallery.sections" → Gallery panel
  • features.blog (default false) + data-cms-list="blog.posts" → Posts panel — sites that ship /blog must pass features: { blog: true }
  • features.popup (default true) → Popup panel
• Mark body fields with data-cms-rich so Image/Video insert when the caret is in the field.
• subscribeCmsDraft(cb) — host sites merge draft content over baked site.json for live preview while a CMS session is active.

Build

npm install
npm run build

License

Copyright (c) 2026 Reeka. All rights reserved. See LICENSE.