celld-operator.io

The website for celld-operator — the Kubernetes operator that runs celld fleets, so you can host Cloudflare Workers and Durable Objects on your own cluster. Landing page plus 13 documentation pages, live at celld-operator.io.

Plain HTML, one stylesheet, no framework, and no JavaScript beyond one inline line that collapses the docs menu on phones. Type is Geist and Geist Mono from Google Fonts, with system fallbacks. The only build step assembles documentation pages from content fragments so every page shares one chrome; you can serve the repository root directly from any static host. Light and dark themes follow prefers-color-scheme.

Quick start

git clone https://github.com/ezgamehost/celld-operator.io
cd celld-operator.io
python3 -m http.server 8080     # http://localhost:8080

Edit a docs page, regenerate, refresh:

$EDITOR build/content/quick-start.html
python3 build/build.py

build.py needs only the Python 3 standard library.

How the site is put together

Path	What it is	Edit?
index.html	Landing page	Yes — hand-maintained; its header, footer, and <head> links copy header(), FOOTER, and HEAD_COMMON from build.py
build/content/*.html	Body fragments for the 13 docs pages	Yes — this is where docs live
build/build.py	Assembles fragments into pages; owns chrome, nav, and metadata	Yes — for structure and templates
assets/style.css	The single shared stylesheet	Yes
docs/**/index.html	Generated docs pages	No — regenerated by build.py
sitemap.xml, 404.html	Generated	No
assets/og.png, favicon.svg	Social-preview image and favicon	Rarely
CNAME	Custom domain for GitHub Pages	Rarely

A fragment is just the page body: headings, prose, tables, and <pre class="code"> blocks. Everything around it — <head> and metadata, header, sidebar navigation, breadcrumbs, the "On this page" rail (built from the fragment's <h2 id> anchors), the edit-on-GitHub link, prev/next pager, footer, JSON-LD — comes from build.py, so pages stay consistent and a chrome change lands everywhere at once.

Adding a page

1. Write build/content/<slug>.html (body only).
2. Register it in the PAGES list near the top of build/build.py:

("<slug>", "<sidebar group>", "<nav title>", "<html title>", "<meta description>")

Groups, in order: Getting started, Concepts, Guides, Reference. Position within PAGES sets both the sidebar order and the prev/next pager.

3. Run python3 build/build.py. The page, its sidebar entry, breadcrumbs, pager links, and sitemap.xml entry all appear.
4. Bump LASTMOD in build.py when publishing meaningful changes.

Deployment

Every push to main triggers .github/workflows/deploy.yml, which regenerates the docs pages before publishing to GitHub Pages — so the deployed site always matches the fragments even if someone forgets to run build.py. build/, README.md, and .github/ are excluded from what ships.

Writing conventions

The documentation aims to be accurate rather than promotional, because it describes an alpha operator for an alpha runtime:

• Verify claims against source. Operator behavior lives in celld-operator (CRD fields in api/v1alpha1/workerapp_types.go, flags in cmd/main.go, reconciled resources in internal/controller/); celld's own behavior lives in denoland/celld. Prefer citing what the code does over what a design once intended.
• Name limits explicitly. Unsupported Cloudflare APIs, disqualified object stores, and unimplemented fields belong in the docs, not omitted from them.
• Keep examples runnable. YAML examples use the real API group (celld-operator.io/v1alpha1) and real field names; commands should work if pasted.
• Version-sensitive facts drift. Defaults, flags, and the Cloudflare compatibility matrix change upstream — re-check them when celld or the operator releases. The site currently describes celld v0.6.2 (compatibility from celld's own docs/cloudflare-compat.md at that tag) and the operator as of 08ede4d.

License and trademarks

Site content is © the celld-operator authors, under the repository's Apache-2.0 license. celld is a project of Deno Land Inc. Cloudflare, Cloudflare Workers, and Durable Objects are trademarks of Cloudflare, Inc. This site describes compatibility and is not affiliated with, sponsored by, or endorsed by Deno Land or Cloudflare.

Related

• Operator source: ezgamehost/celld-operator
• Upstream runtime: denoland/celld