Skip to content

Creator Console

apps/editor/ in the platform repo — a React app deployed at https://console.freedocstore.online/. It is the signed-in surface for creating and maintaining knowledge bases, built against the API worker. It is an installable PWA (auto-updating service worker, standalone display).

The console follows the platform's editing rule: there is no Markdown body editor anywhere. Every content change is a prompt that becomes a reviewable proposal.

Pages

Dashboard

The workspace home: lists your KB drafts, shows the active KB's status (repo URL, live URL, custom domain, generated files), and offers quick actions. Workspace state is stored per user through the API worker's KV endpoints (fds:kbs:v1, fds:active-kb:v1, fds:config:v1), which is the same state the MCP workspace_summary tool reads.

Publish

The new-KB workflow. You provide title, slug, owner org, optional custom domain, visibility, and a prompt describing what the KB should cover. The console tracks the publish pipeline as explicit steps:

  1. Create Zensical structure
  2. Generate Markdown files
  3. Create GitHub repository
  4. Commit Zensical source
  5. Use stored Cloudflare deploy connection
  6. GitHub Actions publishes to Cloudflare

Edit

The AI-first editing surface, scoped to one KB via a refreshable URL: /edit/<kb-id>/<file> (pick a KB from the dashboard Library; refreshing restores the same KB + file and auto-loads it). Describe the change (⌘/Ctrl+Enter runs Ask AI) and the console produces a proposal — a diff — rather than an editable text body.

The preview panel:

  • Diff — a colored line diff (green additions / red deletions) with a +N −N header
  • Proposal / Source — with a Raw / Rendered toggle (formatted Markdown)
  • Live — the published page, embedded
  • Quote selection — select text in the preview to drop it into the change request as a > quote

The status strip shows the active AI provider · model and the last call's token usage.

Applying is one click as the signed-in user, with a persistent mode: Reviewed PR opens a pull request (default), or Direct commit writes straight to the base branch. Merge/commit → GitHub Actions rebuilds and redeploys.

AI provider — free by default, BYOK to continue

The default provider is GitHub Models (free) — it runs on your GitHub sign-in, no key needed. Hit its rate limit and the console prompts you to add your own OpenAI or Anthropic key in Profile → API keys (BYOK), then uses it. Saving a key switches the provider to it; if a selected provider has no key, the console auto-picks a usable one (a key you have, else the free tier).

Profile

Account settings: API keys (BYOK OpenAI/Anthropic, encrypted), platform connections, theme, billing status (free), PWA install, sign-out, and account deletion.

Sign-in

GitHub or Google OAuth via the API worker, backed by the FreeDocStore GitHub App (fine-grained, per-repo access — see the platform's GITHUB-APP-MIGRATION.md). GitHub sign-in enables repo reads/writes and the free GitHub Models AI tier through the authenticated proxy.

Development

cd apps/editor
npm install
npm run dev     # Vite dev server on :5173, talks to api.freedocstore.online

Deployment is a Cloudflare Pages project (console.freedocstore.online). Platform connection details (API base URL, OAuth callbacks, org-level Cloudflare secrets) are documented in apps/editor/PLATFORM-CONNECTIONS.md in the platform repo.