# October Themes — Complete Reference

> 1000+ curated design system themes for AI coding tools. Free, no API key.

## Quick Install

### MCP Server (Claude, Cursor, VS Code, Windsurf)

Add to your MCP config file:

```json
{
  "mcpServers": {
    "october-themes": {
      "command": "npx",
      "args": ["-y", "@october-dev/themes-mcp"]
    }
  }
}
```

Config file locations:
- Claude Desktop / Claude Code: `~/.claude/mcp.json`
- Cursor: `.cursor/mcp.json`
- VS Code Copilot: `.vscode/mcp.json`
- Windsurf: `~/.windsurf/mcp.json`

### Skill (Claude Code, Gemini CLI, Codex CLI)

```bash
mkdir -p ~/.claude/skills/inject-theme
curl -sL -o ~/.claude/skills/inject-theme/SKILL.md \
  https://raw.githubusercontent.com/october-dev/october-skill/main/.claude/skills/inject-theme/SKILL.md
```

Then use: `/inject-theme desktop-web`

## MCP Tools

### get_theme

Get a weighted-random design system theme.

Parameters:
- `platform` (optional): `desktop-web`, `mobile-app`, or `game`

### get_theme_by_id

Fetch a specific theme by slug ID.

Parameters:
- `id` (required): Theme slug, e.g. `industrial-neon`, `fluid-glass`, `fluid-glass`

## Public API

```
GET https://october.dev/api/public/themes
```

No authentication required. CORS enabled for all origins.

### Get a random theme

```bash
curl -sL "https://october.dev/api/public/themes"
curl -sL "https://october.dev/api/public/themes?platform=desktop-web"
```

Response:
```json
{
  "theme": {
    "id": "industrial-neon-desktop-web",
    "theme_name": "Industrial Neon",
    "platform": "desktop-web",
    "weight": 12,
    "content": "<design-system>...prompt-ready markdown...</design-system>"
  }
}
```

### Get a specific theme by ID

```bash
curl -sL "https://october.dev/api/public/themes?id=fluid-glass"
```

### Parameters

| Param | Default | Description |
|-------|---------|-------------|
| platform | (all) | `desktop-web`, `mobile-app`, or `game` |
| random | true | `true` = weighted random with full content |
| id | — | Fetch specific theme by slug |

## What's in a theme

Each theme is 70-100 lines of prompt-ready markdown containing:
- Color palette (8+ semantic colors with hex values)
- Typography (fonts, sizes, weights)
- Component styles (buttons, cards, inputs — real Tailwind classes)
- Effects and animations (shadows, gradients, transitions)
- Layout and spacing system
- Non-Genericness Rules (3-5 mandatory bold design choices)

## Platforms

- `desktop-web` — Websites, dashboards, SaaS apps
- `mobile-app` — iOS and Android apps
- `game` — Browser games

## Links

- npm: https://www.npmjs.com/package/@october-dev/themes-mcp
- MCP source: https://github.com/october-dev/october-mcp
- Skill source: https://github.com/october-dev/october-skill
- Docs: https://www.october.dev/themes
- API: https://october.dev/api/public/themes