ZeroToSaaS Accessibility Theme Suite
An enterprise-grade suite of 20 medically optimized, mathematically verified accessible Themes (10 light + 10 night) for Google Antigravity IDE, Windsurf / Cascade, Visual Studio Code, Cursor, VSCodium, and OpenVSX.
Featuring an active Semantic Cognitive Status System (Safe ๐ข โ Caution ๐ก โ Warning ๐ โ Panic ๐ด), a built-in Accessible Error Lens, Debounced High-Performance Decoration Engine, Universal Alternating Indent Shading, and Contextual File Adaptation across 19+ programming languages.
This page is styled with ZeroToSaaS design tokens. Use the theme switcher bar above to preview all 20 variants โ every color on this page (headings, links, tables, code blocks, borders) updates instantly.
Documentation Index
| Document | Description |
|---|---|
| Themes Reference | All 20 theme variants (10 light + 10 night) with canvas colors, chromatic identities, CVD mappings, and day/night auto-switch setup. |
| Developer Health & Ergonomics | Ophthalmological rationale for light-mode-first design, pupil constriction optics, astigmatism halation elimination, age-graded ergonomics, CVD inclusivity, and the 20-20-20 clinical checklist. |
| Security & Human Firewall | Semantic Cognitive Status System, secret detection regexes (AWS, GitHub, Slack, JWT, private keys, DB URIs), code-smell prevention, and granular scanner toggles. |
| IDE Features & Tooling | Built-in Error Lens with Git blame, debounced decoration engine, indent shading, log file audit trails, recommended typography, supported IDEs, and installation instructions. |
| Cross-Platform: Tokens & Terminals | Design token exports (CSS, Tailwind v3/v4, Figma/Style Dictionary) and terminal color schemes (iTerm2, Terminal.app, Windows Terminal, Alacritty, Kitty, Ghostty, Warp) for all 20 themes. |
| Validation Report | Empirical quad-system validation report with figures (OkLCH, Paul Tol CVD, ColorBrewer, FM 100-Hue, WCAG AAA, APCA). |
| Medical Guidelines | Clinical ophthalmology citations and ergonomic guidelines underpinning the theme design. |
| Wellness & Focus Report | Full design and phased implementation plan for the wellness layer (Guardian, Eye-Break v2, Blink Coach, FocusFlow/Pomodoro). |
| Status Bar Widget Spec | Requirement spec for the persistent $(shield) ZeroToSaaS [AAA] status bar badge with quick-access menu. |
| Settings UI Grouping Spec | Requirement spec for scoped settings groups and ordering in the Preferences UI. |
| APCA Gap Remediation Spec | Requirement spec for closing 400 APCA L^c contrast gaps across the 20 themes. |
| Native-Setting Audit | Audit of zerotosaas.* settings for duplication of native VS Code/VSCodium capabilities. |
| Distribution Plan | npm package for design tokens + terminal bundles for all 7 terminals. |
| License & Contributing | AGPLv3 license terms, AGPL header templates for 6 language families, and Contributor License Agreements (ICLA/CCLA). |
| APCA Gap Catalogue | Machine-readable catalogue of 400 APCA (WCAG 3.0 draft) L^c contrast gaps across the 20 themes, for future palette audit. |
| Interactive Gallery | Live in-browser theme showcase and playground with code samples. |
Executive Manifesto
Software engineering is one of the most visually and cognitively demanding professions in the modern knowledge economy. For decades, the developer tooling ecosystem has relied on uncalibrated, high-glare, or unscientific dark themes that aggravate astigmatism, induce ciliary eye strain, and fail accessibility mandates.
ZeroToSaaS bridges three critical engineering pillars:
- Human Health & Ocular Physiology โ Protecting developers from Computer Vision Syndrome (CVS), astigmatic halation blur, and premature ocular fatigue through scientifically calibrated positive polarity. โ Full rationale
- Universal Accessibility & Inclusion โ Colorblindness-calibrated palettes (Deuteranopia, Protanopia, Tritanopia) and ISO 9241-303 high-contrast options with 100% WCAG AAA contrast compliance. โ Theme variants
- Digital Security & Privacy Compliance โ Turning syntax highlighting into an active Human Firewall that visually flags exposed secrets, UUIDs, cryptographic hashes, and hardcoded strings before they enter version control. โ Full details
Quad-System Compatibility
| System | Standard | Implementation |
|---|---|---|
| OkLCH Color Space | Modern Web / Design | Perceptual lightness invariant, zero glare (C โค 0.010) |
| Paul Tol CVD-Safe | SRON / Medical Research | Photoreceptor wavelength isolation across Deuteranopia, Protanopia, Tritanopia |
| ColorBrewer Scales | Information Architecture | Qualitative, Sequential, Diverging scale classification |
| FM 100-Hue System | Clinical Ophthalmology | 4-Quadrant optometric separation for alert/type/structure/function tokens |
Plus APCA 0.0.98G (WCAG 3.0 draft) L^c perceptual contrast scoring with soft-gate gap tracking.
Validation
Every theme release is mathematically asserted via our automated multi-tier validation engine:
pnpm run validate
This checks WCAG AAA (โฅ 7:1) โ the hard gate โ plus APCA L^c (WCAG 3.0 draft, soft gate), OkLCH uniformity, Paul Tol ฮE, ColorBrewer scales, FM 100-Hue quadrants, and polarity sanity across all 20 themes.
Development & Build
git clone https://github.com/zerotosaas-in/zerotosaas-accessibility-theme-suite.git
cd zerotosaas-accessibility-theme-suite
pnpm install
# Generate all 20 themes + IDE configs + gallery + tokens + terminals
pnpm run build
# Regenerate only design tokens + terminal schemes
pnpm run tokens
# Run WCAG AAA + APCA contrast validation
pnpm run validate
# Package into VSIX
pnpm run package
License
AGPLv3 โ GNU Affero General Public License v3.0. See License & Contributing for full terms, AGPL header templates, and CLA instructions.