The wardrobe
for headless sites

MIT · SvelteKit 5 · Konsta UI · optional Village pack · static cPanel deploy. Built adjacent to Grav 2 + Admin2.

v0.1 shipped MIT adapter-static Community API

Clone & run

$ git clone https://github.com/GravMUD/mud-shell.git
$ cd mud-shell/starters/gravmud-headless
$ cp .env.example .env && npm install && npm run dev

Dev proxies /members/api → gravfans.live

Repo layout

starters/gravmud-headless/   SvelteKit app (gravfans headless)
  src/lib/shell/           → future @gravmud/shell
  src/lib/village/         → future @gravmud/shell-village
LICENSE                    MIT

Community API (v0.1)

GET /members/api/feed

Village activity feed. Used by /feed route.

GET /members/api/members

Member directory + search.

GET /members/api/profile/{user}

Public profile + graph stats.

GET /members/api/whoami

Session check (cookie auth v0.2).

Backend today: grav-plugin-mambers on Grav 2. Host-agnostic HTTP — not hardcoded in shell core.

Deploy static

$ PUBLIC_GRAV_ORIGIN=https://gravfans.live npm run build
# upload build/ to docroot — .htaccess included for SPA routes

Links

app.gravfans.live

Headless MUD Shell demo

gravfans classic

THE HOUSE — Twig + Mambers

Hire the tailor

Shell is free. Launch services on getmudshell.