Use a firm text neutral
Choose charcoal, plum-black, or blue-gray foreground instead of a darker version of every pastel.
Pastel Codex theme
Pastel themes are defined by low chroma and high lightness, not by weak contrast. Soft pink, lavender, mint, peach, and sky can support serious work when text, borders, and active states use a firmer neutral structure.
Design perspective
Start with a dark foreground and decide which pastel owns the canvas, which belongs to elevated surfaces, and which is reserved for the accent. Equal amounts of several soft colors can make the workspace feel like an undifferentiated gradient.
Artwork should use large mineral, cloud, or paper-like forms. Keep highlights away from white panels, because a pale background and a translucent light surface can erase the very edge that defines the interface.
Adaptation guide
Choose charcoal, plum-black, or blue-gray foreground instead of a darker version of every pastel.
Add a visible border or luminance step where white and tinted panels meet a light background.
A slightly stronger accent helps focus rings and selected controls remain recognizable without making the entire palette loud.
If the main panel, sidebar, and controls merge in grayscale, color alone is carrying too much structural work.
Best for
Watch for
Free starting points
Practical answers
They can be, but the pastel color should not carry text contrast by itself. Use a dark neutral foreground, visible borders, and strong focus states, then check the result with a contrast tool.
Muted sky and sage are forgiving because they pair naturally with dark blue-gray or charcoal text. Very pale yellow and pink need more careful surface separation.
Yes. Dark translucent surfaces over soft artwork can create strong depth. Keep the brightest pastel away from code and ensure the overlay does not turn every color muddy.
Continue the brief
A good light theme feels open without becoming a white field with floating controls. Slightly tinted canvases, clear border values, dark neutral text, and restrained highlights make the workspace comfortable in real daylight.
Read the guide →Theme stylesGlass works when translucency creates hierarchy instead of haze. The strongest version uses one atmospheric edge, opaque-enough work surfaces, and borders that remain visible over both bright and dark parts of the artwork.
Read the guide →Use casesDesigners can push a theme beyond generic dark mode, but the best result still behaves like a product surface. It needs a coherent material idea, intentional spacing, accessible interaction states, and artwork that survives real window geometry.
Read the guide →Platforms and setupTheme language can hide an important distinction. Native choices that Codex exposes in Appearance are different from a downloadable pack's visual tokens, and both are different from an advanced background supplied by an unofficial local compatibility layer.
Read the guide →