Skip to content

jbatte47/verse

Repository files navigation

Verse

An open source content management platform for world builders and storytellers.

Build lore wikis, curate art galleries, publish prose, and bring your worlds to life.

License: GPL v3 Deploy to Cloudflare

Features

  • Lore Wiki — Interconnected knowledge bases for characters, locations, factions, and timelines
  • Art Gallery — Showcase concept art, maps, and visual assets with metadata and tagging
  • Text Reader — Beautiful Markdown-rendered prose with rich typography
  • Secure Auth — Pluggable authentication via Cloudflare Access
  • Edge-First — Deployed on Cloudflare Workers for global performance
  • WCAG Compliant — Accessible by design, mobile-first responsive layouts

Tech Stack

Getting Started

Prerequisites

  • Node.js 22+
  • npm

Development

# Install dependencies
npm install

# Start development server
npm run dev

# Preview with Cloudflare runtime
npm run preview

Deployment

Deployments are fully automated via GitHub Actions. Push to main and the site deploys to Cloudflare Workers within minutes.

To deploy manually:

npm run deploy

Architecture

  GitHub (push to main)
    │
    ▼
  GitHub Actions (build + deploy)
    │
    ▼
  Cloudflare Workers (edge runtime)
    │
    ├──▶  KV    config, feature flags
    ├──▶  D1    lore entries, metadata
    └──▶  R2    images, media, prose files

  Content persists across deployments ✓

License

This project is licensed under the GNU General Public License v3.0.

About

an open source content management tool for world builders and storytellers

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors