README

Themes

Orchestra MCP Themes plugin — Material Design theme system with 25 presets, Tailwind CSS v4 integration, VS Code theme import, and CSS generation.

Features

25 Built-in Themes — Material Design presets across 4 groups (Orchestra, Material, Popular, Classic)
CSS Generation — Generate CSS custom properties for all themes as [data-theme] selectors
Live Theme Component — themes::components.live Blade component for real-time theme updates via polling + WebSocket
Settings Integration — Listens for appearance.theme setting changes and broadcasts updates via Socket
Tailwind CSS v4 — @theme block maps CSS variables to Tailwind color tokens (bg-mt-bg, text-mt-accent, etc.)
VS Code Import — Import VS Code color theme JSON files and register as Orchestra themes
Theme Registry — In-memory store with group filtering, light/dark classification
Contributes Integration — All presets registered as ThemeContribution for VS Code compatibility
4 MCP Tools — List, info, activate, and CSS generation
2 Artisan Commands — List themes and generate CSS stylesheets

Requirements

PHP 8.2+
Laravel 12.x
orchestra-mcp/plugins package

Installation

composer require orchestra-mcp/themes

The service provider is auto-discovered.

Quick Start

List Themes

php artisan themes:list
php artisan themes:list --group=Material --type=dark

Set Active Theme

use OrchestraMcp\Themes\Facades\Themes;

Themes::setActive('dracula');

Generate CSS

# Full stylesheet with all themes
php artisan themes:generate-css --output=resources/css/themes.css

# Just the Tailwind @theme block
php artisan themes:generate-css --format=tailwind

# CSS variables for active theme
php artisan themes:generate-css --format=variables

Apply in HTML

<html data-theme="dracula">

Built-in Theme Groups

Group	Count	Themes
Orchestra	1	Orchestra
Material	11	Deep Ocean, Darker, Oceanic, Palenight, JetBrains, Lighter, Forest, Sky Blue, Sandy Beach, Volcano, Space
Popular	10	Monokai Pro, Dracula, GitHub Light, GitHub Dark, One Dark, One Light, Night Owl, Light Owl, Moonlight, SynthWave '84
Classic	3	Arc Dark, Solarized Dark, Solarized Light

MCP Tools

Tool	Annotation	Description
`theme-list`	`#[IsReadOnly]`	List themes with group/type filter
`theme-info`	`#[IsReadOnly]`	Theme details with colors and CSS
`theme-activate`	`#[IsIdempotent]`	Set active theme by ID
`theme-css`	`#[IsReadOnly]`	Generate CSS output

Artisan Commands

Command	Description
`themes:list`	List all available themes with filters
`themes:generate-css`	Generate CSS stylesheet, Tailwind tokens, or variables

Configuration

Publish the config:

php artisan vendor:publish --tag=orchestra-themes-config

Key	Default	Env Variable	Description
`enabled`	`true`	`ORCHESTRA_THEMES_ENABLED`	Enable/disable themes plugin
`default`	`'deep-ocean'`	`ORCHESTRA_THEMES_DEFAULT`	Default theme at startup
`marketplace`	`true`	—	Marketplace visibility

Documentation

Full documentation is available in the docs/ directory:

Getting Started — Installation, configuration, quick start
Architecture — Theme system design, DTOs, CSS generation
Presets — All built-in themes
VS Code — Theme import from VS Code JSON
Tools — MCP tool reference
Commands — Artisan command reference
Configuration — Full config key reference
API Reference — Facades, services, registry

Development

# Install dependencies
composer install

# Run tests
composer test

# Format code
composer format

# Static analysis
composer check

# Lint
composer lint

License

MIT

orchestra-mcp / themes

Maintainers

Details