Dropbits documentation
Guides for site owners and people who install or deploy Dropbits. Normative architecture for contributors lives in this repository’s SPEC.md (not a parallel AdminHub or config evaluator).
Site owners
No terminal required — log in, open Admin, edit on the live page.
| Guide | Topic |
|---|---|
| What is Dropbits? | Overview |
| Log in & roles | Login, admin/editor/guest |
| Admin menu tour | Edit, Layout, Nav, Pages, Entities, Site, LLM, Checkpoint, Help |
| Pages & navigation | Site map and menu tree |
| Entities & records | Schema (site-wide) + create records / slug-from-title |
| Layout compose | Regions, + picker, reorder |
| Packs & capabilities | Install & enable from Site |
| Media | Picker, delete vs remove from list |
| LLM chat & API key | Assistant + bring-your-own key |
| Checkpoint & backup | Checkpoints, Assistant Undo, ZIP |
Site builders
Obtain the kernel, install, packs CLI, content-owned deploy, WXR, and ops.
| Guide | Topic |
|---|---|
| Get the kernel | Codeberg clone / release zip; dist = dropbits/ |
| Install locally | PHP + demo bootstrap |
| Install on server | Lean DocumentRoot + DROPBITS_SITE |
| Repo docs layout | docs/ vs dropbits/docs/ vs website/ |
| Site directory layout | sites/<id>/ tree and registries |
| Packs (CLI + Admin) | pack-install / enable + Site UI |
| Content-owned deploy | Code + migrate; never --with-content by default |
| Upgrade a deployed site | Ship code, migrate, enable packs |
| WXR / WordPress migration | Pointer to MIGRATION-IMPORT |
| Troubleshooting | 503, deploy swap, packs, keys |
| LLM key for operators | Server key paths + LLM-KEY |