tai/research/tui-framework-design/bubbletint-readme.md

bubbletint README — tint registry and runtime switching

Metadata

Field	Value
Institute	Molodetz Institute — Research & Retrieval Division
Subject	tui-framework-design
Document type	Source Dossier
Tier	1
Source title	bubbletint README — theme collection for bubbletea/lipgloss
Source URL	https://raw.githubusercontent.com/lrstanley/bubbletint/master/README.md
Source publisher / author	lrstanley (bubbletint project)
Source type	repository
Source date (published)	Unknown — not stated
Date researched	2026-10-11
Researched by	tai (agent), model: Muse Spark, on behalf of retoor
Research method	direct page fetch
Confidence	Medium
Status	Active

Summary

A 340-plus theme collection for the bubbletea/lipgloss ecosystem with the registry shape tai wants: a global default registry plus custom registries, runtime switching, and JSON file loading. The registry mechanics are the finding, not the tint count.

Key findings

• Ships 340+ named tints behind a registry API with a global default registry plus support for custom registries.
• Supports switching themes at runtime and loading themes from JSON files.

Pros / strengths

• Registry-shape precedent: global default plus custom registries plus file loading covers every lookup need with one pattern.
• Proves JSON file loading composes cleanly with a dict-style registry.

Cons / limitations / caveats

• Tints target lipgloss's role-less model, so per-theme structure is thinner than tai's role palette; the registry shape ports, the theme contents do not.
• Scale (340+) is ecosystem-collection scale; tai ships 4–6 builtins.

Relevance to tai

• Registry-shape precedent for the palette-role conclusion (THEMES dict plus register_theme), and the JSON-load precedent behind the deferred file-override design.

Changelog

Date	Change
2026-10-11	Initial dossier created from 2026-10-11 research-pass evidence (body opened via web_fetch by researching agent).