Truly theme developer docs Guides Reference (format 1)

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