Skip to content

Themes

A theme recolors the whole workstation: panels, charts, candles, drawing defaults and indicator default colors. TickMint ships with ten built-in themes. TickMint Dark is the default.

Choose a theme

Open Workstation Settings (gear in the header toolbar), go to the Chart tab and pick a Color theme preset. The change previews immediately; click Save in Settings to keep it or Discard to go back. See Settings.

Chart tab of the workstation settings with the color theme preset selector
Settings → Chart, where you choose, upload and export themes.

Built-in themes

Pure black with neutral greys, mint bullish and coral-rose bearish candles. The default theme. Id: tickmint-dark.

Workstation in the TickMint Dark theme

Custom themes

Under Color theme preset in Settings → Chart:

  • Upload theme… (or drop a file on the panel) adds a custom theme.
  • Export downloads the selected theme, built-in or custom, as a file you can edit.
  • Rename and Delete are available for custom themes only. Deleting the active theme switches back to TickMint Dark.

You can store up to 25 custom themes. They are saved in the local gateway and shared by every window (main window, pop-out charts, Script Editor, Journal).

Upload a theme

  1. Click Upload theme… and choose a .tmtheme.json file. TickMint checks it; nothing is saved yet.
  2. Review the dialog: name, base theme, color scheme, swatches, a mini candle strip, and any errors (red, block saving) or warnings (amber), each with its JSON path.
  3. Click Preview to apply the theme live behind the dialog. Click it again (or Cancel) to revert.
  4. Click Save & select. The gateway validates and stores the theme and selects it.
  5. Click Save in Settings to keep it as your theme (Discard returns to your previous theme; the upload stays in the list).

If a custom theme with the same name (ignoring case) already exists, choose Replace existing (keeps its id, so it stays selected wherever it was used) or Keep both (the upload gets a (2) suffix). If the gateway is unreachable, you see “Gateway unreachable, theme not saved.” and the preview reverts.

Theme file format

Theme files use the extension .tmtheme.json (plain .json is accepted), UTF-8, at most 128 KB.

{
"$schema": "https://tickmint.app/schemas/theme-v1.json", // optional, ignored
"format": "tickmint-theme", // required, exact
"version": 1, // required; only 1 is supported
"name": "Midnight Mint", // required, 1–40 characters
"description": "Dark with mint", // optional, up to 200 characters
"author": "dan", // optional, up to 60 characters
"extends": "cyber", // optional built-in id; default "tickmint-dark"
"colorScheme": "dark", // optional: "dark" | "light"
"ui": { "bg": "#05070A", "bull": "#3EB489" },
"chart": { "gridStyle": "solid", "grid": "rgba(40,40,40,0.5)" },
"candle": { "bull": "#3EB489", "bullBodyOpacity": 0.9 },
"drawing": { "defaultColor": "#3EB489", "palette": [{ "label": "Mint", "value": "#3EB489" }] },
"indicators": { "ema": { "color": "#3EB489", "lineWidth": 2 } }
}

Every section is optional and partial: the theme is the base theme (extends) plus your overrides. Only the overrides are stored, so later fixes to the built-in base still reach your theme. drawing.palette replaces the base palette; indicator settings merge per indicator. A custom theme can only extend a built-in theme, not another custom theme. Exporting a custom theme downloads exactly the stored file.

Base theme ids: tickmint-dark, tickmint, cyber, daylight, monochrome, oled, nord, accessible, terminal, tokyo.

Fields

Section Keys Allowed values
ui bg, surface, panel, subpanel, border, borderLight, hover, bull, bullDark, bear, bearDark, neonCyan, neonAmber, neonPurple, textMain, textSecondary, textMuted Hex only: #RGB or #RRGGBB
chart bg, axisBg, axisBorder, axisText, grid, crosshair, badgeBg, badgeText, priceLineColor, priceTextColor, countdownTextColor, countdownBgColor, sessionLineColor Hex (#RGB[A], #RRGGBB[AA]) or rgb() / rgba()
chart gridStyle "dashed" or "solid"
chart crosshairStyle "dashed", "dotted" or "solid"
candle bull, bullBorder, bullWick, bear, bearBorder, bearWick Hex or rgb() / rgba()
candle bullBodyOpacity, bearBodyOpacity Number 0–1
drawing defaultColor, fillColor Hex or rgb() / rgba()
drawing palette 1–16 entries of { "label": up to 24 chars, "value": color }
indicators <indicatorId>.<key> Only ids and keys that exist in the built-in themes; the value type must match. Numbers: *Opacity 0–1, lineWidth 0.5–8, markerSize / dotSize 1–20

Named colors (such as red), var(--x), url(...), gradients and other raw CSS are rejected.

Errors and warnings

Problem Result
Not JSON, over 128 KB, nesting deeper than 6 levels, more than 2,000 keys, or __proto__ / constructor / prototype keys Error
Missing or wrong format, non-integer version, invalid name, unknown extends Error
version greater than 1 Error: “This theme needs a newer version of TickMint.”
Invalid color, option or out-of-range number Error, with the JSON path
Unknown section, key or indicator Warning; the value is dropped
Low contrast (for example textMain on bg below 4.5:1) Warning; saving is allowed
Unreadable (textMain on bg or panel below 1.5:1, or bull and bear candles nearly identical) Critical warning; saving asks “Save anyway?”