Everything, in one manual.
Install Devani in ten minutes, learn the editor in an hour, extend it in a weekend. Every page in this section is short, practical, and assumes you'd rather be building than reading.
Where people usually start.
If you're new to Devani, these are the four pages worth reading first — in order.
Install in 10 minutes
The fast path: clone the repo, run one command, point a domain at it. Works on Vercel, Fly, or any Node host.
Your first page
The editor in a 5-minute tour. How blocks work, how layouts work, how to publish.
Connecting Claude or ChatGPT
Set up MCP, give the AI permission to edit, and start drafting pages from chat.
Going live
Domain setup, SSL, atomic deploys, rollback. The bits that matter once you're past the toy stage.
Pick a section.
Twelve top-level areas. Each one expands into focused, single-purpose pages.
Getting started
Install paths, first edit, first deploy, getting unstuck. Eight pages.
The editor
Blocks, layouts, theming, presets, keyboard shortcuts. Eleven pages.
Pages & posts
Schema, meta.json, scheduling, drafts, multi-author workflows. Nine pages.
SEO
Per-page fields, sitemap, redirects, schema, OG image defaults. Seven pages.
Forms
Building, routing, spam protection, submissions, webhooks. Six pages.
Media library
Tonta integration, sizes, organization, EXIF, alt text via AltText. Eight pages.
Deployment
Hosting recipes, atomic deploys, instant rollback, environment variables. Ten pages.
Backups & snapshots
How they work, retention, manual restore, automation. Five pages.
MCP & AI editing
Server config, ChatGPT connection, Claude connection, what tools the AI gets. Six pages.
Extending Devani
Custom blocks, custom fields, hooks, the plugin API. Twelve pages.
CLI reference
Every command, every flag, every exit code. Four pages.
Self-hosting
Docker, VPS recipes, managed platforms, scaling, monitoring. Nine pages.
The shortcuts worth knowing.
Stuff people search for repeatedly. If you find yourself looking something up, it probably belongs here.
- Environment variables. The full list, defaults, and what each one controls.
- Page schema. Every field in
meta.jsonand what it does. - Block API. Defining a block, registering it, the editor preview contract.
- MCP tools. Every tool the AI integration exposes, with example calls.
- CLI commands.
devani build,devani deploy,devani snapshot, and friends. - HTTP routes. What's served, what's behind auth, what the admin endpoints look like.
- Theming tokens. Every CSS variable, where it's used, how to override it.
- Error codes. What each error means and where to look first.
What's new in the docs.
The last few sections we've added or rewritten. Newest at the top.
MCP tool reference
Every tool the Devani MCP server exposes, with parameter schemas and example calls from Claude and ChatGPT.
Atomic deploys, rewritten
Now covers the snapshot folder layout, rollback CLI, and what happens during a failed deploy. Less hand-waving.
Multi-site setups
Running multiple Devani sites from one install. Agency workflow, shared media, per-site themes.
Missing something? Tell us.
Documentation gaps are the easiest contribution to make — open an issue or a PR with the section you wish existed.