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.
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.
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.
Spacing & radii
4px base spacing scale; soft 8–28px corner radii.
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.
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.
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.
<!-- 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); }
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.
Badges & status
Status pills in the HUD voice: mono, uppercase, paired with semantic tinted fills. A blinking dot marks live state only.
Cards
Surface-step containers with a 1px hairline. Hover lifts the border and adds a soft halo — never an ambient one.
Tabs & segmented
Tabs (role="tab", arrow-key navigation) and segmented controls (aria-pressed). The active segment carries the signal; the rest stays muted grey.
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.
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.
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.
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.
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.
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.
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.
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.
| Token | From | Device | What changes in the app shell |
|---|---|---|---|
| --bp-sm | 480 | Large phone | Grids may take two columns |
| --bp-md | 768 | Tablet | Two-column forms, master–detail; navigation is still a drawer |
| --bp-lg | 1024 | Laptop | Navigation becomes a persistent sidebar, the menu button disappears |
| --bp-xl | 1440 | Desktop | The inspector docks as a third column (below: opens as a panel) |
| --bp-2xl | 1920 | Full HD · ultrawide | Inspector widens to 400 px; content stays capped at --container-wide (1600 px) |
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.
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.
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.
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.
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.
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.
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.
Guidelines
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.
Flat, not flat-boring
Depth = surface step (bg-1 → bg-2 → bg-3) + a 1px hairline. No stacked drop-shadows.
Glow is a state, not a style
Halos appear on hover / focus / active and on live data — never ambiently on static cards.
Mono is the HUD voice
Labels, metrics, statuses and timestamps use JetBrains Mono, uppercase, 0.14em tracking.
Soft corners, precise motion
12–20px radii keep it friendly; 200ms ease-out transitions keep it sharp. No bounces.
No emoji
Status is shown with neon dots, mono labels and Lucide outline icons — never emoji.
Consume aliases, not values
Components use --color-*, --ring-focus, --z-*. Primitives are only for defining aliases — that keeps theming a one-line change.
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.
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(--…).
| Preview | Token | Dark / default | Light | Note |
|---|---|---|---|---|
| Loading tokens… (serve the folder over HTTP — see README) | ||||