Flat-file CMS · getgrav.org

Built on
Grav

Grav MUD is not a separate CMS — it's a content format + compiler plugin that respects Grav's page tree, YAML frontmatter, Twig themes, and cache. The official promo site you're reading is 100% Grav, 100% .mud.

Why Grav is the right host

Pages stay files

Git-friendly. FTP-averse. Your .mud lives next to user/pages like always — no database export ritual.

Event pipeline

onPageContentRaw compiles MUD to HTML before markdown/Twig processing — clean hook, no core hacks.

Themes stay themes

CSS is still CSS. Twig is still Twig. MUD only replaces the middle — the unstructured markdown soup.

Path to core

Alpha proves demand. Flex parity + tests = conversation with Trilby Media. Andy's conniption = market validation.

Core integration (future-facing)

This PoC is a pitch fork, not a drop-in Grav 2 PR today.

Today (Alpha)

  • Plugin registers .mud extension
  • MudAlphaCompiler + MudDesignSpec render fences
  • Theme provides layout CSS

Tomorrow (if adopted)

  • Official page type in Admin
  • Flex Objects compatibility
  • Shared parser package with Code Designer
  • Documentation on learn.getgrav.org

We're not asking Grav to become Webflow. We're asking for a first-class structured page format — the way .md was first-class, but for design specs.

Friendly fork energy. Buy Andy a coffee before saying "Grav 2.0 just dropped MUD."

"The best CMS plugin is the one that ships as a text file your client can email you."
— Probably not Andy Miller, but he'd agree in spirit

Learn more

Official Grav resources (the real ones):

Powered by Grav MUD Alpha v0.5.0 · MarkUpDown Design Spec (.mud) · NEXT Object Notation