Now with AI-powered page building via MCP Server
Documentation

Theming

Customize the look and feel of your site using CSS variables and Tailwind CSS v4.

Last updated: January 20, 2026

Color System

Cmssy uses OKLCH color values defined as CSS variables. The theme is split into semantic tokens that adapt to light and dark modes:

  • --background / --foreground — page background and text
  • --primary / --primary-foreground — primary action buttons
  • --muted / --muted-foreground — subtle backgrounds and helper text
  • --card / --card-foreground — card surfaces
  • --border — default border color
  • --destructive — error and danger states

Customizing Colors

Edit the :root block in styles/main.css to change your color palette. Use OKLCH values for perceptual uniformity:

Dark Mode

Dark mode is controlled by the .dark class on the root element. Override the same variables in the .dark selector:

Tailwind CSS v4

The project uses Tailwind CSS v4 with CSS-first configuration. Key differences from v3:

  • No tailwind.config.js — everything lives in CSS
  • @theme inline maps CSS variables to Tailwind utilities
  • @source directives tell Tailwind which files to scan for class names
  • Gradient classes use bg-linear-to-r instead of bg-gradient-to-r
  • Shadow scale shifted: shadow-sm in v4 = old bare shadow

Border Radius

Border radius uses a base --radius variable. All radius tokens are derived from it:

  • rounded-sm = calc(var(--radius) - 4px)
  • rounded-md = calc(var(--radius) - 2px)
  • rounded-lg = var(--radius) (10px default)
  • rounded-xl = calc(var(--radius) + 4px)
styles/main.css
1:root {
2 --radius: 0.625rem;
3 --background: oklch(1 0 0);
4 --foreground: oklch(0.145 0 0);
5 --primary: oklch(0.6 0.25 292);
6 --primary-foreground: oklch(0.985 0 0);
7 --muted: oklch(0.97 0 0);
8 --muted-foreground: oklch(0.556 0 0);
9 --border: oklch(0.922 0 0);
10}
OKLCH Colors

OKLCH provides perceptually uniform colors — two colors with the same lightness value actually look equally bright. Use the OKLCH color picker to find values. Format: oklch(lightness chroma hue).

Tailwind v4 Class Changes

If you're coming from Tailwind v3, watch out for renamed utilities: shadow-smshadow-xs, rounded-smrounded-xs, outline-noneoutline-hidden, bg-gradient-*bg-linear-*. The scale shifted down by one step.