ColorFly is a professional graphical theme customization studio, boxed clock widget, and color science environment integrated directly into Visual Studio Code. Customize workbench surfaces, syntax highlighting, and terminal colors with precision, inspect contrast ratios in real time, preview changes live, and generate installable theme extensions β all without manual JSON editing.
- Custom Activity Bar Icon: Clean, monochrome SVG prism icon conforming to VS Code Activity Bar ergonomics.
- Theme Studio Sidebar: Mini-dashboard showing active theme status, applied override count, quick palette preview, starter preset switcher, and a prominent "Open Theme Studio in Editor" button.
- Full-Page Studio with 5 GUI Theme Modes:
- π¨ VS Code Native: Inherits editor and workbench colors dynamically.
- π Studio Obsidian Dark: Deep obsidian glass aesthetic with electric violet accents.
- βοΈ Studio Clean Light: Modern porcelain daylight UI with crisp contrast and blue accents.
- βοΈ Pencil Paper Theme: Architectural draft graph paper texture, pencil charcoal typography, hand-drafted sketch borders, and draftsman aesthetics.
- π» Animated Hacker Theme: Glowing phosphor neon green typography, active animated CRT scanline sweep, cyber gridlines, and terminal vibes.
- Dedicated GUI Settings Studio: Configure GUI themes, layout density (Compact, Comfortable, Relaxed), base font size (12px, 13px, 14px), and animation effects with persistence.
- 12 Dedicated Workbench Categories:
- Activity Bar
- Primary Sidebar
- Editor (background, line numbers, cursor, guides, brackets, selections)
- Tabs and Title Bar
- Status Bar
- Panel (Terminal, Output, Problems)
- Integrated Terminal (ANSI 16-color spectrum)
- Buttons and Inputs
- Lists, Trees, and Menus
- Search, Source Control (Git decorations), and Debugging
- Notifications and Popups
- Badges, Scrollbars, and Breadcrumbs
- 162 Isolated Color Setting Files: Every workbench color setting has its own dedicated TypeScript component file under
src/webview/components/workbench/(e.g.editor_background.tsx,activityBar_foreground.tsx), making per-feature bug fixes and maintenance fast and safe. - Per-Color Active/Deactivate Toggle: Each color row has a prominent Active/Deactivate button to enable or disable individual color overrides.
- Virtual Scrolling: Large color lists are virtualized β only visible rows are rendered, keeping the UI smooth even with 162+ color settings.
- Fast Global Search: Filter by human-readable component name, exact official VS Code color ID (e.g.
editor.background), or description. - Filtering Options: Toggle between All Properties, Customized Only, or Unmodified Only.
- Precision Color Picker: Visual Hue, Saturation, Lightness, and Alpha/Opacity sliders. Popup auto-clamps to viewport and flips above the anchor when near screen edges β never opens outside the layout boundary.
- Color History: Recently used colors are saved to localStorage and shown in the picker for quick reuse (last 10 colors).
- Validated Input Formats: Real-time validation and normalization for HEX (
#RGB,#RGBA,#RRGGBB,#RRGGBBAA), RGB/RGBA, and HSL/HSLA. - Algorithmic Harmonies: Instantly generate Complementary, Analogous, Triadic, Monochromatic, and Neutral Dark Surface palettes derived from any seed color.
- Target Assignment: Assign any generated harmony color to any workbench component in one click.
- Full Accessibility: ARIA labels on all sliders, inputs, and buttons; keyboard navigation; Escape-to-close; focus management in dialogs.
- Per-Icon Active/Deactivate Toggle: Every icon in the Icon Library (308 VS Code icons) has its own Active/Deactivate button to enable or disable individual icons.
- Bulk Activate/Deactivate: Select multiple icons and activate or deactivate them all at once.
- Select All / Deselect All: Quick selection controls at the top of the icon table.
- Active Icons Summary: Shows the count of currently active icons.
- Core Token Categories: Custom styling for Comments, Strings, Numbers, Keywords, Functions, Variables, Types, Classes, Constants, Operators, Punctuation, and Regular Expressions.
- TextMate Rule Builder: Add, edit, test, and delete scoped TextMate rules (e.g.
storage.type,entity.name.function) with custom colors and font styles (italic, bold, underline,strikethrough). - Semantic Token Color Customizations: Direct support for language-server semantic tokens (
variable.readonly,parameter,property).
- Simulated VS Code Environment: Interactive preview of Code Editor with TypeScript sample code, File Explorer tree, Integrated Terminal with ANSI outputs, Git Diff viewer, and Status Bar.
- Zero Configuration Side-Effects: Preview updates instantly as you tweak colors without prematurely committing changes to your VS Code settings.
- User vs. Workspace Scopes: Switch between global User configuration (
~/.config/Code/User/settings.json) and project-specific Workspace settings (.vscode/settings.json). - Theme-Specific Scoping: Target only the active theme using bracketed theme scopes (
"[Default Dark+]": { ... }) to prevent polluting other themes. - Non-Destructive Merging: Preserves all unrelated user settings and third-party extensions.
- Pre-Customization Snapshots & 1-Click Restore: Automatic pristine state capture before applying changes, allowing safe, non-destructive restoration at any time.
- Profile Version History: Automatic version snapshots are saved before every profile modification. Keep up to 10 versions per profile and restore to any previous state instantly.
- 8 Production Starter Presets:
- Midnight: Deep obsidian with electric violet and celestial indigo accents.
- Deep Ocean: Abyssal teal and ocean blue with radiant cyan highlights.
- Forest Terminal: Deep woodland moss and evergreen darks with phosphor green clarity.
- Warm Ember: Charcoal hearth with glowing ember orange, terracotta, and warm brass.
- Soft Lavender: Muted twilight purple, velvety orchid, and soft pastel contrasts.
- Monochrome: Disciplined grayscale elegance with pure graphite and silver.
- Minimal Light: Porcelain white with soft zinc surfaces and crisp typography.
- High Contrast: Pure obsidian with vivid neon outlines and maximal WCAG ratio.
- Profile Operations: Save, duplicate, rename, favorite, delete, and compare profiles.
- Portable JSON Imports/Exports: Import any valid VS Code theme JSON or ColorFly profile backup.
- Automated Contrast Calculations: Evaluates relative luminance for critical UI pairs (Editor Bg/Fg, Sidebar, Activity Bar, Status Bar, Buttons, Terminal).
- WCAG Ratings: Live Level AA (4.5:1) and Level AAA (7.0:1) pass/fail indicators.
- Accessible Foreground Suggestions: Recommends optimal high-contrast text colors for any background.
- Color Blindness Perception Lab: Real-time simulation of Protanopia, Deuteranopia, Tritanopia, and Achromatopsia.
- Scaffold Installable Extensions: Generates full extension folder structure (
package.json,themes/color-theme.json,README.md,LICENSE,CHANGELOG.md) ready to be packaged viavsce packageand published to the VS Code Marketplace. - CSS Variables Export: Export any theme as CSS custom properties (
--cf-editor-background,--cf-activity-bar-foreground, etc.) for use in web applications and design tools. - Import/Export Theme: Import standard VS Code color-theme JSON into ColorFly, or export your customized theme as standalone VS Code theme JSON, ColorFly profile, or installable extension scaffold.
- Download the generated
colorfly-1.0.0.vsixpackage. - In VS Code, open the Extensions view (
Ctrl+Shift+XorCmd+Shift+X). - Click the
...(More Actions) menu in the top-right corner. - Select Install from VSIX... and choose
colorfly-1.0.0.vsix. - Alternatively, install via terminal:
code --install-extension colorfly-1.0.0.vsix
If you are developing or testing ColorFly locally:
- Open this repository folder in VS Code.
- Install dependencies:
npm install
- Press
F5(or go to Run and Debug -> Run Extension). - A new [Extension Development Host] VS Code window will open with ColorFly loaded.
- Click the ColorFly icon in the Activity Bar or run
ColorFly: Open Theme Studio in Editorfrom the Command Palette (Ctrl+Shift+P/Cmd+Shift+P).
| Command | Description |
|---|---|
npm run build |
Builds both the React webview bundle (vite) and extension host (tsc). |
npm run build:ui |
Bundles React UI into dist/webview.js and dist/webview.css. |
npm run build:ext |
Compiles TypeScript extension services into dist/. |
npm run watch:ui |
Watches and rebuilds webview assets on changes. |
npm run watch:ext |
Watches and recompiles extension host files on changes. |
npm test |
Runs the Vitest automated unit test suite. |
npm run package |
Builds and packages the extension into an installable .vsix archive. |
The project includes 65 comprehensive automated unit tests covering:
- Color Math & Conversions: HEX (3, 4, 6, 8-digit), RGB, RGBA, HSL, HSLA, normalization, and floating-point drift prevention.
- WCAG 2.1 Contrast Calculations: Relative luminance and AA/AAA compliance evaluation.
- Color Harmonies & Simulations: Complementary, analogous, triadic, monochromatic, neutral surfaces, and color blindness perception matrices.
- Configuration Management: Non-destructive merging, preservation of unrelated user settings, bracketed theme-specific scopes, and pre-customization snapshot restoration.
- Profile Lifecycle: Storage persistence, preset initialization, schema validation, duplicating, and JSON import/export.
- Theme Extension Scaffolding: Correct
package.jsoncontributes block and file generation.
ColorFly/
βββ assets/
β βββ icon.png # Extension icon (128x128)
β βββ icons/
β βββ ColorFly-activitybar.svg # Monochrome Activity Bar SVG emblem
βββ scripts/
β βββ generate-per-color-components.ts # Generates 162 per-color component files
β βββ generate-registry.ts # Auto-generates color component registry
βββ src/
β βββ extension.ts # Extension activation & service bootstrap
β βββ commands/ # Command palette & toolbar action handlers
β βββ panels/
β β βββ ThemeStudioEditorPanel.ts # WebviewPanel lifecycle, CSP, state sync
β βββ views/
β β βββ ThemeStudioSidebarProvider.ts# Activity Bar WebviewViewProvider
β βββ services/
β β βββ ConfigurationService.ts # Safe VS Code settings reader & merger
β β βββ ProfileService.ts # Versioned profile storage & presets
β β βββ RecoveryService.ts # Undo/redo stack & pre-customization snapshot
β β βββ ThemeExportService.ts # Standalone theme JSON & extension scaffolder
β βββ shared/
β β βββ colorUtils.ts # Pure color science & WCAG algorithms
β β βββ officialWorkbenchColors.ts # Official VS Code workbench color catalog (162 colors)
β β βββ tokenColorCatalog.ts # TextMate token scopes & semantic categories
β β βββ presets/ # Individual starter preset files (60 total)
β β β βββ preset-midnight.ts
β β β βββ preset-deep-ocean.ts
β β β βββ preset-forest-terminal.ts
β β β βββ preset-warm-ember.ts
β β β βββ preset-soft-lavender.ts
β β β βββ preset-monochrome.ts
β β β βββ preset-minimal-light.ts
β β β βββ preset-high-contrast.ts
β β β βββ preset-custom-1.ts through preset-custom-52.ts
β β βββ starterPresets.ts # Re-exports all presets as STARTER_PRESETS array
β β βββ types.ts # Shared RPC and model type definitions
β βββ en.ts # English i18n dictionary
β βββ bn.ts # Bangla i18n dictionary
β βββ hi.ts # Hindi i18n dictionary
β βββ i18n.ts # i18n context, translation utilities
β βββ webview/ # React 18 frontend studio
β βββ App.tsx # Root application & state coordination
β βββ index.tsx # React DOM mount entry
β βββ vscodeApi.ts # Type-safe acquireVsCodeApi wrapper
β βββ styles/app.css # Responsive theme-adaptive styling
β βββ components/ # UI components across all 8 studio workspaces
β βββ common/ # Shared components (ColorInput, ColorPickerPopover, etc.)
β βββ workbench/ # Workbench colors β 162 isolated per-color files
β βββ WorkbenchColorCatalog.tsx # Main orchestrator (search, filters, bulk actions)
β βββ WorkbenchColorRow.tsx # Shared row component (Active/Deactivate + ColorInput)
β βββ workbenchColorTypes.ts # Shared types + CATEGORY_FEATURE_MAP
β βββ colorComponentRegistry.ts # Maps 162 color IDs to their components
β βββ editor_background.tsx # Per-color component (example)
β βββ activityBar_foreground.tsx # Per-color component (example)
β βββ ... (162 total per-color files)
βββ tests/ # 65 automated Vitest unit tests
MIT License. Designed and built for the Visual Studio Code developer community.