All projects

Developer tools

NexQL Themes

A VS Code colour-theme family built for database work and everyday coding.

Why it existsDatabase work means hours of reading SQL. These themes quiet the tokens you see most and reserve a single accent for errors, so the thing that needs attention is the thing that stands out.

39 scenario-anchored variants — dark, light, OLED, homage, seasonal and more — sharing one design language: quiet keywords, a cool-to-warm syntax spectrum and a single accent reserved for errors.

Stars
0
Forks
1
Last push
Updated 8 days ago

Languages

JavaScript72.2%
Astro18.6%
CSS5.7%
TypeScript2.4%
Makefile1.1%
README.md

NexQL Themes

NexQL Themes logo

Preview NexQL Themes live ••• NexQL DB Extension for VS Code

NexQL Themes — a VS Code color-theme family for database work and everyday coding. 39 scenario-anchored variants (dark, light, OLED, homage, environment, seasonal and more) share one design language: quiet keywords, a disciplined cool→warm syntax spectrum, and a single reserved accent for errors.

Install from the VS Code Marketplace or Open VSX, then Preferences: Color Theme → pick any NexQL theme.

Philosophy

The logo — a glowing N woven from fiber-optic strands over a dark IDE canvas — encodes how every theme in the family is meant to feel and behave.

Brand

PrincipleDefinition
Vibrancy in the darkNear-black or warm-paper foundations with energetic, high-contrast syntax color. Reduce eye strain without going gray and lifeless.
Fluid integrationIntertwined strands stand for SQL, data, and modern application code living in one editor — one coherent visual system across languages and tools.
Energy and flowThe cool→warm gradient (teal → violet → amber) mirrors scan rhythm: structure first, data last. Color guides the eye without shouting.
Developer-first precisionBuilt for the nuances of real coding — brackets, keywords, types, strings, errors — not generic prettiness. Every hue earns its place in the hierarchy.

Design language

PrincipleDefinition
Quiet keywordsHigh-frequency tokens (keywords, operators, punctuation) stay desaturated. Syntax noise stays low; meaning stays readable.
Spectrum in code onlyThe ribbon runs through the editor: cool structure (keywords, functions) → warm data (strings, numbers). Chrome stays calm; color lives in tokens.
One reserved accentMagenta (#E85FBF) is errors only — never reused for strings, types, or UI chrome. One unmistakable signal for "something is wrong."
Frequency ∝ inverse saturationThe more often a token appears, the quieter its color. Rare constructs (types, errors) may be brighter or more saturated.
Scenario-anchored variantsEach theme answers a real context — cool navy (Mute), OLED black, long-session warmth (Ember), warm daily dark (Drift), light parchment (Break of Dawn), Postgres homage, sage pair — without breaking the shared rules above.

Token tiers (flagship dark reference)

Applies to NexQL Mute Dark and close dark variants; light themes remap the same roles to their surfaces.

TierTokensHex
QuietKeywords, operators, punctuation#8E8FB8
BodyVariables, parameters, tables#D8D6E0
ScanFunctions / methods#7AA8E8
DataStrings + numbers#D9A86C
RareTypes / classes / interfaces#B68CDB
ReservedErrors only#E85FBF

Themes

ThemeTypeNotes
NexQL Mute DarkdarkDeep navy with muted indigo keywords, soft pink functions, peach strings
NexQL OLED DarkdarkDrift palette on true-black AMOLED surfaces
NexQL Ember DarkdarkWarmer, higher-contrast dark for long sessions
NexQL Drift DarkdarkWarm near-black daily driver — indigo UI accent, quiet syntax spectrum
NexQL Break of DawnlightSolar-powered light with warm parchment surfaces
NexQL Claudy DaylightClaude Code–inspired warm parchment
NexQL Claudy NightdarkInk-dark counterpart to Claudy Day
NexQL Postgres Homage DarkdarkPostgres #336791 homage — slate-blue, amber data
NexQL Postgres Homage DaylightLight Postgres homage
NexQL Sage DaylightSage-green light pair
NexQL Sage at NightdarkSage-tinted dark counterpart

NexQL extension colors

Each theme also sets the NexQL extension's brand colors so its UI matches the active theme: nexql.accent (the theme's focus color) and nexql.accentForeground; nexql.ribbon.* (blue, indigo, purple, magenta, orange, amber; darkened on light themes); nexql.mode.read|write|admin and postgres.envProd|envStaging|envDev (mapped from the theme's success/warning/error colors). Accent and mode colors are contrast-checked against the editor background.

Development

npm run compile    # generate themes/*.json + validate

Generated workbench/token keys come from src/. Any extra keys already in a theme JSON (e.g. widget.border) are kept on compile — only generator-owned keys are refreshed.

Press F5 → Launch NexQL Theme Extension, then Preferences: Color Theme → any NexQL theme.

Architecture

src/static-themes.mjs         theme registry (11 hand-authored themes)
src/preview-workbench.mjs     workbench color builder
src/preview-tokens.mjs        SQL-first token rules
scripts/generate-previews.mjs compile + package.json contributes.themes
scripts/validate-themes.mjs   structure + WCAG contrast checks

Website

The marketing site (https://nexql-themes.astrx.dev) is an Astro project in site/. It renders every theme statically from the built themes/*.json, and serves those files at /themes/<file>.json (with Access-Control-Allow-Origin: *) for other NexQL sites.

npm run compile                 # themes must be built first
npm --prefix site install
npm --prefix site run dev       # http://localhost:4322 (copies themes into site/public, refreshes the brand CSS)
npm --prefix site run build     # site/dist

site/scripts/sync-brand.mjs refreshes site/src/styles/brand.css from the sibling mcp checkout when it is present; the committed copy is what deploys.