Wizzlethorpe Vaults
A tool that turns an Obsidian vault into a self-hosted, role-gated wiki on your own Cloudflare account. This page is itself a deployed Vault. Every feature you read about works live, right here. Poke around, sign in at higher tiers, view source, then grab the CLI and deploy your own!
This vault is themed around the fictional Mossfoot Inn. It's the same authoring pattern you'd use for a campaign wiki, a public knowledge base, a patron-supported worldbuilding project, or whatever else.
This vault has three tiers: public, patron, and dm. You're reading the public tier right now. Use the auth box in the sidebar to sign in as a higher tier:
| Role | Password | Unlocks |
|---|---|---|
patron | patron-pass | The Witchwood Cult page + a callout in Aelar's page |
dm | dm-pass | All of the above, plus Hidden Caves + DM callouts |
Pages above your tier 404 directly; lower-tier pages redact role-gated callouts inside them. Try Aelar's page at each tier to see the difference.
What's demonstrated here
| Feature | See it on |
|---|---|
| Wikilinks | Features/Wikilinks |
| Callouts | Features/Callouts |
| Images & cover discovery | Features/Images |
| Bases (filtered/sorted views over your notes) | Features/Bases, scroll down |
| Role gating | Features/Role gating |
| Foundry VTT integration | Features/Foundry integration |
| Frontmatter dialog | the {} button in the top-right of every page |
| Per-page social-card meta | view source on any page → og:image, og:title, etc. |
A small cast
A live Bases cards view filtered to NPCs, sorted by name. The same authoring pattern works for items, locations, sessions, anything you can give consistent frontmatter. The eponymous Dr. Bixby Wizzlethorpe is in the back booth.
| Name | Class | cr | Location |
|---|---|---|---|
| Aelar Galanodel | Ranger | 3 | Mossfoot Inn |
| Bram Mossfoot | Commoner | 0 | Mossfoot Inn |
| Dr. Bixby Wizzlethorpe | Archmage | 12 | Mossfoot Inn (sabbatical) |
See more about support for Obsidian bases functionality in Features/Bases.
Audio + passthrough files
This vault includes tavern-jingle.ogg to demonstrate how files that are not (currently) rendered into the wiki are handled. These include audio, video, PDFs, and EPUBs files. These files are included in the deploy only into variants whose visible pages reference them, just like images. A DM-only audio cue can't accidentally leak to public visitors. See Features/Passthrough files for more details.
Try it in Foundry VTT
The companion module syncs this vault into a Foundry world: every page becomes a JournalEntry, every wikilink rewires to a Foundry document link, and pages with foundry_base frontmatter clone an existing compendium document into the world (NPCs become real Actors, items become real Items).
- Install the Wizzlethorpe Vaults module: in Foundry → Add-on
Modules → Install Module → paste the manifest URL
https://github.com/wizzlethorpe/vaults-foundry/releases/latest/download/module.json. Or grab it from the GitHub releases. - In a dnd5e world, enable the module and click the Sync Vault button on the Journal Directory.
- Add Vault → paste
https://test.vaults.wizzlethorpe.com→ settings dialog opens with the deploy's name pre-filled. - Click Sync. The public tier imports immediately — no token needed. You'll get Aelar and Bram as world Actors (cloned from SRD Scout + Commoner) and Healing Potion as a world Item.
- Click Connect → enter
dm-passto elevate. The next sync brings in the DM-only Hidden Caves page and the patron/DM callouts. - Open the per-vault settings, set DM role to
dm. Now public-tier journals import as player-visible (Observer ownership); patron + dm pages stay GM-only.
The page-driven Actor/Item descriptions render the wiki article inline via Foundry's @Embed[…] enricher, so editing a page and re-syncing updates the doc's description automatically. User edits to other fields (HP, conditions, custom journals) survive future incremental syncs. See Features/Foundry integration for more details.
Set up your own vault
npm install -g @wizzlethorpe/vaults
cd path/to/your/obsidian-vault
vaults init
vaults preview # local preview at http://localhost:8788
vaults push # one-shot deploy to Cloudflare Pages
Full docs: github.com/wizzlethorpe/vaults-cli.