Design a theme for a shop’s ordering page: the Bill&Go theme kit

For designers and developers: the theme kit is out. Download the starter theme, write CSS against the ordering page’s parts and tokens, and a shop on Growth or Pro adds it in its console. Every theme is checked, and the order button, prices and errors stay safe.

· The Bill&Go team

Shops on Bill&Go take orders from a page of their own: in their Telegram Mini App, and from the QR code on the counter or the link they share. Since yesterday, a shop on Growth or Pro can dress that page in a theme of its own. Today we are publishing what a designer needs to make one: the theme kit.

What a theme is

A theme is CSS, with its pictures and fonts, in one .zip. It styles the page; it never changes it. The menu, the prices, the basket and paying are the page’s own, so whatever a theme does, an order still works.

  • theme.json: the theme’s id, name, version, author, the modes it is for (light, dark or both), its files, and up to 12 settings the owner can change without touching your CSS.
  • theme.css: your styles, one file, up to 150 KB.
  • Pictures and fonts: png, jpg, webp and woff2, beside theme.css. No SVG.

Start from the starter theme

  1. Download the starter theme from the theme kit. It already passes every check.
  2. Unzip it and give it your own id and name in theme.json.
  3. Set the page’s tokens (--bg, --panel, --ink, --look-r and the rest), for light and for [data-theme="dark"], then style its parts: .to-head, .to-section, .po-dish, .po-card, .to-bar.
  4. Zip it again and hand it to the shop. The owner adds it under Stores → the store → Pick-up ordering → Your themes, on the web or in the Console app, and picks it for the Mini App, the QR code page or both.

Tip. Write your rules for the page as it is, without any prefix. When the theme is added, every rule is scoped to it, so it never reaches another part of Bill&Go.

Settings the owner changes

A theme can offer colors and switches. A color has a light and a dark value and reaches your CSS as var(--setting-<id>). A switch, when on, sets html[data-setting-<id>]. The starter theme has two colors (the page and the cards) and one switch (square corners), so you can see both at work.

The shop’s brand stays the shop’s

Read the shop’s accent from --acc-solid, --acc-ink, --acc-tint and --acc-line: it is made readable for each mode. One theme can then dress many shops, each in its own color.

What is checked, and what never changes

Every package is checked when it is added. A refusal lists every problem with its line, so you fix them all in one go. The checker refuses, among others:

  • @import, and any url() to something outside the package.
  • !important, and setting a locked color: the order button, statuses and errors.
  • Text in content, so a theme cannot write a fake price on the page.

Then, after your CSS, the page adds rules no theme can outrank: the order button keeps its color and stays readable, errors keep their red, prices are always there, keyboard focus is always visible, and under Reduce Motion nothing moves.

Ship a new version

Add the same id again with a new version, and it replaces the old one at that shop. The stores wearing it keep it. Each upload is served at a new address, so customers never see half of one.

A page that stays put

Every class, state and token on the theme kit page is page version 1, and every theme today is made for it. We only add to it, never rename or take away, so a theme you make now keeps working as Bill&Go grows.

Good to know. A shop adds its own themes on Growth and up, from $43.99 a month. To reach every shop, it sends the theme to the theme gallery: once Bill&Go lists it, shops on Starter and up can wear it. Designing and zipping a theme needs no account at all.

Questions

Do I need a Bill&Go account to make a theme?

No. Download the starter theme, write your CSS and zip it: you need no account for that. To see your theme on a real ordering page, the shop it is made for adds it in its console. Adding a theme comes with the Growth and Pro plans.

Can a theme change the menu, prices or the order button?

No. A theme styles the page and never writes on it. The order button keeps its color, prices and errors stay visible, and a theme that breaks a rule is refused with every problem listed by line.

Can a theme load a font from Google Fonts?

No. A theme links only to its own files, so put the font in the package as a woff2 file and list it in theme.json. For Khmer and Chinese, use a font that has their letters, or keep the page’s own font.

How do I update a theme a shop already wears?

Add it again with the same id and a new version. It replaces the old one at that shop, and the stores wearing it keep it.

Still stuck?

Tell the Bill&Go team in Phnom Penh what you were trying to do, and we'll walk you through it.

Talk to us