Repository navigation
Gotchas
Brian Jr edited this page Nov 17, 2026
·
1 revision
- A Look must look right on dark (pure-black/AMOLED) and light palettes, and follow the user's accent. Colors come from
paletteinresolveLookColors— don't hard-code a single background/text color. Test both themes. -
Selected nav label color: the nav renderer's
textColormust contrast with the panel (the label sits below the highlight), not reuse the on-highlight icon tint — otherwise the selected label becomes invisible. OverridetextColor(p, selected)explicitly. - Light-theme faint labels: thin/low-contrast label colors can disappear on light palettes. Check both.
- Wide or tall display fonts (e.g. Michroma, 7-segment, rounded-bold, serif) overflow the small telemetry cards. Tune, per Look, in
SettingsTabLookSpec:ringValueScale,ringTitleScale,ringUnitScale,ringDiameterRatio, andinfoValueScale(TEMP/FAN). Shrink until nothing clips. -
tccTextStyle()= the label font;tccDisplayTextStyle()= the display/number font. Use the display font for big numerals. - The big FPS number is drawn with a native
Paintusingtraits.canvasFontRes— set it if your Look has a display font, or the FPS number falls back to the default face.
- The hardware cards are adaptive: the telemetry rings render 2×2 in a tall card and 1×4 in a wide strip; TEMP/FAN shows two stat columns when tall and stacked rows when short; the FPS counter grows in a big card. If you write custom gauge/card renderers, make sure they look right both large and small.
- Nav selection shapes should be centered on the icon box (
size.height / 2), not a fixed offset, or the highlight floats above the icon.
-
Fonts: bundle only SIL OFL / permissively-licensed fonts, named
tcc_*.ttf, and add an attribution block toassets/THIRD_PARTY_NOTICES.txt. No fonts you don't have the right to ship. -
Icons are NOT bundled. The overlay loads AYN's stock drawables at runtime from the installed stock app (
com.odin.dualscreen.assistant); your renderers just tint them viaColorFilter. Do not add AYN icon art to the repo. (Seedocs/reference/LICENSE_COMPLIANCE.md.) - Only contribute colors/fonts/code you have the right to.
-
StockLookSpec(theAUTOLook) is the baseline —copy()it and override only differences. - Adding a style enum value without wiring its
.renderer()case is a compile error (exhaustivewhen) — that's your reminder to add the renderer. - E-Ink deliberately ignores the accent (stays monochrome); some Looks intentionally diverge from the "follow the accent" rule — that's fine, just be deliberate.
- Changing
TccUiLook's set doesn't need a migration: saved looks resolve by name and fall back toAUTO.
Next: Verification Checklist