Getting started from the default theme
A theme is a zip with a manifest, one layout, one template per page, snippets, a stylesheet, images, fonts and Danish and English strings. The layout follows Shopify's: if you have built a Shopify theme, most of this will feel familiar. There is no JavaScript: Truly's components draw everything interactive (the pickers, the calendar, the forms, the consents and the order button), and your templates place them as slots.
1. Download the default theme
In the back office, a tenant owner, admin or theme developer opens Settings > Brand & Apps > Theme and clicks Download the default theme. The zip is today's booking pages in the theme format, and it uploads unchanged. Its coverage.json lists the pages the default theme draws; Truly ignores the file in your upload, and every page it does not list keeps today's design whatever the theme says.
2. Look around
manifest.json { "name": "…", "version": "1.0.0", "format_version": 1 }
layout/theme.liquid wraps every page
templates/<route>.liquid one per page, e.g. templates/booking.services.liquid
snippets/<name>.liquid pieces you {% render 'name' %}
assets/theme.css your stylesheet
assets/<name>.webp images (PNG, JPEG or WebP) and .woff2 fonts
locales/da.json your strings, Danish
locales/en.json and English
The default layout is one line:
{% slot 'cookie_banner' %}{% slot 'header' %}{{ content_for_layout }}{% slot 'footer' %}
and most templates are a single slot, for example templates/booking.services.liquid:
{% slot 'service_picker' %}
3. Make a change
Give the services page a heading and the location's address around the picker:
<section class="intro">
<h1>{{ 'services.title' | t }}</h1>
<address>{{ location.address_line }}, {{ location.postal_code }} {{ location.city }}</address>
</section>
{% slot 'service_picker' %}
Add "services": { "title": "Vælg behandling" } to locales/da.json and "services": { "title": "Choose a treatment" } to locales/en.json, and style .intro in assets/theme.css. Change name and version in manifest.json so you can tell your versions apart.
4. Upload and check
Zip the folder's contents (the manifest at the top of the zip, not inside a folder) and upload it on the same back-office page. The check report lists every problem with a reason, file and line; see The check report. A package that passes becomes a draft version.
5. Publish
A draft changes nothing for customers. Publishing it, in the theme library, shows it on the tenant's verified custom domain. Themes never show on Truly's own booking host.
Next
- The edit, push and preview loop
- Slots and styling
- Locales
- The reference: routes and states, drops, slots, markup, CSS, package format.