GitHub Syntax Themes

GitHub Syntax Theme Store

A centralized repository of syntax highlighting themes for the GitHub Syntax Themes browser extension.

This store provides a collection of JSON theme files that define consistent syntax colors for GitHub code blocks, markdown snippets, etc.

What It Does

The theme store acts as a registry of themes. Each theme is defined in a simple JSON format and can be loaded by the extension.

Themes describe:

• Name → Human‑readable theme name
• Author → GitHub username of the contributor
• Type → light or dark
• SyntaxHighlighting → Token colors for keywords, strings, comments, functions, etc.
• Optional icon → Theme preview icon

Example Theme File

{
  "$schema": "https://raw.githubusercontent.com/calebephrem/github-syntax-theme-store/refs/heads/main/schema.json",
  "name": "Dracula",
  "author": "dracula",
  "type": "dark",
  "description": "Classic dark theme with vibrant syntax colors",
  "syntaxHighlighting": {
    "comment": "#ffffff70",
    "constant": "#ffdd70",
    "constantNumeric": "#00ddee",
    "constantBuiltin": "#ffdd70",
    "keyword": "#86ff72",
    "keywordControl": "#86ff72",
    "string": "#aaff4f",
    "stringRegexp": "#00ddee",
    "variable": "#c0c0ff"
  }
}

How It Works

• The extension fetches themes from this repository.
• Each theme JSON is validated against the GitHub Syntax Themer Schema (schema.json).
• The extension maps these values to GitHub’s internal syntax system (.pl-* classes and PrettyLights CSS variables).
• Users can switch themes from the extension popup.

Contributing

We welcome contributions of new themes or improvements to existing ones.

To contribute:

1. Fork this repository.
2. Add your theme JSON file under the themes/ directory.
3. Ensure your file matches the schema (schema.json).
4. Submit a pull request.

Tip

Just provide the schema.json file along with a VS Code theme file of your choice to an AI agent, and it will generate a fully compatible theme file for you automatically. No manual writing needed ✨

Please include:

• Theme name and description
• Author (your GitHub username)
• Theme type (light or dark)
• SyntaxHighlighting values
• Optional icon URL

Features

• Centralized theme registry for the extension
• Schema‑validated JSON format
• Easy contribution workflow via pull requests
• Supports both light and dark themes
• Compatible with GitHub’s legacy and modern syntax systems

License

MIT © Caleb Ephrem