WORK-226
ID:WORK-226Status:ready

Catppuccin preset module + doc page

Ship Catppuccin's canonical Latte (light) + Mocha (dark) pair as a single refrakt preset. Catppuccin is the lineup's most well-documented palette — every hue has a name and a documented purpose — making the role mapping unusually clean. The mid-dark flavours (Frappé, Macchiato) are deferred to Phase 2 per SPEC-057.

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

Criteria completion

Criteria completion: 0 of 9 (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/catppuccin.ts exports a ThemeTokensConfig with Latte as the base (light) and Mocha as modes.dark
  • Latte canvas base #eff1f5, text text #4c4f69. Mocha canvas base #1e1e2e, text text #cdd6f4
  • Role mapping uses Catppuccin's documented syntax-highlighting reference: Mauve (keyword), Blue (function), Yellow (class/type), Green (string), Peach (number), Overlay0/1 (comment), Rosewater/Text (variable), Pink (tag), Teal (attribute), Sky (operator), etc. — see https://catppuccin.com/palette/
  • Sets at least three SPEC-056 extended roles distinctly — Catppuccin spec is precise enough that type, attribute, and tag all land on distinct hues
  • Each hue in the file references its Catppuccin swatch name in a comment (e.g. // Mauve (Mocha), // Rosewater (Latte))
  • File header includes attribution: "Derived from Catppuccin by the Catppuccin organisation, MIT licensed. https://catppuccin.com/"
  • packages/lumina/test/catppuccin-preset.test.ts mirrors nord-preset.test.ts — including assertions for the Latte light values and the Mocha dark values
  • site/content/themes/catppuccin.md follows the Nord doc page structure with both Latte and Mocha palette blocks, calling out that the doc page ships Latte+Mocha and other flavours can be added in a future milestone
  • No regressions in CSS coverage tests; full suite green

Approach

Catppuccin publishes formal palette JSON at https://catppuccin.com/palette/ — read the Mocha and Latte palettes and the syntax-highlighting variant documentation. Map the named hues to refrakt's role vocabulary.

Note that Catppuccin doesn't always pick a unique hue for every refrakt extended role — tag and keyword might both be Mauve in some implementations. Where Catppuccin collapses, let the role collapse too (don't set the extended role; let it cascade via fallback). Where Catppuccin splits, set the extended role explicitly.

The doc page intro should note: Catppuccin ships four flavours; we ship Latte (light) + Mocha (dark) as the canonical pair. If readers want Frappé or Macchiato as separate presets, that's a Phase 2 ask — open an issue.

Dependencies

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

References

  • SPEC-057 — "Catppuccin" subsection
  • Catppuccin palette: https://catppuccin.com/palette/
  • Syntax mapping: https://github.com/catppuccin/catppuccin#-style-guide
  • GitHub: https://github.com/catppuccin/catppuccin