Forró — VSCode Theme

A warm theme built from a palette that bridges the Nordeste brasileiro, the Mapuche south, and a Viennese winter. Dark & light variants for every mood.

Variants

Dark

Variant	Description
Forró Roots	The default — earthy terracotta, ochre, forest green, ivory
Forró Íntimo	Softer, more muted tones for late-night coding
Forró Nordeste Vivo	Vibrant Brazilian Nordeste-inspired palette
Forró Pé de Serra	The original mountain forró — raw, pure, signature
Forró PD	Cool-toned dark theme with green and blue accents

Light

Variant	Description
Forró Roots Light	Warm ivory background with earthy token colors
Forró Íntimo Light	Parchment-toned light variant for daytime coding
Forró Nordeste Vivo Light	Vivid Nordeste palette on a clean warm background
Forró Pé de Serra Light	Mountain forró palette adapted for light mode
Forró PD Light	Cool slate-white with green and blue accents

Accessibility

All ten variants (5 dark + 5 light) meet WCAG 2.1 AA contrast minimums:

Primary tokens (keywords, functions, strings, types): ≥ 4.5:1
De-emphasised tokens (comments, punctuation, operators): ≥ 3.0:1
Key UI elements (foreground, sidebar, tabs, status bar): tested against their respective backgrounds

Contrast compliance is enforced by an automated test suite (884 tests) that runs on every commit.

Installation

From the Marketplace

Search for Forró in the VS Code Extensions view (Ctrl+Shift+X) and click Install.

From VSIX

code --install-extension forro-theme-2.0.0.vsix

Activate

Open the Command Palette (Ctrl+Shift+P) → Preferences: Color Theme → select any Forró variant.

Development

npm install
npm test                  # Run all contrast + helper tests (884 tests)
npm run fix:contrast      # Auto-fix failing colors (OKLCH lightness adjustment)
npm run generate:light    # Regenerate light themes from dark variants
npm run build:site        # Rebuild the GitHub Pages showcase site

Forró

yerko-escalona