Shark Artist: Great White Theme

A VS Code color theme built on the great white shark's world: cold ocean depth, sharp contrast, and the clean menace of something perfectly evolved. Created by The Shark Artist.

Six variants: Great White (Dark), Great White (Light), Great White (Storm), Great White (Frost), Great White (High Contrast Dark), and Great White (High Contrast Light).

Screenshots

Great White (Dark)

Great White (Light)

Great White (Storm)

Great White (Frost)

Great White (High Contrast Dark)

Great White (High Contrast Light)

Color Palette

All syntax token colors meet WCAG AA contrast (4.5:1 minimum) against their respective backgrounds.

Coral (#c44f5f) and amber (#d9a441) appear only in diagnostics, diff-removed, and warnings. They are not used as general syntax accents.

Additional Great White Palettes

The new variants extend the gray-red-white-blue design space while preserving token hierarchy and readability.

Color Theory and VS Code Best Practices

• Use luminance for hierarchy first: code readability improves when semantic groups differ in lightness before hue.
• Reserve warm tones for urgency: diagnostics keep the canonical coral/amber signal, while standard syntax remains primarily cool.
• Separate TextMate and semantic rules: every token-family color change is mirrored in both tokenColors and semanticTokenColors.
• Maintain workbench/token parity: cursor, selection, lists, tabs, and focus borders follow the same palette axis as syntax tokens.
• Support low-vision scenarios: the high-contrast variants increase foreground-to-background separation and UI boundary visibility.

Features

• Contrast-verified -- all token colors computed against WCAG AA (4.5:1) before release.
• Six variants -- Dark and Light foundations, plus Storm, Frost, High Contrast Dark, and High Contrast Light.
• Extended family -- Storm and Frost provide gray-red-white-blue alternatives while keeping Great White identity.
• High-contrast options -- dedicated dark and light high-contrast themes for accessibility-first sessions.
• Semantic highlighting -- semantic token rules take priority over TextMate for TypeScript, Python, Rust, Go, and other language-server-supported files.
• Bracket pair colorization -- six distinct ocean-derived colors for nested brackets.
• Full workbench coverage -- 173 color keys: editor, sidebar, activity bar, tabs, status bar, title bar, input fields, buttons, lists, breadcrumbs, diff, peek view, minimap, git decorations, scrollbar, notifications, terminal.
• HTML / JSX / CSS -- tag names, attributes, and CSS properties explicitly styled.
• Markdown -- headings (bold), italic, inline code, fenced blocks, links, blockquotes.
• Terminal ANSI -- consistent 16-color ANSI palette shared across all variants.
• Explorer file nesting -- smart nesting patterns that group package.json, tsconfig.json, .env, README.md, vite.config.*, *.ts, C/C++ headers, Python lockfiles, CMake presets, PowerShell scripts, and systemd units under their logical parent nodes automatically.
• Entry point + config decorations -- the Explorer badges entry point files with E (amber) and config/build files with C (sky blue); parent folders tint amber when they contain an entry point. Individual badge types can be toggled independently.
• Bloodloss alarm -- a runtime alarm mode that auto-switches to Great White (Bloodloss) when file size and AI typing velocity cross a complexity threshold; restores your previous theme when severity drops or on manual reset.
• AI-aware colors -- editorGhostText, editor.inlineSuggest, inlineChat, inlineChatDiff, chat, and terminalCommandDecoration color groups tuned for Copilot ghost text, the Ctrl+I inline chat panel, AI-generated diffs, and terminal command decorations.
• Agent file icons (opt-in) -- Great White: Agent File Icons icon theme provides custom SVG icons for AGENTS.md, CLAUDE.md, GEMINI.md, COPILOT.md, plan.md, .learnings/, and .copilot/ in the ocean-blue palette.
• Agent product icons (opt-in, foundation) -- Great White: Agent Product Icons product icon theme stub; full custom icon font planned for a future release.
• AGENTS.md syntax callouts (auto) -- a Markdown-injected TextMate grammar highlights agent-instruction prefixes (CRITICAL:, WARNING:, TODO:, NOTE:, etc.) in semantic colors automatically in every Markdown file.
• Self-improving -- includes an audit script, monthly GitHub Actions loop, and four custom Copilot agents (@theme-editor, @theme-auditor, @learnings-clerk, @release-manager) that enforce theme rules during development.

Install

VS Code Marketplace

1. Open the Extensions panel (Ctrl+Shift+X / Cmd+Shift+X).
2. Search Shark Artist: Great White Theme.
3. Click Install.
4. Press Ctrl+K Ctrl+T / Cmd+K Cmd+T and select any Great White variant.

From a .vsix file

code --install-extension shark-labs-great-white-theme-x.x.x.vsix

Local Development

git clone https://github.com/johnsirmon/shark-artist-great-white-theme.git
cd shark-artist-great-white-theme
code .
# Press F5 -> Extension Development Host opens
# Run: Preferences: Color Theme -> choose any Great White variant

Test across: TypeScript, Python, JSON, Markdown, HTML/JSX -- and check the diff editor and terminal too.

Custom Copilot Agents

Four specialist agents in .github/agents/ assist with development:

Invoke any agent with @agent-name in GitHub Copilot Chat.

Explorer Enhancements

File Nesting

Great White contributes smart explorer.fileNesting.patterns defaults so the Explorer collapses noisy sibling files under their logical parent. File nesting is enabled by default when the theme is active; you can disable it per workspace via the standard setting:

// .vscode/settings.json  — turn off nesting for this workspace
{ "explorer.fileNesting.enabled": false }

Entry Point & Config Decorations

The extension registers a FileDecorationProvider that visually highlights important files in the Explorer:

The E badge uses propagate: true, so the folder containing an entry point also receives the amber tint — making the path to an entry point visible at a glance even when folders are collapsed.

Entry points are resolved by reading the workspace's package.json once per folder (cached). The cache is invalidated automatically whenever package.json changes on disk.

Settings — three knobs are available:

// User or workspace settings — hide only config badges
{
  "greatWhite.showConfigFileBadges": false
}

All three settings take effect immediately with no reload required.

Commands

All commands are available via the Command Palette (Ctrl+Shift+P / Cmd+Shift+P). Search Great White.

Bloodloss — Context Bloat Alarm

Great White ships a passive runtime monitor that watches document size and AI typing velocity. When a file grows large and content is arriving fast (as happens during unconstrained AI generation), the severity score climbs. Once it crosses the threshold the theme switches to Great White (Bloodloss) — a high-saturation dark red variant that acts as a visual alarm.

There are no popups. The theme switch is the alarm. A small status bar item at the bottom right provides a live readout:

Click the status bar item at any time to run Cleanse Bloodloss immediately.

How severity is calculated

Each keystroke updates two sub-scores (both 0–50):

The two scores are summed (max 100). Once the combined score exceeds triggerSeverity (default 75), Bloodloss activates. Velocity decays when output slows or content is deleted, and the theme restores automatically when severity drops below triggerSeverity − 20 (default 55).

At the defaults a file has to be simultaneously large and arriving fast to trip the alarm. Human typing (~100 chars/sec) in even a 500 KB file scores only ~10/50 on velocity — not enough on its own.

To give a sense of scale: a typical large source file is 500–2 000 lines (~5–20 KB). The 500 KB default threshold is roughly 250× a typical source file or about the size of a full GPT-4 context dump written to disk.

Configuring the thresholds

Three settings let you tune sensitivity:

// Example: only alarm on truly massive AI dumps (1 MB / very fast generation)
{
  "greatWhite.bloodloss.sizeThreshold": 1000000,
  "greatWhite.bloodloss.velocityThreshold": 8000,
  "greatWhite.bloodloss.triggerSeverity": 85
}

Resetting manually

Run Great White: Cleanse Bloodloss from the Command Palette, or use the keyboard shortcut if you've bound it. This zeroes the severity counter and restores whatever theme you had active before.

Note: Great White (Bloodloss) is listed in the theme picker but is intended as an alarm state, not a daily theme. Selecting it manually works, but the extension will still monitor severity and potentially switch away from it when severity drops.

Agentic Workflow Visibility

Starting in v0.5.0, Great White extends its palette into AI/agent surfaces so Copilot interactions feel native to the theme rather than using VS Code defaults.

AI surface colors (all six variants)

Agent File Icons (opt-in)

Activate via Preferences: File Icon Theme → Great White: Agent File Icons.

Custom SVG icons for agent-workflow files, all in the ocean-blue/teal/amber palette:

VS Code only allows one active file icon theme. Selecting Great White: Agent File Icons replaces any previously active icon theme.

Agent Product Icons (opt-in, foundation)

Activate via Preferences: Product Icon Theme → Great White: Agent Product Icons.

Currently a minimal stub using the built-in Codicon font. A full custom shark-ocean icon font is planned for a future release.

AGENTS.md Syntax Callouts (automatic)

A TextMate grammar (text.agents.markdown) is injected into all Markdown files automatically. It highlights agent-instruction prefixes in semantic colors wherever they appear:

Section headings, inline code, and file paths within these callouts also receive distinct styling.

Design Philosophy

1. Contrast from depth, not color count. The palette is narrow on purpose. Visual hierarchy comes from luminance contrast between token types, not from using many distinct hues. Every color in the palette earns its place.

2. Danger is the only warmth. Coral and amber are reserved exclusively for errors, warnings, and diff-removed highlights. When you see warm color in the editor, something needs your attention. Strings, functions, and types stay cool.

3. Dark is the ocean floor; Light is shark belly. The dark background evokes pressure and depth -- light barely reaches here, so every lit token stands out sharply. The light background is the pale, smooth underside: cold, clean, and high-contrast in a different direction. All variants stay on the same shark-ocean accent axis so switching feels like surfacing, not abandoning the visual language.

Packaging and Publishing

npm install -g @vscode/vsce
vsce package          # creates .vsix, also runs in CI on every push to main
vsce login shark-labs
vsce publish

Before publishing, work through docs/release-checklist.md.

Feedback and Issues

Found a token that looks wrong in your language? Open an issue with:

• The language and file type
• The token type that looks wrong (e.g., "parameter color is same as foreground in Rust")
• A short code snippet that reproduces it

License

MIT. See LICENSE.