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 for existing KBs. A Library picker (fed by the public registry) selects any published knowledge base and prefills its repo, branch, and starting path; you can also enter any repo/path directly. Describe the change and the console produces a proposal (diff) rather than an editable text body. Accepted proposals land in GitHub as commits/PRs.

The preview panel has four tabs:

  • Diff — line diff between the loaded source and the AI proposal
  • Proposal — the proposed replacement content
  • Source — the current file content from GitHub
  • Live — the published page for the file being edited, embedded from the KB's production URL

Profile

Account settings: platform connections (the OpenAI BYOK key stored through /api/secrets/openai), billing status (free), sign-out, and account deletion.

Sign-in

GitHub or Google OAuth via the API worker. GitHub sign-in also enables GitHub API calls 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.