Skins
How killBottleneck looks is every user's choice, not the admin's. A skin is a set of colors, fonts and corner radius; it is saved to your account, so it applies on all devices, in light and dark mode, and in the simplified phone view too.
Where to find it
- The user menu → Appearance (the Appearance dialog).
- In a map also in the canvas controls bottom left (the Change appearance (skin) icon).
- In the simplified view the Appearance picker below the list, next to the light/dark switch.
- Telling the assistant “switch my look to Paper” is enough.
How to change the look
- Open the user menu → Appearance.
- With the Preview in mode switch (Light / Dark) look at the cards in the mode you use.
- Click a skin card — it is applied and saved right away, no Save button.
A different skin every day
The A different skin every day switch at the top of the dialog rotates the skins for you: each day the next of the twelve built-in ones, the same on all your devices. Below the switch you see which skin is on today. Clicking a specific card turns the rotation off and keeps that skin. In the simplified view it is the A different one every day option in the Appearance picker; or just tell the assistant "rotate my skins". Light/dark mode is not affected.
Built-in skins
The default is Midnight (deep night blue with golden accents — dark in both modes). Then Indigo, High contrast (pure black and white, sharp corners, system fonts), Terminal (green on dark, mono fonts), Paper (warm paper tones with serif headings), Ocean, Forest, Plum, Peach, Graphite (no colors, just content), Ruby (red on black — preserves night vision) and Rose. Twelve in all.
Why is the app dark after installing?
Because Midnight is dark even in light mode. If you want a light app, pick a light skin (Indigo, Paper, Ocean…) — the mode switch alone is not enough. The app itself still says “The default look” on Indigo and “None (default Forest)” in Organization settings — both labels are outdated; the default is Midnight.
Light, dark — and what never changes
Every skin has a light and a dark variant — the light/dark switch (per device) stays yours. What a skin deliberately does not change are the status colors: red overdue, amber in progress, green done, readable the same everywhere. What it does change includes the three connector colors in the map (neutral, done, overdue).
A map export (PNG/PDF) is true to the screen — captured in the active skin and mode, including the background color; only the background doodle is left out. The project dashboard PDF and the My day image stay deliberately light, so they can be sent to anyone.
On the phone (the simplified view)
In the simplified view the appearance picker sits below the list, next to the light/dark switch. You pick from the same skins (your imported one included) and the choice is saved to your account — phone and computer then look the same. On the first opening lite hints You can change the look any time — try it right here.
Your own skins
A skin is a small JSON file (the kb-skin v1 format) — colors, fonts and corner radius. The Appearance dialog can Export the current skin (for a built-in one its definition — take and tweak) and Import skin someone else's: From file…, or by pasting the JSON and clicking Apply. The skin is validated and saved to your account; a part this version doesn't know is skipped with a warning.
A skin is by principle not arbitrary CSS: the values pass an allow-list on the client and the server, so a shared skin can neither run nor send anything. Web fonts are not downloaded — only fonts bundled with the app and system fonts are used.
Hand-editing the JSON is not necessary: the gallery includes a standalone skin editor (MIT) — it runs entirely in the browser, starts from any built-in template and shows the light and dark preview side by side. Step by step in the Your own skin tutorial.
Community skins live at https://github.com/tengolabs/killbottleneck-skins (CC0 — skins are free data, contributions welcome). The Skin gallery button in the dialog leads straight there.
A company-wide look
An administrator sets a skin in Organization settings → Instance default appearance for everyone who hasn't picked their own (built-in, or Custom (JSON)) — it applies to the sign-in screen too. A user's own choice always wins.
Limits
- A skin does not change the status colors or the layout; light/dark mode is separate and per device.
- An imported skin is capped at 8 KB; unknown items are skipped.
- The background doodle is drawn only in the simplified view.
- The dashboard PDF and the My day image are always light, regardless of the skin.
Related
- Your own skin — the step-by-step tutorial with the editor
- Account and settings — light and dark, language, the user menu
- Export and import — what exports look like

