Skip to Content
Coinio

Appearance and customization

Themes, colours, fonts, dashboard cards, custom CSS and HTML cards.

Everything in Settings › Appearance applies right away and is saved a moment later. Back to default and Reset everything undo it.

Settings, Appearance: theme, accent colour and font pairs

Theme and colour

  • Theme: Paper (default), White, Night, Black, or System to follow your device. The account menu has a quick light/dark switch.
  • Accent colour: buttons, highlights and the chart line. Pick a preset or your own colour.
  • Category colours: the colour of each category in the breakdown and reports.

Type

Six font pairs, for headings and amounts and for text. Only the fonts of the pair you choose are downloaded.

NameFonts
Refined (default)Geist + Geist Mono
EditorialInstrument Serif + Inter
WarmFraunces + Manrope
TechnicalSpace Grotesk + IBM Plex Mono
BoldBricolage Grotesque + Inter
System fontYour device's own font

Layout and numbers

  • Density: roomy or compact.
  • Corner roundness: 0 to 20 px.
  • Logo shape: circle or rounded square.
  • Cents: small and raised, inline, or hidden.
  • Show the original currency under converted amounts.

Dashboard cards

In Settings › Appearance › Dashboard cards, reorder the dashboard by dragging (or with the arrow buttons), and hide cards with the switch: Greeting, This month, Summary, Upcoming payments, Quick add, This week, Monthly breakdown, Recent activity, All subscriptions, and your own HTML cards.

On the dashboard itself, every card has a ⋯ menu (top right, shown on hover or focus) to move it up or down or hide it; HTML cards also have Edit card. A new HTML card is placed right below the greeting so you see it straight away.

Custom HTML cards

Add up to 20 cards with your own HTML: notes, links, an embedded widget. Each has a title, a height (80 to 1200 px) and up to 50,000 characters of HTML, with a live preview.

A card follows the light or dark theme (its text colour adapts and its background is transparent) and starts with your accent colour as --accent, so color: var(--accent) works inside it. Your own styles override these.

How cards are sealed

Each card runs in an iframe with sandbox="allow-scripts" and without allow-same-origin. Scripts in the card run, but in a separate, anonymous origin: they cannot read your session cookie, call the Coinio API or see your subscriptions. By default a card only knows what you wrote into it; to give it live numbers, turn on Show my data to this card (below).

Deleting a card asks first; it cannot be undone.

Let a card read your data

Each HTML card has a Show my data to this card switch, off by default. Turning it on asks for confirmation: the card's code can then read your upcoming payments, amounts and totals, and could send them anywhere, so turn it on only for code you wrote or trust. Loading a theme file always turns it off on every card in that file.

When it is on, Coinio posts a read-only summary into the card with postMessage: once the card has loaded, again whenever your data changes, and whenever the card asks for it. The card still cannot call the API or change anything.

MessageDirectionShape
coinio:dataCoinio → card{ type: 'coinio:data', version: 1, data }
coinio:request-datacard → Coinio{ type: 'coinio:request-data' } (asks for a fresh coinio:data)

data has the same shape as the widget endpoint (GET /api/widget):

  • base: your main currency code, for example "EUR".
  • leftThisMonthMinor: what is still due this month, in hundredths of base (12999 means 129.99).
  • monthlyAverageMinor: the monthly average of all active subscriptions, in hundredths.
  • ratesStale: true when exchange rates are out of date and converted amounts are approximate.
  • items: up to six due payments, overdue first. Each has subscriptionId, name, dueDate (YYYY-MM-DD), amountMinor and currency in the subscription's own currency, baseMinor (converted, or null without a rate), daysLeft (negative when overdue), autoPay, variableAmount, reminderDays and logoPath.
  • generatedAt: when the summary was made (ISO 8601).

A small card that shows the next payment:

<p id="next" style="margin:16px;font:500 15px system-ui">Loading…</p>
<script>
  const money = (minor, currency) =>
    new Intl.NumberFormat(undefined, { style: 'currency', currency }).format(minor / 100);
  addEventListener('message', (e) => {
    if (e.data?.type !== 'coinio:data') return;
    const next = e.data.data.items[0];
    document.getElementById('next').textContent = next
      ? `${next.name}: ${money(next.amountMinor, next.currency)} on ${next.dueDate}`
      : 'Nothing due.';
  });
  parent.postMessage({ type: 'coinio:request-data' }, '*');
</script>

Custom CSS

Up to 50,000 characters of CSS, applied live on top of everything. The whole interface reads its colours, sizes and fonts from CSS variables, so overriding a few is usually enough:

:root {
  --accent: #e5484d;
  --radius: 4px;
  --font-text: Georgia, serif;
}

Your CSS wins over the accent colour and corner settings above. Coinio does not download fonts for custom CSS: use a font installed on your devices, or one of the font pairs under Type (their fonts are only loaded while that pair is selected).

The editor lists the main variables with their current values: --bg, --card, --sunk, --line, --text, --text-2, --accent, --primary, --pos, --neg, --radius, --gap, --logo, --font-text, --font-display, --font-num. Click one to add it.

If your CSS hides the app

Add ?nocss to the address, for example https://coinio.example.com/settings/appearance?nocss. Coinio then loads without your custom CSS and HTML cards until the next full reload, so you can fix or clear the CSS.

Share a theme

Download theme saves all appearance settings, including custom CSS and HTML cards, as coinio-theme.json. Load theme applies such a file after asking first: it replaces your current appearance, including your HTML cards and custom CSS, and warns when the file brings its own CSS or HTML. Download your own theme first if you want to keep it. Values a file gets wrong fall back to the defaults instead of failing, so themes from older versions still load. Theme files never contain subscriptions or account data.

Edit on GitHub

On this page