Skip to content

Your own skin ​

How killBottleneck looks is your choice, not the admin's. This tutorial shows the built-in skins first, then the standalone skin editor for building your own.

1. Pick a skin ​

Open the user menu (the person icon top right) → Appearance. The Appearance dialog offers twelve built-in skins — Indigo, High contrast, Terminal, Paper, Ocean, Forest, Midnight, Plum, Peach, Graphite, Ruby and Rose. Each works in both light and dark mode, and the choice is saved to your account, so it follows you to every device — including the phone view.

The Appearance dialog. The “Preview in mode” switch shows every skin in light and dark before you pick it.

Why is the app dark after installing?

The default skin is Midnight — and it is dark in both modes, so switching to light mode doesn't help. If you want a light app, pick another skin here (Indigo or Paper, for example).

A few things a skin does not change: the status colors (overdue is red in every skin, done is green) and the icons. What it does change includes the three connector-line colors of the map — neutral, done and past the deadline.

2. Build your own in the skin editor ​

The skin editor is a separate small app (MIT-licensed, part of the skin gallery repository). It runs entirely in your browser — nothing is uploaded anywhere. Try it right now at https://tengolabs.github.io/killbottleneck-skins/ — no installation needed.

Start from any built-in template, edit 37 colors, 4 fonts, the corner radius and the background doodle — and watch the light and dark preview side by side.

The comfortable workflow:

  1. Start from a template — pick the built-in skin closest to what you want. (Or download your current skin from the app's Appearance dialog with Export and open that.)
  2. Adjust the colors by group — base, cards, brand colors, the map canvas. The Copy light → dark button is a good starting point for the dark variant.
  3. Download the skin file (JSON in the kb-skin format).

The map canvas has three line colors: the neutral one plus done and past the deadline. A skin that leaves them out is still valid — it simply falls back to the built-in green and red. If your copy of the skin editor does not offer them yet, set them by hand in the JSON (canvas-edge-done, canvas-edge-late) or leave them out.

3. Import it into killBottleneck ​

Back in the app: user menu → Appearance → Import skin — either From file…, or by pasting the JSON into the Paste skin JSON (kb-skin format)… field and clicking Apply. The skin is validated on import and saved to your account. What you see when something is off:

  • Input is not valid JSON. — the file is damaged or only partly copied.
  • Part of the skin is unknown to this version and was skipped — the skin comes from a newer editor; the rest is used.
  • Skin import failed — the file did not pass validation (it is larger than 8 KB, for example).

A skin is deliberately just data — colors, fonts, a radius. No CSS, no URLs, nothing that can run; the same allow-list is enforced by the editor, the app and the server. A skin someone sends you can look wild, but it can't do anything.

4. Share it (optional) ​

Skins in the gallery are CC0 — take, tweak, use. If you make one worth showing, open a pull request; CI validates the file.

A company-wide look

An administrator can set a skin in Organization settings → Instance default appearance for everyone who hasn't picked their own — it colors the login screen too. Every user's own choice still wins over the default. See Team setup.

Limits

  • A skin does not change the status colors or the layout — only colors, fonts, the radius and the doodle.
  • The background doodle is drawn only in the simplified view (phone).
  • An imported skin is capped at 8 KB; unknown items are skipped with a warning.
  • A skin applies to your account; the instance default is set by an administrator only.

Next ​

  • Skins — the full reference, including what a skin can and cannot change
  • On your phone — the skin picker below the list in lite
  • The AI assistant — the look can also be switched with a sentence like “switch my look to Paper”

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