qbtmud Themes Repository

This repository hosts shareable theme JSON files for qbtmud.

Structure

• themes/*.json: individual theme files
• index.json: generated list of theme file paths used by qbtmud

Theme file contract

Each file should contain a qbtmud ThemeDefinition JSON payload, for example:

{
  "id": "my-theme-id",
  "name": "My Theme",
  "description": "Optional description",
  "fontFamily": "Nunito Sans",
  "theme": {
    "paletteLight": {
      "$type": "PaletteLight",
      "primary": "#0078D4"
    },
    "paletteDark": {
      "$type": "PaletteDark",
      "primary": "#3AA0FF"
    }
  }
}

Adding a theme

1. Add a new JSON file under themes/.
2. Regenerate index.json:

scripts/rebuild-index.sh

Or with PowerShell:

./scripts/rebuild-index.ps1

3. Open a pull request.
4. CI validates theme JSON and verifies index.json is up to date.

Publishing

GitHub Actions deploys this repository to GitHub Pages from main.

qbtmud can read:

• https://lantean-code.github.io/qbtmud-themes/index.json