MIT · Grav 1.7 + 2.0 · MarkUpDown Design Spec

Flat-file pages.
Structured markup.

Grav MUD Alpha registers .mud pages and compiles them to HTML — design tokens, layout fences, and NEXT Object Notation. No database. No React island required for a hero band.

Get the plugin Full starter package Live spec on gravmud.site
3
Core primitives
15+
Layout fences
MIT
Free forever
.mud
Page extension

Three primitives

@@@

Design tokens

Page-level theme context — layout mode, CSS variables, design name.

:::

Layout fences

Named blocks: hero, cards, pricing, timeline, compare, code, wiki, manifesto…

++

NEXT Object Notation

Structured config inside fences — lists, nested keys, multiline bodies.

@@@
name: grav-official
layout: promo
@@@

::: hero
eyebrow: Hello
title: Grav
accent: MUD
lead: One file. Full section.
cta:
  - [Get started](https://gravmud.site/get-started) primary
:::

What the plugin does

🔌

Extension hook

Registers .mud before Grav scans pages — discovery just works.

⚙️

Compile pipeline

onPageContentRaw transforms MarkUpDown to HTML your theme styles.

🌿

Grav 2 ready

Compatibility flags for 1.7 and 2.0 — pair with Admin2 or classic admin.

🎁

Commercial stays separate

Commentz, Forumz, EvvyTink Admin, Mud Bazaar — not in this repo. Alpha is the free compiler.

JavaBean for Admin2

Andy builds the cathedral — we paint the flight deck. Twelve Admin2 presets, Paint Shop, MIT forever.

📦

Starter package

Plugin + grav-mud-site theme + demo .mud pages — the full overlay zip on gravmud.site.

Install

Plugin only — pair with grav-mud-site theme or your own Twig theme.

bin/gpm direct-install \
  https://github.com/GravMUD/grav-plugin-grav-mud-alpha/releases/download/0.5.0/grav-plugin-grav-mud-alpha.zip

bin/grav cache
Download release zip