Catppuccin — Soothing Pastel Theme for Developers

Introduction

Catppuccin is a community-driven pastel color scheme that has rapidly become one of the most popular developer themes on GitHub. It defines four flavor variants, from a warm light palette (Latte) to a deep dark one (Mocha), each with carefully tuned pastel accents. The project maintains official ports for over 200 applications, making it easy to unify your entire desktop under one consistent aesthetic.

What Catppuccin Does

• Defines four palette flavors: Latte (light), Frappe (medium-dark), Macchiato (dark), and Mocha (darkest)
• Maintains 200+ official ports covering editors, terminals, browsers, desktop environments, and productivity apps
• Publishes a strict style guide and color specification so every port looks consistent
• Provides accent color options within each flavor for further personalization
• Offers userstyle CSS themes for websites like GitHub, YouTube, and Reddit via the Catppuccin Userstyles project

Architecture Overview

The Catppuccin palette is defined in a central specification repository containing hex values, HSL mappings, and Whiskers templates. Whiskers is a custom Tera-based templating tool that generates theme files for each port from the palette data. Port repositories consume this specification and produce application-specific configs (JSON for VS Code, Lua for Neovim, TOML for terminals, etc.). A CI pipeline validates palette compliance across all ports.

Self-Hosting & Configuration

• Install the port for your editor from its marketplace or plugin manager
• Select your preferred flavor (Latte, Frappe, Macchiato, or Mocha) in the theme settings
• For terminals, download the flavor config file from the relevant port repo and import it
• Apply Catppuccin Userstyles via the Stylus browser extension for website theming
• Use the Whiskers CLI to generate custom ports for unsupported applications

Key Features

• Four distinct flavors spanning light to deep dark for every lighting condition
• 200+ official ports with active maintenance and consistent palette adherence
• Whiskers template engine for programmatic port generation
• Accent color customization within each flavor
• Browser userstyles for theming popular websites to match your desktop

Comparison with Similar Tools

• Dracula — Bold saturated colors on a dark background; Catppuccin uses softer pastel tones with four flavor options
• Solarized — Precision-engineered light and dark modes; Catppuccin offers four gradations instead of two
• Gruvbox — Warm retro palette; Catppuccin has a cooler, more modern pastel character
• Nord — Arctic blue tones; Catppuccin provides more accent color variety and additional flavors
• Rosepine — Muted romantic palette; Catppuccin covers more applications and has a larger community

FAQ

Q: Which flavor should I choose? A: Mocha is the most popular for dark-mode users. Latte works well in bright environments. Frappe and Macchiato sit in between for those who prefer moderate contrast.

Q: How do I theme my entire desktop consistently? A: Install ports for your editor, terminal, browser (via userstyles), and desktop environment from the Catppuccin GitHub organization. All share the same palette.

Q: Can I contribute a port for an unsupported app? A: Yes. Use the Whiskers template tool and follow the contribution guide in the main Catppuccin repository. Ports are reviewed for palette accuracy.

Q: Is Catppuccin free? A: Yes. All ports and the core palette are released under the MIT License.

Sources

• https://github.com/catppuccin/catppuccin
• https://catppuccin.com/