# 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). |