🐰 KuroCMS
The Cloudflare-native, ultra-fast headless CMS — run a multilingual blog for ¥0.
🚀 Install ・ 📖 Read the story (EN) ・ 🏷️ Releases ・ 🔒 Security
KuroCMS admin · article management — multilingual, per‑article SNS publish state, and one‑click build.
KuroCMS is a lightweight headless CMS that runs entirely on the Cloudflare global
network (Workers + D1 + KV + R2). It pairs a polished admin with high‑performance
edge delivery — and is designed so a typical blog runs comfortably within
Cloudflare's free tier.
✨ Why KuroCMS
- 🚀 Cloudflare‑native & fast — Workers + D1 + KV + R2, edge‑cached static delivery.
- 💸 Runs for ¥0 — built around Cloudflare's free tier: no rental server, no DB ops.
- 🧩 PC‑free web installer — provisions D1 / KV / R2 / Worker into your Cloudflare account straight from the browser. No CLI, no build.
- 🌐 Multilingual by design — one shared article identity, per‑language static output, AI‑friendly translation API.
- ✍️ Rich WYSIWYG editor (KuroEditor) — callouts, round boxes, tables, media — with passkey (WebAuthn) sign‑in and multi‑device recovery.
- 🎨 Community templates — pick a shareable template and make it yours.
- 🤖 AI‑ready REST API + MCP server — clean JSON endpoints, plus a built‑in MCP (Model Context Protocol) server at
/api/mcp so Claude / Claude Code can create, update, publish, and build content conversationally (PAT‑authenticated, same permissions as REST).
- 🔑 Zero runtime dependencies — vanilla TypeScript on the Workers runtime.
🚀 Get started
KuroCMS installs into your own Cloudflare account from the browser — no PC setup, no CLI, no build:
Want the backstory and a feature tour? Read
“Finally Released! Development of a New Headless CMS Vol. 3” (English).
🛠️ Tech stack
- Runtime: Cloudflare Workers
- Database: Cloudflare D1
- Storage: Cloudflare KV (rendered pages) + R2 (media)
- Language: TypeScript — no framework, zero runtime dependencies
📦 About this repository
This repository publishes the core source code of KuroCMS for transparency — so
anyone (especially the security‑minded) can review what the software actually does.
You don't build or deploy from here — installation is the one‑click web installer
above.
| Path | Contents |
|---|
src/ | Cloudflare Worker source (the CMS itself) |
migrations/ | D1 database schema migrations |
Release history — versions, change notes, and the built worker.js — lives on the
Releases page. Build tooling,
configuration, and maintainer scripts are intentionally omitted (source‑review mirror,
not a build target).
🔄 Self-update & release channels
The admin Dashboard checks for updates and applies them with one click — no CLI,
no build. Releases publish frequently (often several a day), so installs choose
one of two channels:
| Channel | Tracks | Moves forward |
|---|
| Stable (default) | The newest release not marked Pre-release on GitHub | Only when the maintainer explicitly promotes a release — so a same-day regression doesn't reach every install automatically |
| Latest | Every release, including Pre-release-tagged ones | Immediately, on every release |
Flip “Always update to latest” in Dashboard → KuroCMS to switch to the Latest
channel; leave it off to stay on Stable. Both the installed, stable, and latest
version numbers are shown on the same card.
🔒 Security
Found a vulnerability? Please see SECURITY.md for private reporting
instructions. Do not file public issues for security problems.
⚖️ License
KuroCMS is licensed under the Kuro License (an MIT‑based license with an
attribution requirement).
When the Software is used to provide a public‑facing interface, the phrase
“with KuroCMS” must be shown in an appropriate attribution area.
See LICENSE.txt for the full text.
The Kuro License covers the source code in this repository. The release builds
(worker.js on GitHub Releases) also contain components of the Entamy platform
(the entamy-connect library), which are not part of this repository and are not
covered by the Kuro License — in this repository they are replaced by a stub
(src/vendor/entamy-client/). Using Entamy services such as Entamy ID or hosting
by Entamy is governed by the Entamy Terms of Service and Privacy Policy, which you
agree to inside the app.
