Repository navigation
Quick Start Level 1
Brian Jr edited this page Nov 17, 2026
·
1 revision
-
Enum — in
LookStyle.kt, add a value toTccUiLookand alabelcase:enum class TccUiLook { AUTO, AURORA_GLASS, /* … */, E_INK, MY_LOOK; } // label: MY_LOOK -> "My Look"
-
Fonts (optional) — drop an OFL
.ttfintores/font/namedtcc_<name>.ttf, add aFontFamilyinTccFonts.kt, and add attribution toassets/THIRD_PARTY_NOTICES.txt(required — see Gotchas). -
Colors — in
TccLookColors.kt,resolveLookColors(palette, look)returns aTccLookColors. Add/branch the fields your Look needs; reuse an existing Look's block as a starting point. Colors should be derived frompalette(accent + bg + text) so the Look follows the user's accent on dark and light palettes. -
Spec — in
TccLookSpec.kt, copyStockLookSpecand override only what differs:val MyLookSpec: TccLookSpec = StockLookSpec.copy( look = TccUiLook.MY_LOOK, panelCardShape = RoundedCornerShape(aynDp(12f)), traits = LookTraits( card = CardStyle.GLASS, tile = TileStyle.NEON, gauge = GaugeStyle.RING, slider = SliderStyle.GLOW_GRADIENT, nav = NavStyle.GLASS_PILL, backdrop = BackdropStyle.AURORA, labelFontFamily = TccMonoFontFamily, displayFontFamily = TccMonoFontFamily, canvasFontRes = R.font.tcc_mono_bold, // used by the native-Paint FPS number ), )
-
Map it — add one line to
specForLook()inTccLookSpec.kt:TccUiLook.MY_LOOK -> MyLookSpec
- Build, install, screenshot both overlay tabs and the companion (see Verification Checklist). Iterate.
That's the whole Level-1 flow. No renderer code.
- Add a value to the style enum (e.g.
CardStyle.MY_CARD). - Create
ui/components/looks/MyLookRenderers.ktwith an object implementing the interface (LookCardRenderer,LookTileRenderer,LookGaugeRenderer,LookSliderRenderer, orLookNavRenderer). Copy the closest existing*Renderers.ktas a template — they show every method you can override. - Wire the enum value → your object in the matching
.renderer()wheninLookRenderers.kt. - Reference the new style in your spec's
LookTraits.
Next: Driving an Agent