Design system

Style guide

Reference documentation for Zapp Energy CSMS. Use this guide to align new screens with tokens, type, and interaction patterns. For UI patterns, see the component library.

color

Color

Semantic tokens, surfaces, borders, and accent usage for light-on-dark UI.

All tokens are defined in tailwind.config.js under theme.colors. Use Tailwind utilities such as bg-Msurfacesurfaceprimary, text-Mtexttextsecondary, and border-Mborderborderprimary instead of raw hex in components.

Brand & accent

Primary brand is orange (`Mmaincolorgreen` retains legacy naming from the green theme). Use for CTAs, active states, and focus rings.

Mmaincolorgreen

#ea580c

Primary accent, buttons, active nav indicator

Tailwind: bg-Mmaincolorgreen · text-Mmaincolorgreen · border-Mmaincolorgreen

Mmaincolorlightgreen

#9a3412

Darker accent / hover emphasis

Tailwind: bg-Mmaincolorlightgreen · text-Mmaincolorlightgreen · border-Mmaincolorlightgreen

Msurfacesurfacebrand

#ea580c

Brand surface token (matches accent)

Tailwind: bg-Msurfacesurfacebrand · text-Msurfacesurfacebrand · border-Msurfacesurfacebrand

Mtexttextbrand

#fb923c

Brand-tinted text, links on dark

Tailwind: bg-Mtexttextbrand · text-Mtexttextbrand · border-Mtexttextbrand

Mbrandchipbg

#451a03

Brand chip / badge background

Tailwind: bg-Mbrandchipbg · text-Mbrandchipbg · border-Mbrandchipbg

Mbrandchipborder

#9a3412

Brand chip border

Tailwind: bg-Mbrandchipborder · text-Mbrandchipborder · border-Mbrandchipborder

App canvas & surfaces

Layered dark neutrals: app background sits darkest; primary surface is for cards and header; secondary for sidebar and tertiary fills.

Mbgapp

#09090b

Global app background behind main column

Tailwind: bg-Mbgapp · text-Mbgapp · border-Mbgapp

Msurfacesurfaceprimary

#18181b

Cards, modals, top bar, main panels

Tailwind: bg-Msurfacesurfaceprimary · text-Msurfacesurfaceprimary · border-Msurfacesurfaceprimary

Msurfacesurfacesecondary

#111113

Sidebar / chrome step down from primary

Tailwind: bg-Msurfacesurfacesecondary · text-Msurfacesurfacesecondary · border-Msurfacesurfacesecondary

Msurfacesurfacetertiary

#27272a

Hover rows, subtle fills, inactive chips

Tailwind: bg-Msurfacesurfacetertiary · text-Msurfacesurfacetertiary · border-Msurfacesurfacetertiary

Mneutralbgsecondary

#0c0c0e

Alternate deep neutral background

Tailwind: bg-Mneutralbgsecondary · text-Mneutralbgsecondary · border-Mneutralbgsecondary

Mneutralgray

#27272a

Legacy neutral gray surface

Tailwind: bg-Mneutralgray · text-Mneutralgray · border-Mneutralgray

Mneutralwhite

#18181b

Named “white” — dark slot in legacy palette

Tailwind: bg-Mneutralwhite · text-Mneutralwhite · border-Mneutralwhite

Text

Primary body copy is near-white; secondary for metadata; invert for placeholders and muted labels.

Mtexttextprimary

#fafafa

Headings, primary body

Tailwind: bg-Mtexttextprimary · text-Mtexttextprimary · border-Mtexttextprimary

Mtexttextsecondary

#a1a1aa

Supporting text, descriptions

Tailwind: bg-Mtexttextsecondary · text-Mtexttextsecondary · border-Mtexttextsecondary

Mtexttextinvert

#71717a

Muted / placeholder tone

Tailwind: bg-Mtexttextinvert · text-Mtexttextinvert · border-Mtexttextinvert

Msurfacesurfaceinvert

#fafafa

Icon stroke on dark chrome (semantic invert)

Tailwind: bg-Msurfacesurfaceinvert · text-Msurfacesurfaceinvert · border-Msurfacesurfaceinvert

Border

Single default border token for dividers and hairlines on dark surfaces.

Mborderborderprimary

#27272a

Default borders, table rules, inputs

Tailwind: bg-Mborderborderprimary · text-Mborderborderprimary · border-Mborderborderprimary

Gray scale (Mgray)

Numeric scale where higher numbers are lighter (tuned for dark UI). Use for progressive contrast, not only as text.

Mgray50

#18181b

Step 50 — deep

Tailwind: bg-Mgray50 · text-Mgray50 · border-Mgray50

Mgray100

#27272a

Step 100

Tailwind: bg-Mgray100 · text-Mgray100 · border-Mgray100

Mgray200

#3f3f46

Step 200

Tailwind: bg-Mgray200 · text-Mgray200 · border-Mgray200

Mgray300

#52525b

Step 300

Tailwind: bg-Mgray300 · text-Mgray300 · border-Mgray300

Mgray400

#71717a

Step 400

Tailwind: bg-Mgray400 · text-Mgray400 · border-Mgray400

Mgray500

#a1a1aa

Step 500

Tailwind: bg-Mgray500 · text-Mgray500 · border-Mgray500

Mgray600

#d4d4d8

Step 600

Tailwind: bg-Mgray600 · text-Mgray600 · border-Mgray600

Mgray700

#e4e4e7

Step 700

Tailwind: bg-Mgray700 · text-Mgray700 · border-Mgray700

Mgray800

#f4f4f5

Step 800

Tailwind: bg-Mgray800 · text-Mgray800 · border-Mgray800

Mgray900

#fafafa

Step 900 — lightest gray

Tailwind: bg-Mgray900 · text-Mgray900 · border-Mgray900

Semantic status

Alerts and inline feedback. Pair with icons or labels for accessibility.

Malertssucces

#4ade80

Success states

Tailwind: bg-Malertssucces · text-Malertssucces · border-Malertssucces

Malertswarning

#facc15

Warning states

Tailwind: bg-Malertswarning · text-Malertswarning · border-Malertswarning

Malertserror

#f87171

Error / destructive emphasis

Tailwind: bg-Malertserror · text-Malertserror · border-Malertserror

Status chips

Background + border pairs for compact error/warning chips.

Merrorchipbg

#3f1518

Error chip fill

Tailwind: bg-Merrorchipbg · text-Merrorchipbg · border-Merrorchipbg

Merrorchipborder

#7f1d1d

Error chip border

Tailwind: bg-Merrorchipborder · text-Merrorchipborder · border-Merrorchipborder

Mwarningchipbg

#422006

Warning chip fill

Tailwind: bg-Mwarningchipbg · text-Mwarningchipbg · border-Mwarningchipbg

Mwarningchipborder

#a16207

Warning chip border

Tailwind: bg-Mwarningchipborder · text-Mwarningchipborder · border-Mwarningchipborder

Forms

Input backgrounds sit slightly above panel surface for affordance.

Minputbg

#141416

Text fields, selects (dark fill)

Tailwind: bg-Minputbg · text-Minputbg · border-Minputbg

typography

Typography

Type scale, font family, weights, and hierarchy for headings and body.

Typography uses Space Grotesk (see tailwind.config.js → fontFamily.SpaceGrotesk and globals.css → font-SpaceGrotesk). Scale utilities live in font.css; many steps are responsive (mobile-first base size, larger breakpoints step up).

Font weights

Common patterns: font-normal for UI labels, font-medium for nav and buttons, font-semibold for titles and KPIs.

font-normal — Page metadata
font-medium — Section label
font-semibold — Page title

Type scale

Apply with utility classes text__12–text__72. Specs below summarize font.css breakpoints.

text__12

12px fixed

The quick brown fox — captions, labels, nav hints.

text__14

12px → lg:14px

The quick brown fox — body, forms, table cells (default UI size).

text__16

14px → lg:16px

The quick brown fox — intros, list leading text.

text__18

16px → lg:18px

The quick brown fox — card titles, subsection headings.

text__20

18px → lg:20px

The quick brown fox — featured titles.

text__24

18px → md:20px → lg:24px

The quick brown fox — screen section headers.

text__32

20px → sm:24px → md:28px → lg:32px

The quick brown fox — page heroes.

text__36

20px → sm:24px → md:28px → lg:36px

The quick brown fox — marketing emphasis.

text__40

24px → md:28px → lg:32px → xl:40px

The quick brown fox — large display.

text__46

24px → md:28px → lg:32px → xl:46px

The quick brown fox — hero secondary.

text__48

24px → sm:28px → lg:32px → xl:48px

The quick brown fox — hero primary.

text__56

28px → md:32px → lg:48px → xl:56px

The quick brown fox — oversized display.

text__64

32px → md:40px → lg:50px → xl:64px

The quick brown fox — landing impact.

text__72

32px → sm:46px → md:50px → lg:64px → xl:72px

The quick brown fox — maximum scale.

style

Style

Spacing, layout grids, radii, icons, and component-level conventions.

Content will be added soon

Specifications and live examples will appear here in a future update.

effects

Effects

Shadows, focus rings, motion, and elevation patterns across the shell.

Motion and depth are intentionally restrained: short transitions on chrome and lists, layered shadows for dropdowns and auth panels, accessible focus rings on interactive controls, and a light scrim when the mobile drawer is open.

Shadows & elevation

Auth shell

shadow-[0px_20px_25px_-5px_rgba(0,0,0,0.12),0px_8px_10px_-6px_rgba(0,0,0,0.08)]

Split login / register container

Dropdown / popover (standard)

shadow-[0px_12px_16px_-4px_rgba(16,24,40,0.08),0px_4px_6px_-2px_rgba(16,24,40,0.03)]

Profile menu, selects

Card hover

hover:shadow-md transition-all duration-200

Station / session list tiles

Floating panel (deep)

shadow-[0px_30px_50px_#0000002e]

Region picker overlays

Focus rings

Prefer focus-visible so keyboard users get a clear ring without mobile tap chrome clutter.

Icon button (header pattern)

Plan tier (emphasis ring)

Highlighted tier

Transitions & overlay

Duration 200ms

transition-all duration-200

Hover row (settings tabs, cards)

Duration 300ms

transition-all duration-300

Sidebar / header width animations

Mobile drawer scrim

bg-[rgba(23,23,23,0.2)] fixed full-screen

Dimmed backdrop when menu open

Form focus (Bootstrap dark)

Controlled in globals.css for [data-bs-theme="dark"]: focus border #ea580c with box-shadow: 0 0 0 0.2rem rgba(234, 88, 12, 0.2).