# October Themes

> 1000+ curated design system themes for AI coding tools. Free, no API key. Makes AI-generated UI look polished instead of generic.

October Themes is a library of handcrafted design systems — color palettes, typography, component styles (real Tailwind classes), effects, animations, and Non-Genericness Rules. Each theme is 70-100 lines of prompt-ready markdown that goes directly into an LLM's context.

Two ways to use:

1. **MCP Server** — works with Claude, Cursor, VS Code Copilot, Windsurf, ChatGPT
2. **Skill** — works with Claude Code, Gemini CLI, Codex CLI

## Install

- [MCP Server install guide](https://october.dev/themes#mcp-server): Add one JSON snippet to your AI tool's MCP config. `npx -y @october-dev/themes-mcp`
- [Skill install guide](https://october.dev/themes#skill): One curl command. `/inject-theme` slash command for Claude Code.
- [npm package](https://www.npmjs.com/package/@october-dev/themes-mcp): `@october-dev/themes-mcp` on npm
- [MCP Server source](https://github.com/october-dev/october-mcp): GitHub repo
- [Skill source](https://github.com/october-dev/october-skill): GitHub repo

## API

- [API documentation](https://october.dev/themes#api): Public REST API, no auth required

### Endpoints

GET `https://october.dev/api/public/themes` — single endpoint, all operations via query params:

- `?random=true` (default) — weighted-random theme with full content
- `?random=true&platform=desktop-web` — random theme filtered by platform (desktop-web, mobile-app, game)
- `?id=THEME_ID` — fetch specific theme by slug ID

### MCP Tools

The MCP server exposes 2 tools:

- `get_theme(platform?)` — get a random design system theme, optionally filtered by platform
- `get_theme_by_id(id)` — fetch a specific theme by its slug ID

### Skill Commands

- `/inject-theme` — inject a random theme for any platform
- `/inject-theme desktop-web` — inject a theme for websites/dashboards
- `/inject-theme mobile-app` — inject a theme for iOS/Android apps
- `/inject-theme game` — inject a theme for browser games

## Optional

- [Projects showcase](https://october.dev/themes#projects): Apps built with October Themes
- [October main site](https://october.dev): The AI-native canvas for building apps