opensourceprojects.dev

A broadsheet for software that doesn't ask for your email

Catppuccin Discord themes in four flavors, with accent color options
GitHub RepoImpressions3

Project Description

View on GitHub

Catppuccin Brings Its Soothing Palette to Discord, With Four Flavors and Accent Options

You spend hours in Discord every day. If the default dark theme feels a little harsh on your eyes (or just a little boring), you've probably thought about theming it. The problem is that most Discord themes are either over-designed or maintained by one person who stopped updating six months ago. Catppuccin's Discord port takes a different approach: it's a clean, well-maintained theme based on a popular color palette, and it ships in four flavors with customizable accent colors.

What It Does

This is a theme package that applies the Catppuccin color scheme to Discord. It comes in the four standard Catppuccin flavors: Latte (light), Frappé, Macchiato, and Mocha (dark). Each flavor is distributed as a CSS file that you can apply through one of three methods: BetterDiscord, any client or mod that supports custom CSS, or Stylus.

The theme is distributed in two forms. For BetterDiscord users, there are downloadable .theme.css files for each flavor. For everyone else, the project hosts pre-built CSS files on GitHub Pages that you can import directly with an @import statement. There's also a .user.css file specifically for Stylus users, which adds a preference dropdown so you can switch between flavors and accent colors without editing code.

The accent color system is worth noting. Beyond the four base flavors, you can append an accent color to the file name (like catppuccin-mocha-pink.theme.css or catppuccin-frappe-maroon.theme.css), which gives you a themed Discord that matches whatever Catppuccin accent you prefer. It's a small detail, but it means the theme doesn't lock you into one look.

Why It's Cool

  • It respects your existing setup. The README doesn't assume you're using one particular client mod. Whether you're on BetterDiscord, some other custom-CSS-supporting client, or Stylus, there's a path for you. That's more considerate than most Discord themes, which tend to pick a lane and stay there.

  • The auto-switching trick is genuinely useful. The FAQ includes a snippet for switching between Latte in light mode and Mocha in dark mode using the prefers-color-scheme media feature. You append the media query after each @import statement, and Discord follows your system's light/dark setting automatically. It's a clever use of standard CSS that most people wouldn't think to set up on their own.

  • Honest about the risks. The FAQ doesn't dance around the fact that using third-party clients and injecting custom CSS is against Discord's ToS. It notes that nobody has been banned for simply using client mods, but it's clear that you're using this at your own discretion. That kind of transparency is refreshing—too many theme projects bury that disclaimer or skip it entirely.

  • The distribution model is simple. Hosting pre-built CSS on GitHub Pages means you don't have to clone the repo or build anything. You copy one line into your CustomCSS file, and you're done. For Stylus users, the install flow is a single click plus a dropdown selection. Low friction all around.

  • It's part of a larger ecosystem. Catppuccin themes exist for a huge range of applications, so if you already use Catppuccin elsewhere (your terminal, your editor, your browser), this makes Discord consistent with the rest of your setup. That consistency is the whole point of a palette like this.

How to Try It

The method you use depends on your setup.

If you're on BetterDiscord:

  1. Download your preferred flavor from the repo's themes folder—Latte, Frappé, Macchiato, or Mocha.
  2. Copy the downloaded file into your BetterDiscord themes folder.
  3. Enable the theme in BetterDiscord settings.

If your client or mod supports custom CSS:

Add an @import line to your CustomCSS file or editor. For example, for Mocha:

@import url("https://catppuccin.github.io/discord/dist/catppuccin-mocha.theme.css");

To use an accent color, append it to the filename:

/* mocha with pink accent */
@import url("https://catppuccin.github.io/discord/dist/catppuccin-mocha-pink.theme.css");

/* frappe with maroon accent */
@import url("https://catppuccin.github.io/discord/dist/catppuccin-frappe-maroon.theme.css");

If you're using Stylus:

  1. Enable CSP Patching in Stylus Settings under Advanced.
  2. Install the user style from the repo.
  3. Pick your flavor and accent color from the Stylus preference dropdown.

The repo is at github.com/catppuccin/discord, and the README includes preview images for each flavor if you want to see them before committing.

Final Thoughts

This is a well-scoped theme project that does one thing and does it cleanly. It's not trying to reinvent Discord or add a bunch of features you didn't ask for. It's a color palette applied properly, distributed in a way that works across multiple clients, with enough flexibility to match your preferences. If you already like Catppuccin, this is an easy addition to your setup. If you've never tried it, the preview images in the README will tell you quickly whether it's your style. Just keep the ToS caveat in mind—it's your account, and the maintainers are upfront about that.


Follow @githubprojects for more developer tools and open source projects.

Back to Projects
Project ID: 78318c15-1985-4d35-ad91-cbe598d46ce7Last updated: September 22, 2026 at 07:00 AM