ZeroToSaaS Accessibility Theme Suite

WCAG AAA Compliant OkLCH Compliant Paul Tol CVD-Safe ColorBrewer Certified FM 100-Hue Calibrated ISO 9241-303 Medical Optics Security Hardened License: AGPL v3

An enterprise-grade suite of 10 medically optimized, mathematically verified accessible Themes 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, configurations, and documentation formats.

Live Demo: Interactive Gallery & Playground Validation Report (420 Assertions Passed) Medical & Ophthalmic Guidelines

🏛️ Executive Manifesto: The ZeroToSaaS Vision

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:

  1. Human Health & Ocular Physiology: Protecting developers from Computer Vision Syndrome (CVS), astigmatic halation blur, and premature ocular fatigue through scientifically calibrated positive polarity (dark text on glare-free light canvases).
  2. Universal Accessibility & Inclusion: Providing colorblindness-calibrated palettes (Deuteranopia, Protanopia, Tritanopia) and ISO 9241-303 high-contrast options with 100% WCAG AAA ($\ge 7:1$) contrast compliance.
  3. 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.

🧬 Quad-System Compatibility Overview

To achieve empirical rigor across these pillars, ZeroToSaaS is mathematically engineered and verified against four industry-standard frameworks:

System Scientific / Industry Standard Core Engineering Implementation
1. 📐 OkLCH Color Space Modern Web / Design Standard Perceptual lightness invariant ($L \approx 42\%-45\%$ keywords, $L \approx 98.5\%$ canvas), zero glare ($C \le 0.010$)
2. 🧪 Paul Tol CVD-Safe SRON / Medical Research Photoreceptor wavelength isolation ($\Delta E_{\text{Ok}} \ge 0.10$) across Deuteranopia, Protanopia, and Tritanopia
3. 🎨 ColorBrewer Scales Information Architecture Qualitative (nominal AST balance), Sequential (Indent guides 1–6), Diverging (Cognitive status alerts)
4. 👁️ FM 100-Hue System Clinical Ophthalmology 4-Quadrant optometric separation ($0^\circ-90^\circ$ Alerts, $90^\circ-180^\circ$ Safe, $180^\circ-270^\circ$ Structure, $270^\circ-360^\circ$ Functions)

📖 Companion Technical Documents:

🔬 Automated Quality & Quad-System Validation

Every theme release is mathematically asserted via our automated multi-tier validation engine asserting WCAG AAA ($\ge 7:1$), OkLCH uniformity, Paul Tol $\Delta E_{\text{Ok}}$, ColorBrewer scales, and FM 100-Hue quadrants:

pnpm run validate

============================================================
📊 Comprehensive Quad-System Validation Summary:
   Total Tests: 420
   Passed: 420
   Failed: 0

🎉 100% OF TOKENS PASS ALL 4 COLOR SYSTEMS:
   ✅ 1. OkLCH Perceptual Lightness Uniformity (Oklab Standard)
   ✅ 2. Paul Tol CVD-Safe Photoreceptor Wavelength Discrimination
   ✅ 3. Cynthia Brewer's ColorBrewer Framework (Qualitative / Sequential / Diverging)
   ✅ 4. Farnsworth-Munsell 100-Hue Quadrant Distribution
   ✅ Plus: 100% WCAG AAA (>= 7:1 Contrast Ratio) Across All Tokens
============================================================

👁️ Developer Health & Ophthalmological Ergonomics

Modern ophthalmology and human-factors ergonomics confirm that Light Mode (dark text on a bright, glare-free background) is optical best practice for reading and auditing code over extended sessions:

1. Pupil Constriction & Optical Depth of Field

Bright ambient screen luminance causes the human pupil to naturally constrict. In optical physics, a smaller aperture increases the depth of field (analogous to stopping down a camera lens). This keeps syntax tokens, punctuation, and identifiers in pin-sharp focus with significantly less physical accommodation effort from the eye’s ciliary muscles.

2. Elimination of “Halation” & Astigmatism Blur

Over 50% of adults suffer from some degree of astigmatism (an irregular cornea curvature). In dark mode (white text on black), dilated pupils expose peripheral cornea imperfections, creating halation—a blurry, glowing aura around letters that forces developers to squint and causes tension headaches. ZeroToSaaS uses positive polarity to completely eliminate halation.

3. Age-Graded Ergonomic Considerations

Visual requirements evolve across a human’s lifespan:

4. Clinical Healthy Usage Checklist

  1. The 20-20-20 Rule: Every 20 minutes, look at an object 20 feet away for 20 seconds.
  2. Monitor Positioning: Align the top of your display at or slightly below eye level (15–20° downward gaze).
  3. Conscious Blink Rate Preservation: Humans blink 66% less when focusing on screens. Consciously blink to re-lubricate the cornea and prevent dry-eye syndrome.

🌐 Universal Inclusivity & Color Vision Deficiency (CVD)

Over 300 million people worldwide live with Color Vision Deficiency. Traditional IDE themes rely carelessly on red/green or blue/yellow pairings that are indistinguishable to CVD engineers.

The Multi-Dimensional Signaling Principle

ZeroToSaaS strictly follows the WCAG 2.1 guideline to never rely on color alone:

🛡️ Digital Security, Data Privacy & Leak Prevention

Data breaches and accidental secret leaks frequently originate from human oversight during rapid development, live coding demonstrations, remote screen shares, and pull request reviews. ZeroToSaaS acts as an active, visual Human Firewall:

Status Description
🔴 Panic Secret Keys, Tokens, DB URIs, Private Keys, JWTs, Hashes, UUIDs, Hex Codes, Regex
🟠 Warning Hardcoded String Literals, Magic Primitives, Unextracted UI Strings
🟡 Caution Function Parameters, Dynamic Arguments, Environment Key Bindings
🟢 Safe Strict Types, Interfaces, Validated Structs, Schemas, Return Types

1. Instant Secret & Credential Leak Prevention (🔴 Panic)

2. Code Smell Prevention & Localization (🟠 Warning)

3. Type Safety & Strict Contracts (🟢 Safe)

🚀 Dual-Impact: Developer IDEs & Enterprise SaaS Applications

The ZeroToSaaS design system is architected for two complementary environments:

  1. Inside the Developer IDE (VS Code, Cursor, Windsurf, VSCodium):
    • Dramatically reduces visual fatigue over 8–12 hour coding sessions.
    • Drastically accelerates code reviews through cognitive status scanning.
    • Catches syntax, security, and type issues without requiring constant mouse hovering.
  2. Across Enterprise SaaS Web Applications:
    • The token palettes, status hierarchies, and contrast standards serve as a production-ready design system for customer dashboards, analytics portals, and cloud platforms.
    • Guarantees 100% WCAG AAA enterprise compliance for institutional clients, government deployments, and educational systems.

🎨 The 20 Accessible Theme Variants (10 Light + 10 Night)

Every variant passes 100% WCAG AAA ($\ge 7:1$) relative luminance tests across all 860 token combinations. Each light theme has a polarity-inverted Night counterpart that preserves hue and chroma for CVD-safe wavelength discrimination.

Light Themes

Theme Variant Canvas Background Chromatic Identity & Mood Target Audience / Medical Standard
ZeroToSaaS Light (Default) #FCFCFD Cobalt Slate & Rich Cedar Universal ergonomic coding; all developers
ZeroToSaaS High Contrast #FFFFFF Stark Monochrome & Midnight Indigo ISO 9241-303; reduced retinal illuminance
ZeroToSaaS Deuteranopia #FAFCFE Deep Oceanic Blue & Warm Amber Green-weakness / Deuteranopia CVD
ZeroToSaaS Protanopia #FCFAFC Jewel Magenta & Arctic Teal Red-weakness / Protanopia CVD
ZeroToSaaS Tritanopia #FAFCFC Regal Crimson & Deep Cyan Blue-Yellow / Tritanopia CVD
ZeroToSaaS Warm Sepia (Brown) #FCFAF6 Warm Parchment & Espresso Soft, low-contrast ambient room lighting
ZeroToSaaS Forest Calm (Green) #F8FCF9 Restorative Sage & Forest Cypress Calming, natural organic visual ambiance
ZeroToSaaS Royal Plum (Purple) #FAF8FD Lavender Mist & Midnight Plum Focused, elegant, high-clarity development
ZeroToSaaS Golden Sand (Yellow) #FCFAF4 Warm Sandstone & Solar Ochre Gentle warm daylight simulation
ZeroToSaaS Terracotta (Orange) #FCF8F4 Spiced Linen & Burnt Terracotta High-energy, warm crisp contrast

Night (Dark) Themes

Theme Variant Canvas Background Chromatic Identity & Mood Target Audience / Medical Standard
ZeroToSaaS Light Night (Default) #0E1116 Dark Cobalt Slate & Glare-Free Canvas Universal night coding; all developers
ZeroToSaaS High Contrast Night #000000 Pure Black & White Borders ISO 9241-303; 21:1 contrast on dark
ZeroToSaaS Deuteranopia Night #0E1419 Dark Oceanic Blue & Warm Amber Green-weakness / Deuteranopia CVD (night)
ZeroToSaaS Protanopia Night #100E12 Dark Jewel Magenta & Arctic Teal Red-weakness / Protanopia CVD (night)
ZeroToSaaS Tritanopia Night #0E1214 Dark Regal Crimson & Deep Cyan Blue-Yellow / Tritanopia CVD (night)
ZeroToSaaS Warm Sepia Night (Brown) #0E0D0B Dark Espresso & Walnut Soft, low-glare ambient night lighting
ZeroToSaaS Forest Calm Night (Green) #0B0E0C Dark Cypress & Cedar Calming, natural organic night ambiance
ZeroToSaaS Royal Plum Night (Purple) #0E0D10 Dark Iris & Midnight Plum Focused, elegant night development
ZeroToSaaS Golden Sand Night (Yellow) #0E0D09 Dark Amber Bronze & Sandstone Gentle warm night simulation
ZeroToSaaS Terracotta Night (Orange) #0F0D0A Dark Burnt Orange & Rich Bronze High-energy, warm crisp night contrast

Day / Night Auto-Switch (Native VS Code / VSCodium)

ZeroToSaaS uses the IDE’s built-in window.autoDetectColorScheme for OS-appearance-based theme switching — no custom timer, no polling, no conflicts with your manual choices. On first run, the extension sets workbench.preferredLightColorTheme and workbench.preferredDarkColorTheme to ZeroToSaaS themes (only if you haven’t configured them already).

To enable OS-appearance-following theme switching:

{
  "window.autoDetectColorScheme": true,
  "workbench.preferredLightColorTheme": "ZeroToSaaS Light (Default)",
  "workbench.preferredDarkColorTheme": "ZeroToSaaS Light Night (Default)"
}

When enabled, the IDE follows your OS appearance setting (macOS System Settings → Appearance, Windows Settings → Personalization → Colors, etc.) and switches between the preferred light and dark themes automatically. Your manual theme choice (via Ctrl+K Ctrl+T) is always respected — the OS-appearance switch only fires when the OS mode itself changes.

⚡ Built-in Developer Ergonomics & Tooling

ZeroToSaaS includes an active extension activator (src/extension.js) providing four built-in IDE features:

1. High-Performance Debounced Engine & Version Guards

2. Built-in Accessible Error Lens & Instant Git Blame

3. Universal Alternating Indent Column Shading

4. Log Files & Audit Trails

Targeted Grammars: .log, Log Language Output

🔤 Recommended Typography & Configuration

For maximum optical acuity and sharpness, pair ZeroToSaaS with modern monospaced fonts:

Recommended settings.json configuration:

{
  "workbench.colorTheme": "ZeroToSaaS Light (Default)",
  "editor.fontFamily": "'Geist Mono', 'JetBrains Mono', 'Fira Code', Menlo, monospace",
  "editor.fontSize": 14,
  "editor.lineHeight": 1.6,
  "editor.letterSpacing": 0.3,
  "editor.fontLigatures": true,
  "editor.semanticHighlighting.enabled": true,

  // ZeroToSaaS Built-in Settings
  "zerotosaas.errorLens.enabled": true,
  "zerotosaas.errorLens.showEntireLineBackground": false,
  "zerotosaas.errorLens.showSeverityBadge": true,
  "zerotosaas.errorLens.showGitBlame": true,
  "zerotosaas.indentShading.enabled": true,
  "zerotosaas.statusBadges.enabled": true,
  "zerotosaas.maxFileSizeKB": 500,
}

📦 Supported IDEs & Installation

The ZeroToSaaS Accessibility Theme Suite is engineered for 100% compatibility across all modern AI-first and standard developer environments.

Supported Environments

Environment Status Theme Features & Token Support
Google Antigravity IDE 🟢 Native Full Agent Chat bubbles, slash commands (/goal, /schedule, /grill-me, /learn), Walkthroughs, AI artifact diffs
Windsurf / Cascade (Codeium) 🟢 Native Supercomplete preview, ghost text, inline AI prediction, AI Chat panels, flow diffs
Cursor 🟢 Native AI prompt bars, inline generation, multi-file diff editor, terminal badges
Visual Studio Code (v1.74+) 🟢 Native Full semantic status system, accessible Error Lens, Git blame injection, indent shading
VSCodium & OpenVSX 🟢 Native Privacy-focused builds, open telemetry, offline enterprise deployments
Theia & Web IDEs 🟢 Native Cloud-native IDE containers and browser-based workspaces

Installation Methods

1. Marketplace Installation (GUI)

  1. Open the Extensions view (Ctrl+Shift+X on Linux/Windows, Cmd+Shift+X on macOS).
  2. Search for ZeroToSaaS Accessibility Theme Suite.
  3. Click Install.
  4. Open the Color Theme picker (Ctrl+K Ctrl+T / Cmd+K Cmd+T) and select any of the 20 accessible variants (e.g. ZeroToSaaS Light (Default), ZeroToSaaS Deuteranopia, ZeroToSaaS High Contrast).
  5. Choose any of the 10 accessible variants (e.g. ZeroToSaaS Light (Default), ZeroToSaaS Deuteranopia, ZeroToSaaS High Contrast).

2. Command Line Installation (CLI)

Install the packaged .vsix bundle directly to your favorite IDE with a single terminal command:

# Google Antigravity IDE
antigravity --install-extension zerotosaas-theme-0.1.0.vsix

# Windsurf / Cascade
windsurf --install-extension zerotosaas-theme-0.1.0.vsix

# Cursor
cursor --install-extension zerotosaas-theme-0.1.0.vsix

# Visual Studio Code
code --install-extension zerotosaas-theme-0.1.0.vsix

# VSCodium
codium --install-extension zerotosaas-theme-0.1.0.vsix

🛠️ Development & Build Pipeline

# Clone repository
git clone https://github.com/zerotosaas/vsx-theme-zerotosaas.git
cd vsx-theme-zerotosaas

# Install dependencies
pnpm install

# Generate all 10 theme JSONs
pnpm run build

# Run automated WCAG AAA relative luminance assertions
pnpm run validate

# Package into VSIX extension bundle
pnpm run package

📄 License & Attribution

This project is free software licensed under the GNU Affero General Public License v3.0 (AGPLv3).

Copyright (C) 2026 Sarvasv Technologies Pvt Ltd (ZeroToSaaS.in)

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.

What this means for you:

📑 Applying the AGPLv3 Notice Across Multiple Languages

When contributing source files or creating derivative tools, attach the AGPLv3 header notice at the beginning of each file according to the programming language’s comment syntax:

1. JavaScript, TypeScript, Rust, Go, C, C++, Java, Kotlin, Swift, Dart, C#, Scala (// or /* */)

// Copyright (C) 2026 Sarvasv Technologies Pvt Ltd (ZeroToSaaS.in)
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU Affero General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU Affero General Public License for more details.
//
// You should have received a copy of the GNU Affero General Public License
// along with this program.  If not, see <https://www.gnu.org/licenses/>.

2. Python, Ruby, Shell (Bash/Zsh), Perl, R, YAML, Dockerfile (#)

# Copyright (C) 2026 Sarvasv Technologies Pvt Ltd (ZeroToSaaS.in)
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU Affero General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU Affero General Public License for more details.
#
# You should have received a copy of the GNU Affero General Public License
# along with this program.  If not, see <https://www.gnu.org/licenses/>.

3. PHP / Hack (<?php + Block Comment)

<?php
/**
 * Copyright (C) 2026 Sarvasv Technologies Pvt Ltd (ZeroToSaaS.in)
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Affero General Public License for more details.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */

4. CSS, SCSS, SASS, Less (/* */)

/*
 * Copyright (C) 2026 Sarvasv Technologies Pvt Ltd (ZeroToSaaS.in)
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Affero General Public License for more details.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */

5. SQL, Lua, Haskell (-- or Block Comment)

-- Copyright (C) 2026 Sarvasv Technologies Pvt Ltd (ZeroToSaaS.in)
--
-- This program is free software: you can redistribute it and/or modify
-- it under the terms of the GNU Affero General Public License as published by
-- the Free Software Foundation, either version 3 of the License, or
-- (at your option) any later version.
--
-- This program is distributed in the hope that it will be useful,
-- but WITHOUT ANY WARRANTY; without even the implied warranty of
-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-- GNU Affero General Public License for more details.
--
-- You should have received a copy of the GNU Affero General Public License
-- along with this program.  If not, see <https://www.gnu.org/licenses/>.

6. HTML, XML, SVG (<!-- -->)

<!--
  Copyright (C) 2026 Sarvasv Technologies Pvt Ltd (ZeroToSaaS.in)

  This program is free software: you can redistribute it and/or modify
  it under the terms of the GNU Affero General Public License as published by
  the Free Software Foundation, either version 3 of the License, or
  (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU Affero General Public License for more details.

  You should have received a copy of the GNU Affero General Public License
  along with this program.  If not, see <https://www.gnu.org/licenses/>.
-->

🤝 Contributing & Contributor License Agreements (CLA)

We welcome contributions from developers, color scientists, accessibility researchers, and organizations worldwide.

To ensure long-term legal protection and open distribution under AGPL-3.0, all contributors must execute a Contributor License Agreement prior to having pull requests merged:

Signed agreements can be submitted directly via pull request or by emailing legal@zerotosaas.in.