sholdee

sholdee / crd-schema-publisher

Public

Lightweight Go binary that extracts CRD JSON schemas from a Kubernetes cluster and publishes them to Cloudflare Pages. Watches for CRD changes in real-time or runs as a CronJob. ~11MB distroless container with zero runtime dependencies.

kube-schemas.shold.io cloudflare-pages cronjob custom-resource-definitions distroless gitops
10
0
100% credibility
Found Apr 12, 2026 at 10 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Go
AI Summary

Tool that extracts, converts, and publishes interactive HTML documentation of JSON schemas from Kubernetes CustomResourceDefinitions to Cloudflare Pages.

How It Works

1
🔍 Discover the helper tool

You hear about a simple tool that turns your team's custom data rules into easy-to-browse web pages.

2
⚙️ Prepare your setup

You grab the ready-made instructions and link the tool to your app-running place and a free web hosting spot.

3
🚀 Launch with one click

You place the tool inside your app-running place where it quietly watches for changes to your custom data rules.

4
Choose update style
⚡
Live updates

It refreshes pages instantly as your team tweaks data rules, keeping everything current.

📅
Daily refresh

It rebuilds the pages once a day, simple and low-effort for steady teams.

5
✨ See pretty pages appear

The tool pulls out the rules, makes interactive pages with search and foldable sections, and puts them online.

🎉 Explore your docs effortlessly

Visit your new site to search, click through details, and understand your custom data perfectly every time.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 10 to 10 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is crd-schema-publisher?

This lightweight Go binary extracts JSON schemas from CustomResourceDefinitions in your Kubernetes cluster, converts them to kubeval-compatible format, and publishes interactive HTML docs to Cloudflare Pages. Run it as a real-time watcher deployment that triggers on CRD changes, or as a CronJob for scheduled updates—all in a ~11MB distroless container with zero runtime dependencies. Get a searchable index page with dark mode, collapsible trees, and yaml-language-server modeline examples.

Why is it gaining traction?

Unlike static schema dumps or heavy doc generators, it auto-deploys polished, browsable docs with client-side search and stats, handling transforms like int-or-string to oneOf seamlessly. The CLI supports extract, upload, watch, preview, and run modes, plus leader election for safe scaling. Its tiny binary and direct Cloudflare API uploads beat bloated alternatives for cluster-side automation.

Who should use this?

Kubernetes operators maintaining CRDs for teams using kubeval or yaml-language-server. SREs in dynamic clusters needing fresh schema refs without manual gitops. Devs validating YAML manifests against live production schemas via hosted URLs.

Verdict

Grab it if you want lightweight CRD docs on Cloudflare without the hassle—preview mode lets you test instantly. With 10 stars and 1.0% credibility score, it's early but battle-tested via strict linting, full coverage, and hardened K8s manifests.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.