Skip to content
NEONPULSE
Design system · v1.1

NeonPulse

A dark-first, cyberpunk flat-design system for web and app projects. Near-black surfaces, electric neon as signal, a geometric techy type system, and glow used as a state — never as decoration.

New in v1.1 — light theme (toggle top-left), 23 new elements & patterns (inputs, switch, tabs, tooltip, toast, modal, ⌘K palette, table, meter …), self-hosted fonts, docs read straight from the stylesheet. Press ⌘K to search.
Foundations

Colors

~90% of any screen is the near-black surface ramp and cool-grey text. Neon is the ~10% that marks what's interactive or live. Every swatch below is read live from colors_and_type.css for the current theme; text colours show their contrast against the page. Click to copy the token.

Foundations

Typography

Space Grotesk for display, Sora for body, JetBrains Mono for HUD labels & data — self-hosted variable fonts. Display sizes are fluid (clamp()), so headlines scale from phone to desktop without overrides.

Display · Space Grotesk
Body · Sora
HUD · JetBrains Mono
Type scale
Foundations

Spacing & radii

4px base spacing scale; soft 8–28px corner radii.

Spacing scale
Corner radii
Foundations

Elevation & glow

Flat by default. Depth comes from the surface step plus a 1px hairline; neon halos appear only on hover / focus / active and on live data. Halos are derived from the neon hues, so they follow a rebrand automatically.

Glow & elevation
Foundations

Iconography

Lucide outline, 1.9px stroke, currentColor. Three sizes (16/20/24). Icons rest in muted grey and take the signal colour only on hover / active. No emoji, ever. The semantic map gives dev & design one shared name per meaning.

Icons
Foundations

Theming

Dark is the default. Put data-theme="light" on <html> — or on any subtree — and everything below re-resolves: surfaces and text flip, accents switch to a legible ink, semantic colours deepen so every text pairing keeps WCAG AA. Both islands below use identical markup.

data-theme="dark"Online
p99 latency · live
42ms
us-east · 3 nodes
data-theme="light"Online
p99 latency · live
42ms
us-east · 3 nodes
<!-- whole page -->
<html data-theme="light">

<!-- or a single island; nesting works both ways -->
<section data-theme="dark"> … </section>

/* rebrand: swap the hues — gradients, glows, rings and focus edges are derived */
[data-brand="hot"] { --neon-blue: var(--neon-violet); --neon-cyan: var(--neon-magenta); }
Components

Buttons

One canonical .np-btn, four intents (primary · secondary · ghost · danger) across the full state model — rest, hover, focus-visible, active, loading and disabled — all derived from interaction-state tokens, never hand-painted per combination. Plus .np-icon-btn and tooltips.

Buttons · state matrix
Components

Inputs & controls

Fields with labels, hints and the full state set (hover · focus · invalid · disabled), an input group with keyboard hint, and a switch built on a real checkbox — keyboard and screen-reader native. Focus lights a neon edge; the resting state stays flat.

Inputs & controls
Components

Badges & status

Status pills in the HUD voice: mono, uppercase, paired with semantic tinted fills. A blinking dot marks live state only.

Badges & status
Components

Cards

Surface-step containers with a 1px hairline. Hover lifts the border and adds a soft halo — never an ambient one.

Cards
Components

Tabs & segmented

Tabs (role="tab", arrow-key navigation) and segmented controls (aria-pressed). The active segment carries the signal; the rest stays muted grey.

Tabs & segmented
Components

Overlays

Modal (.np-scrim + .np-modal), toast stack in a polite live region, and the ⌘K command palette — the same one that powers search on this page. All sit on the shared --z-* stacking scale.

Modal · toasts · command palette
Components

Data display

Data table with tabular figures and hover rows, usage meter, avatars, keyboard keys, inline code and links — the small parts every product screen needs.

Table · meter · avatar · kbd
Components

Form controls

Checkbox and radio (real inputs, so keyboard and screen readers work), choice cards, textarea, native select, slider and dropzone. Every control has rest, hover, focus, invalid and disabled states; groups use .np-fieldset. On touch devices they grow to the 44 px target and text fields use 16 px.

Checkbox · radio · textarea · select · slider · dropzone
Components

Menus & pickers

Floating surfaces anchored to a trigger: action menu, custom select (listbox) and the date picker (see Date picker), plus chips and the spinner. The CSS places a panel below its trigger (--up, --end flip it); the specimen shows the script that flips on demand and handles arrow keys, Home/End, Enter and Esc. Prefer the native <select> on phones.

Menu · select · date picker · chips · spinner
Components

Date picker

One responsive date picker for a birth date, a booking day and a reporting period. Type the date (separators are added while you type) or pick it: the calendar is a popover from 768 px (--bp-md) and a bottom sheet below with a grab handle and 44 px days. Month and year dropdowns, data-min / data-max (ISO, today, +30d, -18y), disabled weekends, ranges with presets and two months on wide screens. Fully keyboard-operable and locale-aware. The CSS is the component; js/np-datepicker.js (no dependencies) fills and positions the panel and emits np-datepicker:change.

Single · booking · range · states
Phone · 390 pxthe same markup as a bottom sheetOpen full size
Laptop · 1000 pxrange with presets and two months
Components

Navigation controls

Pagination, breadcrumb, stepper, accordion, the phone tab bar and a table that turns into cards. Pagination and the table react to their own width (container queries), so they behave in a narrow column on a wide screen too.

Pagination · breadcrumb · stepper · accordion · tab bar · stacked table
Components

Wordmark & effects

The NeonPulse mark and logotype, the kudesi brand wordmark in the primary pulse gradient, and the starfield scene backdrop. Brand art stays on the dark canvas in both themes.

NeonPulse mark
kudesi wordmark
Starfield · scene backdrop
Patterns

Cards

One canonical .np-card with a defined anatomy (eyebrow · title · metric · body · footer) and variants — stat, live (gradient border), content, interactive, media and row — plus hover / focus / selected states. The reusable building block for any surface.

Card family
Patterns

Layout primitives

Token-driven structure so spacing is never ad-hoc: .np-container, .np-stack (vertical rhythm), .np-cluster (wrapping row), .np-grid (auto-fill) and .np-section. Assemble screens without bespoke margins.

Stack · cluster · grid · section
Patterns

App shell & breakpoints

One responsive foundation for phones, laptops and ultrawide monitors. The system is mobile-first and has exactly five breakpoints. @media cannot read var(), so write the literal px value from the table and never invent another one. Web pages use the centred .np-container; product UIs use .np-appshell.

TokenFromDeviceWhat changes in the app shell
--bp-sm480Large phoneGrids may take two columns
--bp-md768TabletTwo-column forms, master–detail; navigation is still a drawer
--bp-lg1024LaptopNavigation becomes a persistent sidebar, the menu button disappears
--bp-xl1440DesktopThe inspector docks as a third column (below: opens as a panel)
--bp-2xl1920Full HD · ultrawideInspector widens to 400 px; content stays capped at --container-wide (1600 px)
WEB

Container + gutter

.np-container is 1200 px; --prose (680), --wide (1600) and --full change the cap. The side padding is --gutter: 16 px on a phone, growing to 40 px on ultrawide.

APP

Shell + inspector

Top bar, navigation, scrolling main area and an optional inspector. On wide screens the extra space goes to the inspector, not to stretched content. Dashboards that should fill the width add .np-appshell__content--fluid.

TOUCH

Coarse pointers

On pointer: coarse buttons, tabs, rows and icon buttons reach --touch-target (44 px) and text fields use 16 px so iOS doesn't zoom. Glow hovers only apply under hover: hover, so they never stick after a tap.

SAFE AREA

Notches

The shell pads itself with --safe-top/right/bottom/left (the env(safe-area-inset-*) values). Add viewport-fit=cover to the viewport meta tag to use them.

Phone · 390 pxnavigation + inspector are drawers — tap the iconsOpen full size
Laptop · 1280 pxpersistent sidebar, inspector as panel
Ultrawide · 2560 pxsidebar · capped content · docked 400 px inspector
Patterns

Drawer & sheet

Overlays that dock to an edge, both inside a .np-scrim. The sheet is a bottom sheet on phones and becomes a centred dialog from 768 px (--bp-md); the drawer docks to the right (--start for the left) at every size. Both respect the safe areas and use role="dialog" with aria-modal. Open them inside the frames.

Sheet · phone 390 pxbottom sheet with grab handleOpen full size
Sheet · 1000 pxthe same markup as a centred dialog
Drawer · 1000 pxfilters, settings, details
Patterns

Content patterns

The recurring content blocks every product needs: page header, status banners (info · success · warning · danger), empty state, loading skeleton and data list — the three states (empty / loading / error) that are usually forgotten.

Header · banners · empty · loading · list
UI kits

UI kits

Four interactive, high-fidelity products assembled from the system's classes. They are dark-first product mocks, so they stay dark in both doc themes. Open one for the full-size experience — in the dashboard, try ⌘K.

Marketing landinghero · features · pricing · footerOpen
SaaS dashboardcharts · modal · toasts · ⌘KOpen
Mobile appiOS frame · tab bar · settingsOpen
Bank order flow · webopen a current account · 5 steps · from 768pxOpen
Bank order flow · appthe same page below 768px: sticky action bar, sheet for documentsOpen
Usage

Guidelines

01

Dark is the canvas, neon is the signal

Keep ~90% of a screen near-black and grey. Neon marks the one thing that's interactive or live.

02

Flat, not flat-boring

Depth = surface step (bg-1 → bg-2 → bg-3) + a 1px hairline. No stacked drop-shadows.

03

Glow is a state, not a style

Halos appear on hover / focus / active and on live data — never ambiently on static cards.

04

Mono is the HUD voice

Labels, metrics, statuses and timestamps use JetBrains Mono, uppercase, 0.14em tracking.

05

Soft corners, precise motion

12–20px radii keep it friendly; 200ms ease-out transitions keep it sharp. No bounces.

06

No emoji

Status is shown with neon dots, mono labels and Lucide outline icons — never emoji.

07

Consume aliases, not values

Components use --color-*, --ring-focus, --z-*. Primitives are only for defining aliases — that keeps theming a one-line change.

08

Contrast is not optional

Body and label text uses --color-text, -secondary or -muted (all ≥ 4.5:1). --color-text-disabled is for disabled states only.

Usage

Token reference

Generated from colors_and_type.css on page load — it can't drift from the code. Aliases say what a token is for; components consume these. Primitives say what the value is. The light column shows the override from [data-theme="light"]. Click a token to copy var(--…).

PreviewTokenDark / defaultLightNote
Loading tokens… (serve the folder over HTTP — see README)