Appearance
Kit: salon (masters)
A salon or a barbershop: services by the hour, masters who each keep their own hours and say what they do.
kind: salon. What a kit is and how to lay one out: kits.
Taken whole, with the client's facts put into it; anything taken out is a decision said to the developer and written in the brief.
Ask
The facts only the business has. Never fill them in; what is not answered is NEEDS CLIENT.
- zone: the business's time zone — from its address; say it back rather than asking
- hours: when it is open — the kit does not guess them
- the services: each one's takes and costs
- the masters: who they are, their own hours when they differ, what each one does
Taken by default — say it, get a yes
What this kit chose for the trade. Say each back to the developer; a «no» is a new value in the bookings settings, jtk/modules/bookings.json.
- A booking is confirmed at once (
confirm: auto) — or does the business confirm each one by hand? - A visitor may cancel or move their booking themselves until 3 hours before it starts; after that only the business can (
cancel_until). - Nothing is paid online: the visitor pays on the day (
payment: no) — or a deposit, or in full when booking? - Bookable up to 60 days ahead (
horizon). - No sooner than an hour from now (
lead). - 10 minutes kept free after each booking, to get ready for the next (
buffer). - Start times offered every 15 minutes (
slot_every). - A visit may be several services, one after the other (
combine). - Shown to visitors: every master's name and its distinguishing marks, wherever a visitor may choose one; what is booked and their prices. Nothing goes into the marks that the client would not want printed.
- A new booking is sent where the site's enquiries go — the Telegram chat or the email a person links in the panel; an agent cannot link one. Ask which, and say it is theirs to link before the launch.
Collections
Where each one's entries are is its contract-3 route — and shown_on, for entries with no page of their own — as jtk create --kit writes it.
| collection | the diary's | uk | en | de | an entry is | where |
|---|---|---|---|---|---|---|
services | services | Послуги | Services | Leistungen | service | "route": "none", "shown_on": ["/services#services-{slug}"] |
masters | resources | Майстри | Masters | Mitarbeitende | master | "route": {"detail":"/masters/{slug}"} |
Settings
The keys of settings in jtk/modules/bookings.json (on contract 2, the older contract, the fields of the bookings_config block in jtk/bookings.json); the modules reference says what each does.
| field | value |
|---|---|
buffer | 10 |
cancel_until | 180 |
combine | true |
confirm | "auto" |
horizon | 60 |
kind | "salon" |
lead | 60 |
payment | "no" |
scale | "hourly" |
slot_every | 15 |
The kit, whole
As GET /v1/kits/salon serves it and jtk create --kit reads it: in contract 2's words, which jtk create --kit puts in contract 3's (laying a kit out). Not a file to copy into a contract-3 site.
json
{
"kind": "salon",
"version": 3,
"sum": "0223b1564370",
"about": "A salon or a barbershop: services by the hour, masters who each keep their own hours and say what they do.",
"ask": [
"zone: the business's time zone — from its address; say it back rather than asking",
"hours: when it is open — the kit does not guess them",
"the services: each one's takes and costs",
"the masters: who they are, their own hours when they differ, what each one does"
],
"catalogue": {
"blocks": [
{
"type": "service",
"v": 1,
"label": {
"uk": "Послуга",
"en": "Service",
"de": "Leistung",
"ru": "Услуга",
"es": "Servicio",
"it": "Servizio",
"pt": "Serviço",
"fr": "Prestation"
},
"fields": [
{
"key": "title",
"label": {
"uk": "Назва",
"en": "Name",
"de": "Name",
"ru": "Название",
"es": "Nombre",
"it": "Nome",
"pt": "Nome",
"fr": "Nom"
},
"kind": "text",
"required": true,
"max": 80,
"client_editable": true
},
{
"key": "takes",
"label": {
"uk": "Триває",
"en": "Takes",
"de": "Dauer",
"ru": "Длится",
"es": "Duración",
"it": "Durata",
"pt": "Duração",
"fr": "Durée"
},
"kind": "duration",
"required": true,
"min": 5,
"max": 480,
"client_editable": true
},
{
"key": "costs",
"label": {
"uk": "Ціна",
"en": "Price",
"de": "Preis",
"ru": "Цена",
"es": "Precio",
"it": "Prezzo",
"pt": "Preço",
"fr": "Prix"
},
"kind": "money",
"client_editable": true
}
]
},
{
"type": "master",
"v": 1,
"label": {
"uk": "Майстер",
"en": "Master",
"de": "Teammitglied",
"ru": "Мастер",
"es": "Profesional",
"it": "Professionista",
"pt": "Profissional",
"fr": "Professionnel"
},
"fields": [
{
"key": "title",
"label": {
"uk": "Ім’я",
"en": "Name",
"de": "Name",
"ru": "Название",
"es": "Nombre",
"it": "Nome",
"pt": "Nome",
"fr": "Nom"
},
"kind": "text",
"required": true,
"max": 80,
"client_editable": true,
"localized": false
},
{
"key": "cover",
"label": {
"uk": "Фото",
"en": "Photo",
"de": "Foto"
},
"kind": "media",
"accept": "image",
"client_editable": true
},
{
"key": "hours",
"label": {
"uk": "Власні години",
"en": "Own hours",
"de": "Eigene Zeiten",
"ru": "Свои часы",
"es": "Horario propio",
"it": "Orari propri",
"pt": "Horário próprio",
"fr": "Horaires propres"
},
"kind": "list",
"max": 21,
"client_editable": true,
"of": [
{
"key": "day",
"label": {
"uk": "День",
"en": "Day",
"de": "Tag",
"ru": "Сутки",
"es": "Día",
"it": "Giorno",
"pt": "Dia",
"fr": "Jour"
},
"kind": "select",
"options": [
"monday",
"tuesday",
"wednesday",
"thursday",
"friday",
"saturday",
"sunday"
],
"required": true,
"client_editable": true,
"no_tap_target": true
},
{
"key": "opens",
"label": {
"uk": "Відкриття",
"en": "Opens",
"de": "Öffnet",
"ru": "Открытие",
"es": "Abre",
"it": "Apre",
"pt": "Abre",
"fr": "Ouverture"
},
"kind": "time_of_day",
"required": true,
"client_editable": true,
"no_tap_target": true
},
{
"key": "closes",
"label": {
"uk": "Закриття",
"en": "Closes",
"de": "Schliesst",
"ru": "Закрытие",
"es": "Cierra",
"it": "Chiude",
"pt": "Fecha",
"fr": "Fermeture"
},
"kind": "time_of_day",
"required": true,
"client_editable": true,
"no_tap_target": true
}
]
},
{
"key": "does",
"label": {
"uk": "Що робить",
"en": "Does",
"de": "Macht",
"ru": "Что делает",
"es": "Realiza",
"it": "Esegue",
"pt": "Faz",
"fr": "Prestations assurées"
},
"kind": "list",
"max": 40,
"client_editable": true,
"of": [
{
"key": "service",
"label": {
"uk": "Послуга",
"en": "Service",
"de": "Leistung",
"ru": "Услуга",
"es": "Servicio",
"it": "Servizio",
"pt": "Serviço",
"fr": "Prestation"
},
"kind": "ref",
"ref": "services",
"required": true,
"client_editable": true,
"no_tap_target": true
}
]
}
]
}
],
"collections": [
{
"name": "services",
"label": {
"uk": "Послуги",
"en": "Services",
"de": "Leistungen",
"ru": "Услуги",
"es": "Servicios",
"it": "Servizi",
"pt": "Serviços",
"fr": "Prestations"
},
"one": {
"uk": "послуга",
"en": "service",
"de": "Leistung",
"ru": "услуга",
"es": "servicio",
"it": "servizio",
"pt": "serviço",
"fr": "prestation"
},
"icon": "lucide:list",
"prefix": "/services",
"type": "service",
"pages": false
},
{
"name": "masters",
"label": {
"uk": "Майстри",
"en": "Masters",
"de": "Mitarbeitende",
"ru": "Мастера",
"es": "Profesionales",
"it": "Professionisti",
"pt": "Profissionais",
"fr": "Professionnels"
},
"one": {
"uk": "майстер",
"en": "master",
"de": "Teammitglied",
"ru": "мастер",
"es": "profesional",
"it": "professionista",
"pt": "profissional",
"fr": "professionnel"
},
"icon": "lucide:users",
"prefix": "/masters",
"type": "master"
}
],
"modules": {
"bookings": {
"services": "services",
"resources": "masters"
}
}
},
"settings": {
"kind": "salon",
"scale": "hourly",
"slot_every": 15,
"buffer": 10,
"lead": 60,
"horizon": 60,
"confirm": "auto",
"cancel_until": 180,
"payment": "no",
"combine": true
},
"entries": [],
"changes": [
{
"from": "1",
"says": "Five more languages: every label, collection name and rate of the kit now says ru, es, it, pt and fr beside uk, en and de (7 October 2026)."
},
{
"from": "2",
"says": "A master's name is the same in every language: on a contract-3 site the `title` of the `master` type says `\"localized\": false`, so it is not counted as words to translate — add it to your schema; a contract-2 schema has no such key and leaves it out (12 November 2026)."
}
]
}