Give your ordering page your own theme

Add a theme as a .zip file, then choose it for the Telegram Mini App, the QR code and link, or both.

Where
Console → Stores → the store → Pick-up ordering

A theme gives your pick-up page and Telegram Mini App a design of their own: its colors, pictures and fonts. You make it once, or a designer you hire does, and add it as a .zip file in the console, on the web or in the Console app. Then choose it for a place, and customers see your design instead of a Bill&Go page look. Themes come with Growth and up.

Make the theme file

A theme is a .zip file. Its files sit beside theme.json, or in a folder zipped with them:

  • theme.json: the theme’s name, id, version and author, the modes it works in (light and dark, light only or dark only), the files it uses, and the settings it offers.
  • theme.css: its styles, up to 150 KB.
  • Its pictures and fonts: png, jpg, webp or woff2 files. No SVG.

A theme has up to 30 files, each at most 1 MB, and 5 MB in all.

Add a theme

  1. Open Stores, choose the store, then its Pick-up ordering tab.
  2. Under Your themes, press Add theme and choose the theme’s .zip file.
  3. Each theme shows its name, version, author and modes. To take one away, press Remove and confirm.

Adding a theme with the same id again replaces it, as a new version. The stores wearing it keep wearing it.

Wear it in the Mini App, on the QR code, or both

The Telegram Mini App and the QR code and link each have a page look group, and it now has a Theme choice: None: the page look above, or one of your themes. A theme is worn instead of the page look. Choosing is per store and per place: one theme for the Mini App, another for the QR code, or None for either.

  1. In the page look group of the place, Page look in the Mini App or Page look on the QR code and link, find Theme.
  2. Under Theme, choose one of your themes, or None: the page look above to go back.

A theme made for only light or only dark is shown in that mode, and the customer’s light and dark switch steps aside.

What a theme may do

Every theme is checked when it is added. A theme may style the page, but never write on it or change what it says. In particular:

  • The order button keeps its color, and error colors and prices stay visible.
  • Keyboard focus stays visible, and Reduce Motion is respected.
  • It links to no other website: no @import, and no picture or font from another address.
  • It uses no !important.

A theme that breaks a rule is refused, and the message lists every problem with its line. Fix the file, then add it again.

Plans

Good to know. Your own themes come with Growth and up. Below Growth, the page shows the store’s page look again. The chosen theme is kept, and it comes back on upgrade. Removing a theme works on any plan; stores that wore it go back to their page look.

Who makes a theme

The owner, or a designer the owner hires. A theme is written against a versioned set of page parts, states and colors. All of it is in the theme kit, with a starter theme to begin from.

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