Skip to content

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.
The Appearance dialog — the picker, a preview in both modes, import and export in one place.

How to change the look ​

  1. Open the user menu → Appearance.
  2. With the Preview in mode switch (Light / Dark) look at the cards in the mode you use.
  3. 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 ​

The same map in the Terminal skin — the status colors stay the same.

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) ​

Changing the look right on the phone — the picker below the list; only lite draws the skin's doodle.

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.

The skin editor — 37 colors, 4 fonts, radius and doodle, with a live preview.

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.

Open source under the MIT license · © Tengo s.r.o.