See what schema-driven config management actually feels like.
This repo is a collection of hands-on examples that let you experience OpenDecree — from a 5-minute quickstart to production-grade patterns. Each demo is self-contained and runs with a single docker compose up.
Alpha Software — OpenDecree is under active development. These demos track the latest release and may change between versions.
Click a button → browser IDE → running demo. No Docker, no language runtime, no setup.
| Demo | Open in Codespaces |
|---|---|
| Quickstart |  |
| REST Walkthrough | |
The devcontainer starts decree server, Postgres, and Redis automatically. Ports are forwarded so your browser can reach the running demo.
Faster boot: Repo admins can enable Codespaces prebuilds in repository Settings → Codespaces. Prebuilds run the image build and
postCreateCommandahead of time, reducing cold-start to under 60 seconds.
- Docker and Docker Compose
That's it. No language runtimes, no database setup, no fuss.
Coming soon — demos are being built. Star the repo to get notified!
| Demo | What You'll Learn | Difficulty |
|---|---|---|
| Quickstart | Create a schema, set config values, watch them update live | Beginner |
| No SDK (curl only) | Drive the full REST API with nothing but curl — zero install | Beginner |
| Pick Your Language | The same scenario in Go, Python, and TypeScript side by side | Intermediate |
| Multi-Tenant | Shared schemas, isolated config per tenant | Intermediate |
| Schema Evolution | Evolve your schema safely — add fields, tighten constraints, migrate tenants | Intermediate |
| Config as Code | Version-controlled config with CI/CD — seed, validate, promote | Advanced |
You don't need to clone the entire repo:
# Grab a single demo with sparse checkout
git clone --no-checkout https://github.com/opendecree/demos.git
cd demos
git sparse-checkout set quickstart
git checkout- A README with what you'll learn, step-by-step walkthrough, and things to try yourself
- A docker-compose.yml that starts everything (decree server, Postgres, Redis)
- A devcontainer so you can run it in GitHub Codespaces with one click
- A
test.shscript that CI runs to verify the demo works - Cleanup instructions —
docker compose down -vand you're back to clean
OpenDecree is an open-source business configuration management service. You define schemas (what config looks like), then manage config values per tenant — with types, constraints, validation, audit trails, and live updates built in.
Think of it as "database migrations, but for your business config."
- Schema-driven — define once, get validation + docs + type safety everywhere
- Multi-tenant — one service, many tenants, shared or independent schemas
- Live updates — SDKs watch for changes in real time, no polling
- Language-agnostic — Go, Python, TypeScript SDKs, plus a full REST/gRPC API
We'd love that. Check out CONTRIBUTING.md for guidelines and the demo README template. If you have an idea but aren't sure where to start, open a Discussion on our community hub.
- OpenDecree — the core service, CLI, and Go SDKs
- Python SDK —
pip install opendecree - TypeScript SDK —
npm install @opendecree/sdk - Admin GUI — browser-based config management
Head to OpenDecree Discussions — our community hub covers all OpenDecree repos.
Apache License 2.0 — see LICENSE.