Catppuccin Macchiato Theme: Colors, Uses, and Setup Tips

Catppuccin Macchiato is the middle dark flavor in the Catppuccin family. It sits between the lifted, muted Frappé palette and the deep, color-rich Mocha palette, making it a practical choice for people who want one dark theme across changing light conditions.

Macchiato keeps Catppuccin's familiar purple-navy background and pastel syntax colors, but it leaves more room for comments, sidebars, borders, and inactive controls than Mocha. For many everyday displays, that balance matters more than maximum darkness.

What is the Catppuccin Macchiato theme?

Macchiato uses Base #24273a, a medium-deep purple-navy. Mantle #1e2030 and Crust #181926 create darker surrounding layers, while Text #cad3f5 provides the main foreground. The theme is unmistakably dark, but it does not push the editor canvas as close to black as Mocha.

The official Catppuccin palette describes Macchiato as medium contrast with gentle colors. That is an accurate summary of its role. The colorful accents stay soft enough to feel cohesive, yet the background gives them clearer separation than Frappé.

Macchiato is therefore less of a compromise than a center point. It is the flavor to try when you want the Catppuccin dark aesthetic and do not yet know how deep or muted your display and room can support.

Key Catppuccin Macchiato colors

The complete Catppuccin hex palette includes every Macchiato accent, foreground, overlay, and surface color.

Where Macchiato works best

Macchiato is at home in the ordinary conditions that are difficult to photograph: a room that is bright at 3 p.m., dim at 7 p.m., and lit by one desk lamp later at night. It remains dark throughout that change without demanding the shadow detail that Mocha expects.

It is also a strong default for laptop work. Many laptop panels have adequate color but a weak black floor, especially when viewed off-axis or at reduced brightness. Macchiato keeps the theme's depth while making the intermediate surfaces easier to distinguish.

For long coding sessions, that means less effort spent locating the non-code parts of the editor. The file tree, tabs, gutter, comments, and status bar can remain quiet without falling out of the interface.

Macchiato versus Frappé and Mocha

The three dark flavors form a useful progression. Frappé Base is #303446, Macchiato Base is #24273a, and Mocha Base is #1e1e2e. Moving downward increases the sense of depth and makes the pastel accents appear brighter.

Frappé is better if Macchiato still feels too dense under office lighting or if you prefer lower color intensity. Mocha is better if Macchiato looks gray in a dark room and you want the strongest separation between background and accent colors.

Macchiato wins when neither extreme solves a real problem. It is dark enough to look intentional and light enough to remain forgiving. That makes it a sensible baseline before changing individual colors.

How Macchiato handles readability

Macchiato's primary Text is clear against Base, but its secondary roles remain intentionally restrained. Overlay 0 at #6e738d often carries comments or low-priority labels. Whether that feels elegant or faint depends on the port, font weight, monitor, and room light.

Test active and inactive states rather than only syntax. Open two panes, select text, inspect diagnostics, switch tabs, and look at an unfocused window. A good port should preserve the difference between Base, Mantle, Crust, Surface, and Overlay roles throughout those states.

If the comments are the only weak point, change the comment style or role assignment instead of switching to an unrelated palette. If the entire interface feels submerged, Frappé is the cleaner fix.

Using Macchiato across your setup

Macchiato is especially easy to extend across adjacent apps because it is neither extremely deep nor unusually muted. An editor, terminal, browser, and notes app can share the same flavor without every window becoming a black rectangle or a gray panel.

Start with the app you read most. The Catppuccin VS Code guide explains how to choose the flavor and check editor settings. The Catppuccin Neovim guide covers the equivalent setup in Lua.

Keep the accent color consistent at first. Changing Mauve to Blue in one port may be harmless, but changing accents in every app before checking the base flavor makes it harder to identify what is actually uncomfortable.

When not to choose Macchiato

Macchiato is not ideal if you already know you need a light theme during the day. Latte will handle window reflections and bright rooms more directly. It is also unnecessary if you have a dark room, an excellent display, and specifically want Mocha's deepest presentation.

The middle option is valuable when it matches your environment, not because compromise is automatically safer. If Frappé or Mocha immediately solves the problem you see, use it.

A practical Macchiato setup checklist

1. Select Macchiato explicitly in the maintained port.
2. Check the editor Base, sidebar, comments, gutter, and active selection.
3. Use Macchiato terminal colors rather than reusing a Mocha profile.
4. Test once in daylight and once after sunset.
5. Move to Frappé or Mocha before making broad palette overrides.

For the structure behind those roles, use the complete Catppuccin theme guide.

Catppuccin Macchiato FAQ

Is Catppuccin Macchiato a dark theme?

Yes. Macchiato is the middle of Catppuccin's three dark flavors, between Frappé and Mocha.

What is the Catppuccin Macchiato background color?

The main Base color is #24273a. Mantle is #1e2030, and Crust is #181926.

Is Macchiato lighter than Mocha?

Yes. Macchiato has a lighter Base and slightly gentler overall contrast than Mocha.

Is Macchiato the best Catppuccin flavor for coding?

It is a strong general-purpose choice because it balances a dark canvas with visible secondary UI. The best flavor still depends on the display and ambient light.

Color values and flavor descriptions follow the official Catppuccin palette and official style guide.