WORK-229
Setting up your dashboard 0 entities found · 9/32 branches scanned
ID:WORK-229Status:ready

Gruvbox preset module + doc page

Ship Pavel Pertsev's Gruvbox as a single refrakt preset with light + dark variants from coordinated hues. Gruvbox is the lineup's only warm palette — five blue/cool members plus this one warm gives the catalog visual variety. Gruvbox is also the most "unix terminal heritage" of the lineup, important counterweight to the JS-editor-modern bias of Catppuccin / Tokyo Night.

Priority:mediumComplexity:smallMilestone:v0.14.2Source:SPEC-057
claude/spec-057-curated-syntax-presets View source

Criteria completion

Criteria completion: 0 of 10 (0%) checked; tracking started on May 20, no incremental history yet0%25%50%75%100%May 20Jun 15

Tracking started May 20 — check back for trends.

Relationships

Implements 1
Related 4
Branches 2
claude/spec-057-curated-syntax-presets current ready
main doneclaude/spec-057-v0-14-2-implementation done
History 1
  1. 2aeb773
    Created (ready)by bjornolofandersson

Acceptance Criteria

  • packages/lumina/src/presets/gruvbox.ts exports a ThemeTokensConfig with light medium as the base and dark medium as modes.dark
  • Light medium canvas #fbf1c7, text #3c3836. Dark medium canvas #282828, text #ebdbb2
  • Role mapping follows Gruvbox's convention: red (keyword/identifier in some variants), orange (number/constant), yellow (function/operator), green (string), aqua (function-decl), blue (function-call), purple (number/constant alt), gray (comment)
  • Sets at least three SPEC-056 extended roles distinctly
  • Each hue in the file references its Gruvbox swatch name (e.g. // neutral_red, // bright_orange, // faded_yellow)
  • File header includes attribution: "Derived from Gruvbox by Pavel Pertsev (morhetz), MIT licensed. https://github.com/morhetz/gruvbox"
  • packages/lumina/test/gruvbox-preset.test.ts mirrors nord-preset.test.ts with light + dark assertions
  • site/content/themes/gruvbox.md follows the Nord doc page structure
  • Doc page intro highlights Gruvbox's "retro warm" identity and connects to the catalog's need for visual variety (one warm palette balancing five cool ones)
  • No regressions in CSS coverage tests; full suite green

Approach

Gruvbox's palette is documented in the README at https://github.com/morhetz/gruvbox#palette. The palette has three contrast levels (soft / medium / hard) and we ship medium for both light and dark. The neutral foreground / background swatches are mode-dependent (#3c3836/#fbf1c7 for light, #ebdbb2/#282828 for dark) but the bright/neutral/faded accent variants share names across modes.

For syntax: Gruvbox's convention varies across implementations; the canonical mapping from the gruvbox.vim repo is the most authoritative. Settle on one canonical mapping and document the choices in code comments.

Dependencies

  • WORK-220, WORK-221 — Nord structural references

References

  • SPEC-057 — "Gruvbox" subsection
  • GitHub: https://github.com/morhetz/gruvbox
  • Palette: https://github.com/morhetz/gruvbox#palette
  • Reference syntax mapping: https://github.com/morhetz/gruvbox/blob/master/colors/gruvbox.vim