# Créer et modifier le thème de ta boutique **Moteur de thème 1.3.0** — publié le 17 septembre 2026. Ce guide décrit cette release ; le chapitre Versions liste ce que chaque release apporte. Tout ce qu'il faut pour construire ou modifier le thème de ta boutique, seul ou avec un agent IA : langage de gabarit, contrat de fichiers, objets, URL, codes de validation, outillage. ## 1. Vue d'ensemble Un thème est un dossier de fichiers texte (plus quelques images) dont la structure de premier niveau est fixe. Tout autre dossier est ignoré. ``` assets/ CSS, JS, SVG et images matricielles servis depuis l'origine du site blocks/ Sources de blocs réutilisables config/ Métadonnées du thème, schéma des réglages globaux, valeurs enregistrées layout/ Coquilles de page ; layout/theme.liquid est obligatoire locales/ Catalogues de traduction, un fichier JSON par langue de boutique sections/ Sources de sections (*.liquid) et groupes de sections (*.json) snippets/ Fragments rendus avec {% render %} ou {% include %} templates/ Un fichier par surface de boutique (*.liquid ou *.json) ``` Les gabarits sont écrits en Liquid, rendus côté serveur et analysés strictement: une balise ou un filtre inconnu est une erreur. Deux façons de travailler sur un thème, sur le même brouillon et sous le même contrat : | | Flux CLI | Flux connecteur MCP | | --- | --- | --- | | Point d'entrée | `pip install rankapp-cli`, puis `rankapp site login ` | Se connecter à `https://mcp.rankapp.io` via OAuth | | Copie de travail | Un dépôt Git local créé par `rankapp site pull` | Un espace de préparation côté serveur | | Validation | `rankapp site check` (hors ligne) | `site_validate` | | `theme_upgrade_read` | Un fichier de la version actuelle du thème de base au catalogue, quand `site_brief` signale une mise à jour : la base à laquelle adapter une copie personnalisée (chapitre 11.3). | | Aperçu | `rankapp site dev` (local), `rankapp site preview` (hébergé) | `site_preview` | | Soumission | `git push rankapp main` | `theme_commit` | | Publication | Nécessite un droit distinct ; désactivée par défaut | Jamais disponible | Lire d'abord la section 5 : le marchand compose ses pages dans un éditeur visuel, et c'est le contrat des sections qui rend un thème modifiable là-bas. ## 2. Démarrage rapide ### 2.1 De bout en bout avec la CLI ```bash pip install rankapp-cli rankapp site login rk_site_xxxxxxxxxxxxxxxxxxxxxxxx rankapp site pull ma-boutique cd ma-boutique rankapp site check rankapp site dev rankapp site section-previews git add -A && git commit -m "Ajouter la section highlight" git push rankapp main rankapp site preview ``` Chaque commande, ses options (`--json`, `--offline`, `--out`, `--locale`), le dépannage par code d'erreur et les règles d'accès sont documentés avec la CLI elle-même, sur [pypi.org/project/rankapp-cli](https://pypi.org/project/rankapp-cli/). `rankapp site --help` donne l'aide à chaque niveau. Relancer `rankapp site section-previews` après avoir modifié une section, un fragment qu'elle rend, une ressource référencée, la coquille ou un style global. Une réussite locale de `check` ne garantit pas une réussite côté serveur : l'envoi vérifie en plus les références des Pages. Un crochet de pré-commit refuse un commit contenant un jeton d'accès. Si un envoi entre en conflit avec une modification faite par le marchand dans l'application : ```bash git pull --no-rebase rankapp main rankapp site check rankapp site section-previews git push rankapp main ``` ### 2.2 De bout en bout avec un client MCP Se connecter à `https://mcp.rankapp.io` via OAuth. L'accès est lié à un seul site. | Ordre | Outil | Rôle | | --- | --- | --- | | 1 | `site_brief` | Identité du site, langues, quotas, gabarits, Pages et règles. Toujours en premier. | | 2 | `theme_list` | Lister les fichiers du thème. `source` vaut `staged` par défaut ; `source: "draft"` lit le brouillon du marchand. | | 3 | `theme_read` | Lire un fichier ; renvoie sa `revision` et le `draftGeneration` courant. | | 4 | `theme_write`, `theme_delete` | Préparer un fichier. Fournir `expected_revision` (`0` pour un nouveau chemin) et `expected_draft_generation` issus de la lecture qui vient d'être faite. | | 5 | `theme_workspace` | Ce qui est préparé, sa révision, un éventuel conflit, et si un commit est en cours. | | 6 | `theme_rebase` | Rejouer les changements préparés sur un brouillon qui a bougé : comparer `theme_read source=draft` et `source=staged`, puis fournir le contenu fusionné dans `resolutions` (`null` supprime le fichier). | | 7 | `theme_commit`, `theme_status` | Committer les fichiers préparés, puis lire ou attendre brièvement l'état du commit. | | 8 | `site_validate` | Compiler et valider le vrai brouillon et ses Pages. Après le commit, jamais avant. | | 9 | `site_preview` | Créer un aperçu privé et temporaire lié au site. | | — | `site_guide` | Cette référence : le sommaire (`chapters` avec des identifiants stables), ou un chapitre avec `section=`, en `locale` `fr` ou `en`. | | — | `section_previews_refresh` | Remettre à jour les vignettes de presets de sections du brouillon ; met le rendu en file et retourne `{queued, stale}`. `site_validate` renvoie `sectionPreviews: {status, stale}`. | | — | `section_scaffold` | Renvoyer la source d'une nouvelle section déjà conforme au contrat de l'éditeur ; l'adapter, puis la préparer avec `theme_write`. | | — | `pages_list`, `page_get`, `page_save`, `page_delete` | Pages canoniques. `page_save` et `page_delete` prennent un `expected_revision` lu via `page_get`. | La publication ne fait pas partie de cet ensemble d'outils. ### 2.3 Une section minimale et complète À enregistrer sous `sections/highlight.liquid`. C'est le plus petit fichier qui respecte le contrat des sections : un nom lisible, un réglage par chaîne visible, un preset avec une catégorie, et aucun texte visible en dur. ```liquid
{% if section.settings.eyebrow != blank %}

{{ section.settings.eyebrow | escape }}

{% endif %} {% if section.settings.heading != blank %}

{{ section.settings.heading | escape }}

{% endif %} {% if section.settings.body != blank %}

{{ section.settings.body | escape }}

{% endif %} {% if section.settings.button_label != blank %} {{ section.settings.button_label | escape }} {% endif %}
{% schema %} { "name": "Highlight", "limit": 2, "disabled_on": { "groups": ["header", "footer"] }, "settings": [ { "type": "text", "id": "eyebrow", "label": "Eyebrow" }, { "type": "text", "id": "heading", "label": "Heading" }, { "type": "textarea", "id": "body", "label": "Body" }, { "type": "text", "id": "button_label", "label": "Button label" }, { "type": "url", "id": "link", "label": "Button link" } ], "presets": [ { "name": "Highlight", "category": "Contenu", "settings": { "eyebrow": "New season", "heading": "Made to be worn every day", "body": "A short selection, cut and finished to last.", "button_label": "Browse the collection", "link": "/collections/all" } } ] } {% endschema %} ``` L'ajouter à la page d'accueil en éditant `templates/index.json` : ```json { "sections": { "highlight": { "type": "highlight", "settings": {} } }, "order": ["highlight"] } ``` Puis `rankapp site check`, `rankapp site section-previews`, `rankapp site dev`. ## 3. Structure d'un thème ### 3.1 Dossiers Seuls ces dossiers de premier niveau sont lus. Tout le reste de l'arborescence est ignoré à la lecture et n'est pas envoyé. | Dossier | Contenu | Remarques | | --- | --- | --- | | `assets/` | `.css`, `.js`, `.svg`, `.txt`, `.json` et images matricielles | Seul endroit où les images matricielles sont acceptées | | `blocks/` | Sources de blocs réutilisables | | | `config/` | `rankapp_theme.json`, `settings_schema.json`, `settings_data.json`, `rankapp_section_previews.json` | | | `layout/` | Coquilles de page | `layout/theme.liquid` est obligatoire | | `locales/` | `[-][.default].json` | Exactement un fichier `.default` | | `sections/` | Sections `.liquid` et groupes `.json` | | | `snippets/` | Fragments pour `{% render %}` / `{% include %}` | | | `templates/` | Un fichier par surface de boutique, `.liquid` ou `.json` | | ### 3.2 Types de fichiers et limites | Catégorie | Extensions | Emplacement | | --- | --- | --- | | Texte | `.css` `.js` `.json` `.liquid` `.svg` `.txt` | Partout dans le thème | | Image matricielle | `.jpg` `.jpeg` `.png` `.gif` `.webp` `.avif` | Sous `assets/` uniquement | | Vidéo | `.mp4` `.webm` | Sous `assets/` uniquement | Toute autre extension est refusée avec `THEME_PATH_INVALID`. Les liens symboliques sont refusés. Un chemin de thème fait au plus 512 octets et ne doit contenir ni `..`, ni antislash, ni caractère de contrôle. | Limite | Valeur | | --- | --- | | Fichiers par thème | 2 000 | | Octets par fichier (texte) | 1 Mio | | Source totale du thème (texte) | 25 Mio | | Octets par image | 15 Mio | | Volume des images d'une boutique | 1 Gio (3 Gio selon l'offre) | | Vidéos par thème | 4 | | Octets par vidéo | 16 Mio | | Longueur d'un chemin de thème | 512 octets | `assets/` est l'unique dossier de fichiers d'une boutique : images, vidéos, polices, tout ce que le thème sert. Les images et les vidéos ne comptent pas dans la source totale. Une image est stockée **exactement telle qu'elle est poussée** : la plateforme ne la redimensionne, ne la recadre ni ne la réencode jamais. Produire les tailles, vignettes et formats dont tes gabarits ont besoin se fait sur ta machine avant le push (l'original et ses déclinaisons vivent tous dans `assets/`) ; chaque image fait au plus 15 Mio et l'ensemble tient dans le volume de la boutique. Chaque vidéo est limitée à 16 Mio et un thème en contient au plus 4. Dépasser ces limites renvoie `THEME_FILE_TOO_LARGE`, `THEME_SOURCE_TOO_LARGE`, `THEME_IMAGE_TOO_LARGE`, `THEME_IMAGES_TOO_LARGE`, `THEME_VIDEO_TOO_LARGE` ou `THEME_VIDEO_LIMIT`. Une vidéo de thème est servie telle quelle, en lecture progressive, et compte dans le trafic de la boutique comme n'importe quel fichier de `assets/`. Encoder en H.264 (`.mp4`) ou VP9 (`.webm`), sans piste audio pour un fond, en 1080p au plus ; une boucle de 10 à 20 secondes tient dans 16 Mio. Dans une section, un réglage de type `theme_video` propose au marchand les vidéos présentes dans `assets/` et donne au gabarit l'URL servie : ```liquid {% if section.settings.video != blank %} {% endif %} ``` La hero du thème de référence suit ce modèle avec son réglage `video` ; l'image reste l'affiche et le seul média chargé avant lecture. Pour poser la vidéo : la déposer dans `assets/` (CLI, ou « Importer une vidéo » dans l'éditeur de code de l'application), puis la choisir dans le réglage. ### 3.3 Fichiers obligatoires | Exigence | Erreur en cas d'absence | | --- | --- | | `layout/theme.liquid` | `MISSING_LAYOUT` | | Au moins un fichier sous `templates/` | `MISSING_TEMPLATE` | | `templates/index.liquid` ou `templates/index.json` | `MISSING_INDEX_TEMPLATE` | ### 3.4 `config/rankapp_theme.json` Identité du thème : ```json { "contract": "rankapp-native-theme-v1", "id": "rankapp-default", "name": "RankApp Essentiel", "version": "1.39.0", "engine": "1.3", "provenance": "original-rankapp", "runtime_dependencies": [] } ``` | Clé | Signification | | --- | --- | | `id` | Identifiant du thème, `^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$` | | `name` | Nom lisible du thème | | `version` | Version du thème, `^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$` | | `engine` | Release du moteur de thème pour laquelle le thème est écrit, `MAJEUR.MINEUR` (chapitre Versions). Le thème tourne sur tout moteur du même majeur au moins aussi récent ; un majeur différent ou un moteur trop ancien bloque la validation | Laisser les autres clés telles qu'elles sont générées. ### 3.5 `config/settings_schema.json` Un **tableau JSON de groupes**, pas un objet. Chaque groupe porte un `name` et un tableau `settings` utilisant la même forme de réglage qu'un schéma de section. ```json [ { "name": "Identity", "settings": [ { "type": "image_picker", "id": "logo", "label": "Logo" }, { "type": "color", "id": "accent_color", "label": "Accent", "default": "#292621" }, { "type": "text", "id": "announcement", "label": "Announcement bar", "default": "" } ] }, { "name": "Typography", "settings": [ { "type": "select", "id": "heading_font", "label": "Heading font", "options": [ { "value": "editorial", "label": "Editorial" }, { "value": "classic", "label": "Classic" } ], "default": "editorial" } ] } ] ``` Un identifiant de réglage déclaré dans deux groupes est une erreur `DUPLICATE_SETTING_ID`. Chaque réglage déclaré est accessible en Liquid via `settings.`. ### 3.6 `config/settings_data.json` Valeurs enregistrées des réglages globaux. `current` est soit un nom de preset, soit un objet en ligne ; `presets` associe un nom de preset à un objet de valeurs. Le nom de preset par défaut est `Default`. ```json { "current": "Essentiel", "presets": { "Essentiel": { "accent_color": "#292621", "background_color": "#f8f6f2", "heading_font": "editorial" } } } ``` L'objet `settings` est construit en fusionnant les valeurs par défaut du schéma avec le preset courant, en écartant toute clé non déclarée dans `settings_schema.json`, puis en hydratant chaque valeur selon son type déclaré (section 5.3). ### 3.7 Identifiants de réglage protégés Un thème ne doit déclarer aucun de ces identifiants ; en déclarer un lève `PROTECTED_THEME_SETTING`. | Identifiant | | --- | | `theme_contract` | | `theme_assets` | | `theme_assets_ready` | | `theme_import_id` | | `catalog_theme_id` | | `catalog_theme_version` | | `site_origin` | | `storefront_currency` | ### 3.8 Grammaire de `locales/` et formes plurielles Grammaire de nom de fichier : `locales/[-][.default].json`. | Règle | Détail | | --- | --- | | Langue par défaut | Exactement un fichier porte `.default`. Zéro ou deux est une erreur. | | Unicité | Deux fichiers résolvant vers la même locale canonique est une erreur. | | Fichiers de schéma | Les fichiers `*.schema.json` sont ignorés par le catalogue de traduction. | | Clés | Chemins pointés, résolus segment par segment dans des objets imbriqués. | | Valeurs | Une chaîne, ou un objet de catégories plurielles CLDR. | | Repli | Une clé absente de la langue active retombe sur la langue par défaut. Une clé absente de celle-ci donne `MISSING_TRANSLATION_KEY`. | | Échappement | La chaîne résolue est échappée en HTML, sauf si le dernier segment de clé se termine par `_html`. Les valeurs interpolées sont toujours échappées. | | Interpolation | Marqueurs `{{ nom }}`, remplis uniquement par des arguments nommés. Une valeur manquante est une erreur. | | Pluriels | Quand la valeur est un objet, `count:` choisit la catégorie CLDR de la langue active, avec repli sur `other`. | ```json { "general": { "skip_to_content": "Skip to content", "play_video": "Play the video" }, "cart": { "title": "Cart", "item_count": { "one": "{{ count }} item", "other": "{{ count }} items" } }, "footer": { "legal_html": "Read our terms." } } ``` ```liquid {{ 'general.skip_to_content' | t }} {{ 'cart.item_count' | t: count: cart.item_count }} {{ 'footer.legal_html' | t }} ``` Les `label`, `info` et `name` de schéma sont des chaînes littérales. ### 3.9 `date_formats` Un fichier de langue peut porter un objet `date_formats`. Ses entrées nomment les formats utilisables avec le filtre `time_tag`. Les entrées de la langue par défaut sont fusionnées d'abord, puis remplacées par celles de la langue active. ```json { "date_formats": { "date": "%d %B %Y", "date_at_time": "%d %B %Y at %H:%M", "month_day_year": "%B %-d, %Y" } } ``` ```liquid {{ article.published_at | time_tag: format: 'date' }} ``` ## 4. Coquille et gabarits ### 4.1 `layout/theme.liquid` Coquille de page, obligatoire, utilisée pour chaque page. Squelette : ```liquid {{ page_title | default: shop.name | escape }} {% if page_description %} {% endif %} {% for alternate in page_alternates %} {% endfor %} {{ content_for_header }} {% sections 'header-group' %}
{{ content_for_layout }}
{% sections 'footer-group' %} ``` ### 4.2 `content_for_header` et `content_for_layout` Ce sont des **chaînes du contexte**, pas des balises. Les afficher avec `{{ }}`. | Variable | Contenu | Emplacement | | --- | --- | --- | | `content_for_header` | Balisage d'en-tête requis par la boutique | Dans ``, avant les scripts du thème | | `content_for_layout` | Le contenu du gabarit rendu pour cette page | Dans la zone de contenu principale | Ne pas retirer ni réécrire `{{ content_for_header }}` : la recherche, les filtres, le panier, le compte et le paiement en dépendent. ### 4.3 Gabarits JSON Un gabarit JSON liste les sections d'une surface et leur ordre. ```json { "sections": { "hero": { "type": "rankapp-hero", "settings": { "layout": "fullscreen" } }, "features": { "type": "features", "settings": { "heading": "Why us" }, "blocks": { "b1": { "type": "feature", "settings": { "title": "Shipped in 48h" } }, "b2": { "type": "feature", "settings": { "title": "Free returns" } } }, "block_order": ["b1", "b2"] }, "legacy": { "type": "old-banner", "disabled": true } }, "order": ["hero", "features", "legacy"] } ``` | Clé | Type | Signification | | --- | --- | --- | | `sections` | objet | Association d'un identifiant de section à une instance | | `sections..type` | chaîne, obligatoire | Le fichier `sections/.liquid` à rendre. Une valeur non textuelle donne `INVALID_TEMPLATE_JSON` ; un type inconnu donne `MISSING_SECTION`. | | `sections..settings` | objet | Valeurs remplaçant celles du schéma | | `sections..blocks` | objet ou tableau | Instances de blocs, chacune `{ "type": ..., "settings": {...} }` | | `sections..block_order` | tableau d'identifiants | Ordre de rendu des blocs | | `sections..disabled` | booléen | À `true`, l'instance est ignorée | | `order` | tableau d'identifiants | Ordre de rendu des sections | Les identifiants de section sont des repères visibles par le marchand dans l'éditeur visuel. Les garder stables : renommer un identifiant détache les réglages enregistrés par le marchand. ### 4.4 Gabarits `.liquid` et priorité Un gabarit peut aussi être un simple fichier `.liquid`, rendu directement comme contenu de page, sans liste de sections. Quand `templates/.liquid` et `templates/.json` existent tous les deux, **le fichier `.liquid` gagne**. Noms de gabarits : `index`, `product`, `collection`, `list-collections`, `search`, `cart`, `page`, `policy`, `contact`, `404`, `customers/login`, `customers/register`, `customers/account`, `checkout`, ainsi que les variantes suffixées comme `page.about` et `policy.cgv`. ### 4.5 Groupes de sections Un groupe de sections est un fichier `sections/.json` : ```json { "type": "header", "sections": { "announcement": { "type": "announcement-bar", "settings": {} }, "header": { "type": "rankapp-header", "settings": {} } }, "order": ["announcement", "header"] } ``` `type` vaut `header`, `footer` ou `aside`. Seuls `header-group` et `footer-group` sont pré-rendus pour une page et accessibles avec : ```liquid {% sections 'header-group' %} {% sections 'footer-group' %} ``` `{% sections %}` affiche une chaîne déjà rendue. Le groupe doit correspondre à un fichier `sections/.json` existant, faute de quoi la validation signale `MISSING_SECTION`. ## 5. Sections et blocs ### 5.1 Le contrat des sections Le marchand sélectionne une section dans l'aperçu, la déplace, la duplique et modifie ses textes dans un formulaire. Cela ne fonctionne que si chaque chaîne visible correspond à un réglage et à un seul. | Règle | Raison | | --- | --- | | Une bande visuelle = un `sections/.liquid` | L'éditeur sélectionne, déplace et duplique des sections entières. Une page enfermée dans un fichier ne peut plus être recomposée. | | Pas de section fourre-tout | Une section qui rend trois bandes sans rapport ne peut pas être réordonnée bande par bande. | | Un `{% schema %}` complet avec un `name` lisible | Le `name` est ce que le marchand voit dans la liste des sections. | | Un réglage par texte, image, lien ou choix visible | Cliquer sur un texte dans l'aperçu doit désigner un identifiant de réglage. Une chaîne sans réglage n'est pas modifiable. | | Des `blocks` pour les éléments répétés | Cartes, avantages, témoignages, logos, questions fréquentes. Répéter `item_1_title`, `item_2_title` est une erreur. | | Au moins une entrée `presets` avec `name` et `category` | Sans preset, la section ne peut pas être insérée depuis la bibliothèque. | | `category` parmi `Bannières`, `Produits`, `Collections`, `Contenu`, `Mise en page`, `Spécifiques` | Ce sont les groupes de la bibliothèque. Un libellé non reconnu tombe dans le groupe de repli. | | Des `settings` de preset avec un contenu par défaut crédible | Une section insérée doit paraître finie, pas vide. | | Aucun texte visible en dur dans le Liquid | Ce qui n'est ni derrière un réglage, ni derrière un réglage de bloc, ni un champ de Page natif, ni une clé de traduction `t` n'est ni modifiable ni traduisible. | | Conserver le conteneur de section généré et ses identifiants | Le remplacer par un conteneur maison casse le rendu de section. | | `limit` / `max_blocks` quand la duplication n'a pas de sens | L'éditeur grise « dupliquer » au-delà de la limite. | | `enabled_on` / `disabled_on` pour dire où une section a sa place | Une hero appartient à `index` et `page`, pas au groupe de pied de page. | | Réutiliser avant de créer | Un nouveau besoin visuel est souvent un preset ou un type de bloc d'une section existante. | L'en-tête et le pied de page vivent dans les groupes de sections, dans la coquille. Les sections de page vivent dans `templates/*.json`. ### 5.2 Référence de `{% schema %}` Exactement un `{% schema %}` par fichier de section, contenant un seul objet JSON. Son corps est du texte brut : aucun Liquid n'y est exécuté. Un corps malformé donne `INVALID_SCHEMA_JSON` ; un second `{% schema %}` fait ignorer le schéma. | Clé | Type | Effet | | --- | --- | --- | | `name` | chaîne | Nom de la section dans la liste et la bibliothèque | | `settings` | tableau | Déclare les identifiants, types et valeurs par défaut de `section.settings`. | | `settings[].id` | chaîne, obligatoire | La clé sous `section.settings`. | | `settings[].type` | chaîne, obligatoire | Pilote la validation des défauts et l'hydratation des objets (section 5.3). | | `settings[].default` | quelconque | Valeur utilisée quand le gabarit JSON ne la remplace pas. Validée contre le type. | | `settings[].options` | tableau de `{value,label}` | Pour `radio` et `select`, les seules valeurs acceptées ; comparaison stricte en type. | | `settings[].min` / `max` / `step` | nombre | Pour `number` et `range`. `range` utilise un pas de 1 par défaut ; l'arithmétique du pas est exacte. | | `settings[].accept` | tableau | Fournisseurs acceptés pour les types adossés à un fournisseur. | | `settings[].label` | chaîne | Libellé du champ dans le formulaire | | `settings[].info` | chaîne | Texte d'aide sous le champ | | `settings[].visible_if` | chaîne `{{ … }}` | Le formulaire n'affiche le champ que si la condition tient ; le rendu lit toujours la valeur. Clauses `ref`, `ref == valeur`, `ref != valeur` reliées par `and` / `or` ; `ref` = `section.settings.`, `block.settings.` ou `settings.` ; valeur entre guillemets, `true`, `false`, nombre ou `blank` (réglage non rempli). Une référence seule tient sauf `nil`, `false` et chaîne vide. Une condition hors grammaire ou visant un réglage inconnu du même schéma donne `INVALID_SETTING_SCHEMA`. | | `blocks` | tableau de `{type, settings}` | Déclare les types de blocs et leurs réglages. Un `type` dupliqué donne `DUPLICATE_SETTING_ID`. | | `blocks[].limit` | entier | Nombre maximal d'instances d'un type de bloc | | `presets` | tableau | Variantes insérables. Clés autorisées : `name`, `category`, `settings`, `blocks`, `preview_image` — toute autre clé donne `SECTION_PREVIEW_SCHEMA_INVALID`. | | `presets[].name` | chaîne, obligatoire | Nom de l'entrée dans la bibliothèque | | `presets[].category` | chaîne | Groupe de la bibliothèque | | `presets[].settings` | objet | Valeurs appliquées à l'insertion, et utilisées pour la vignette | | `presets[].blocks` | tableau | Blocs créés à l'insertion, dans l'ordre | | `presets[].preview_image` | chaîne | Vignette fournie par le thème, sous forme d'URL `data:` | | `limit` | entier | Nombre maximal d'instances de la section par surface | | `max_blocks` | entier | Nombre maximal de blocs par instance | | `enabled_on` | `{templates:[...]}` ou `{groups:[...]}` | Liste d'autorisation de surfaces. `"*"` signifie « toutes ». | | `disabled_on` | `{templates:[...]}` ou `{groups:[...]}` | Liste d'exclusion de surfaces. | | `locales` | — | **Refusée** : `SECTION_LOCALES_UNSUPPORTED`. Utiliser `locales/*.json` et le filtre `t`. | | `class`, `tag`, `default` | — | Acceptées, sans effet | `enabled_on` et `disabled_on` s'excluent mutuellement : déclarer les deux rend la section insérable nulle part. ### 5.3 Types de réglages Les valeurs par défaut déclarées sont validées contre leur type. Un type inconnu est accepté comme JSON borné et transmis tel quel — c'est ainsi que fonctionne le sélecteur `rankapp_post_media`. | Type | Valeur stockée | Valeur dans `section.settings` / `settings` | Contrôle de l'éditeur | | --- | --- | --- | --- | | `text` | chaîne | chaîne | Champ texte sur une ligne | | `textarea` | chaîne | chaîne | Champ texte multiligne | | `richtext` | chaîne (HTML) | chaîne | Éditeur de texte enrichi | | `inline_richtext` | chaîne (HTML) | chaîne | Texte enrichi en ligne | | `html` | chaîne | chaîne | Champ HTML brut | | `liquid` | chaîne | chaîne | Champ Liquid | | `url` | référence de lien (`rankapp://collection/tshirts`) ou adresse externe | chemin public dans la langue de la page servie ; `shopify://` accepté comme alias | Sélecteur de destination (accueil, collection, produit, page, page légale, recherche, compte, adresse web) | | `checkbox` | booléen | booléen | Interrupteur | | `number` | nombre | nombre | Champ numérique | | `range` | nombre | nombre | Curseur borné par `min`/`max`/`step` | | `radio` | une des `options[].value` | idem | Groupe de boutons radio | | `select` | une des `options[].value` | idem | Liste déroulante | | `color` | chaîne | chaîne | Sélecteur de couleur | | `color_background` | chaîne | chaîne | Champ de couleur de fond | | `color_scheme` | chaîne | chaîne | Sélecteur de palette | | `color_scheme_group` | objet | objet | Éditeur de groupe de palettes | | `font_picker` | identifiant de police | objet police : `family`, `fallback_families`, `style`, `weight`, `system?` | Sélecteur de police | | `image_picker` | chemin d'une image du thème (`assets/logo.webp`) | objet image : `src` (URL servie), `alt`, `width`, `height`, `aspect_ratio`, `presentation.focal_point` | Liste des images présentes dans `assets/`, ajout d'une image | | `video` | objet | objet | Sélecteur de vidéo | | `theme_video` | chemin d'un fichier vidéo du thème (`assets/hero.mp4`) | URL servie de la vidéo, chaîne vide si aucune | Liste des vidéos présentes dans `assets/` | | `video_url` | chaîne | `{id, external_id, type, host}` ; analysé contre la liste YouTube/Vimeo | Champ de vidéo externe | | `link_list` | identifiant de menu | objet menu : `handle`, `title`, `links`, `levels` | Sélecteur de menu | | `collection` | identifiant | objet collection résolu ; `"all"` donne la collection synthétique de tous les produits | Sélecteur de collection | | `collection_list` | tableau d'identifiants | tableau | Sélecteur multiple de collections | | `product` | identifiant | objet produit résolu | Sélecteur de produit | | `product_list` | tableau d'identifiants | tableau | Sélecteur multiple de produits | | `page` | identifiant | objet page résolu | Sélecteur de page | | `blog` | identifiant | objet blog résolu | Sélecteur de blog | | `article` | identifiant | chaîne | Sélecteur d'article | | `rankapp_post_media` | identifiant de post | chaîne (l'identifiant du post) | Sélecteur de post | Afficher directement un objet hydraté affiche quand même son scalaire : `{{ settings.logo }}` affiche le `src` de l'image, tandis que `{{ settings.logo.width }}` lit la propriété. Une valeur par défaut hors du domaine déclaré donne `SETTING_VALUE_OUT_OF_SCHEMA`. Une déclaration malformée donne `INVALID_SETTING_SCHEMA`. Le même identifiant déclaré deux fois dans une portée donne `DUPLICATE_SETTING_ID`. Un réglage `url` ne stocke pas un chemin tapé à la main mais une **référence de lien** : `rankapp://home`, `rankapp://collection/` (`rankapp://collection/all` pour tous les produits), `rankapp://product/`, `rankapp://page/`, `rankapp://policy/`, `rankapp://search`, `rankapp://account`. Le marchand choisit la destination dans l'app ; au rendu, `section.settings.link` vaut le chemin public de cette destination dans la langue de la page servie (`/en/collections/tshirts` sous le préfixe `en`, la traduction d'une Page quand elle existe, sinon sa version par défaut). Un slug renommé ou une langue ajoutée ne cassent donc aucun lien. Une Page introuvable donne une chaîne vide : garde un `{% if section.settings.link != blank %}` autour du bouton. Une adresse externe (`https://…`) ou un chemin absolu restent servis tels quels. **Choix illustrés.** Un `select`, un `radio` et un petit `range` de colonnes sont proposés au marchand comme une liste d'options dessinées : chaque valeur montre le résultat (composition, colonnes, alignement, format, ton, largeur, espacement, police) quand elle emploie le vocabulaire ci-dessous. Le dessin se déduit de `options[].value`, avec l'`id` du réglage pour le contexte ; une valeur hors vocabulaire reste une ligne de texte, jamais un dessin faux. Un `range` de colonnes n'est proposé en choix que s'il est entier, de 1 à 6, avec deux à six valeurs ; au-delà (`products_per_page` de 4 à 48) il reste un champ numérique. | Sujet | `id` du réglage | `options[].value` (ou bornes du `range`) | | --- | --- | --- | | Composition d'une section | `layout`, `composition`, `image_position` | `fullscreen`, `split`, `image_left`, `image_right`, `stacked` ; sur un `id` de position d'image, `left`, `right`, `top` | | Nombre de colonnes | `columns`, `products_per_row`, `items_per_line` | `range` entier de 1 à 6 par pas de 1 ; en `select`, `2` à `6` ou `two_columns`, `three_columns`… | | Alignement du texte | `alignment`, `text_alignment` | `left`, `center`, `right` | | Format des images | `image_ratio` | `portrait`, `square`, `landscape`, `adapt` | | Ton ou couleur | `style`, `color_scheme`, `text_color`, `background` | `dark`, `light`, `accent`, `none`, `surface` | | Largeur du contenu | `content_width` | `narrow`, `standard`, `wide` | | Espacement | `section_spacing` | `compact`, `balanced`, `airy` | | Police | `heading_font`, `body_font` | `serif`, `editorial`, `classic` (avec empattements) ; `sans`, `system`, `humanist` (sans empattements) | ### 5.4 Les objets `section` et `block` | Chemin | Type | Signification | | --- | --- | --- | | `section.id` | chaîne | Identifiant d'instance issu du gabarit JSON | | `section.type` | chaîne | Type de section, c'est-à-dire le nom du fichier | | `section.settings.` | quelconque | Valeur par défaut du schéma, remplacée par le gabarit JSON, puis hydratée | | `section.blocks` | tableau | Instances de blocs, dans l'ordre de `block_order` | | `section.blocks[].id` | chaîne | Identifiant d'instance du bloc | | `section.blocks[].type` | chaîne | Type de bloc issu du schéma | | `section.blocks[].settings.` | quelconque | Réglages du bloc, hydratés de la même façon | | `section.blocks[].shopify_attributes` | chaîne | `data-block-id=""`, à émettre sur l'élément racine du bloc | `shopify_attributes` est ce qui permet à l'éditeur de mettre en évidence et de sélectionner un bloc précis dans l'aperçu. À émettre tel quel : ```liquid
  • ``` ### 5.5 Le conteneur de section Chaque section rendue est enveloppée ainsi : ```html
    ...le balisage de la section...
    ``` Ce conteneur est généré : ne pas l'écrire, ne pas le modifier. ## 6. Pages et champs Les sections couvrent les surfaces marketing composées. Les pages éditoriales — à propos, questions fréquentes, guide des tailles, mentions légales, contact — utilisent un mécanisme natif : le gabarit déclare lui-même son contrat de contenu, et le marchand modifie les valeurs sur la Page, dans l'application. ### 6.1 `{% field %}` Déclare un contenu modifiable et affiche sa valeur courante sur place. ```liquid {% field name %} {% field name | control %} {% field name | control, modifier, modifier %} ``` | Élément | Valeurs | | --- | --- | | Contrôle | `input` (par défaut), `textarea`, `richtext`, `image`, `post` | | Modificateurs | `required`, `shared` | `shared` signifie une seule valeur pour toutes les langues ; sans ce modificateur, le champ est traduit par langue. `title` est toujours requis. | Identifiant | Signification | | --- | --- | | `title` | Champ système, correspond au titre de la Page | | `content` | Champ système, correspond au corps de la Page | | `handle`, `seo`, `id`, `locale`, `page`, `fields` | Réservés, inutilisables | | tout autre | Champ personnalisé, grammaire `^[a-z][a-z0-9_]{0,63}$` | Règles de rendu : | Situation | Sortie | | --- | --- | | Aucune valeur enregistrée | Rien | | Contrôle `post` | L'identifiant canonique du post, échappé | | Contrôle `image`, ou toute valeur objet | Le `src` / `url`, échappé | | Champ `content`, ou contrôle `richtext` | HTML brut | | Tout le reste | Texte échappé en HTML (les guillemets ne le sont pas) | Exemple, `templates/page.about.liquid` : ```liquid {% page handle: 'about', order: 10 %}
    {% if page.fields.eyebrow != blank %}

    {% field eyebrow %}

    {% endif %}

    {% field title %}

    {% if page.fields.intro != blank %}

    {% field intro | textarea %}

    {% endif %}
    {% capture about_image %}{% field cover | image %}{% endcapture %} {% if about_image != blank %} {{ page.fields.cover | image_url: width: 1600 | image_tag: class: 'about__cover', alt: page.title }} {% endif %}
    {% field content | richtext %}
    {% field_default title, locale: 'en' %}About us{% endfield_default %} {% field_default intro, locale: 'en' %}A workshop, a handful of people, and a long list of details.{% endfield_default %} {% field_default content, locale: 'en' %}

    Tell your story here.

    {% endfield_default %} ``` ### 6.2 `{% page %}` Déclare qu'un gabarit est une page de départ du thème. Le marchand la voit comme une proposition dans l'application et peut la créer sans que le thème écrive quoi que ce soit. ```liquid {% page handle: 'contact', order: 20 %} {% page handle: 'sizes', parent: 'templates/page.about.liquid', order: 30, visible: false %} ``` | Attribut | Type | Règle | | --- | --- | --- | | `handle` | chaîne entre guillemets | `[a-z0-9]+(-[a-z0-9]+)*`, 120 caractères au maximum | | `parent` | chaîne entre guillemets | Chemin d'un autre gabarit `page.*` déclaré ; pas de cycle | | `order` | entier positif ou nul | De 0 à 10 000 | | `visible` | booléen | `false` crée la page masquée | Règles : une seule déclaration par gabarit, aucun attribut dupliqué, et seuls les gabarits `page`, `contact` et `policy` (avec ou sans suffixe) peuvent en porter une. Ne pas créer de manifeste JSON supplémentaire pour les pages. Le chemin du gabarit est la référence stable : l'accueil et les surfaces catalogue restent des gabarits de thème, pas des pages éditoriales déclarées. ### 6.3 `{% field_default %}` Fournit le contenu proposé par défaut pour un champ, par langue. ```liquid {% field_default title, locale: 'en' %}Contact{% endfield_default %} {% field_default content, locale: 'en' %}

    Write to us.

    {% endfield_default %} {% field_default brand_claim %}Atelier{% endfield_default %} ``` | Règle | Détail | | --- | --- | | Corps | **Texte ou HTML littéral uniquement.** Tout Liquid à l'intérieur lève une erreur d'analyse. | | `locale` | À omettre pour un champ `shared` ; obligatoire pour un champ traduit | | Taille | 100 000 octets au maximum ; un titre de 512 caractères au maximum | | Non autorisé pour | Les contrôles `image` et `post` | | Visibilité | Un bloc `field_default` n'affiche rien. Utiliser `{% field %}` pour afficher la valeur. | | Par langue | Chaque langue fournie doit donner un `title` non vide | ### 6.4 L'objet `page` | Chemin | Signification | | --- | --- | | `page.id` | Identifiant de la Page | | `page.title` | Titre de la Page | | `page.handle` | Identifiant d'URL | | `page.url` | URL de la Page | | `page.content` | Corps HTML de la Page | | `page.published_at` | Date de publication | | `page.author` | Auteur | | `page.template_suffix` | Suffixe de gabarit, par exemple `about` | | `page.seo_description` | Description SEO | | `page.rankapp_page_kind` | `page`, `policy` ou `contact` | | `page.fields.` | Valeur enregistrée d'un champ déclaré | | `page.locale` | Langue active, sur un site multilingue | | `page.alternates` | URL des autres langues | Les trois natures éditoriales (page, mentions légales, contact) sont exposées sous `page`. Un alias `policy` portant `{title, body, url}` est également exposé. Utiliser `page.fields.` dans les conditions et `{% field %}` pour afficher : le premier lit la valeur, le second l'affiche *et* déclare le contrat. ### 6.5 Limites | Limite | Valeur | | --- | --- | | Champs par gabarit | 40 | | Profondeur de dépendance statique (gabarit → fragment → fragment) | 6 | | Pages par thème | 100 | | Gabarits par thème | 512 | | Langues par thème | 20 | | Valeur `input` | 512 caractères, une seule ligne | | Valeur `textarea` | 8 000 caractères | | Valeur `richtext` | Bornée par la limite de sortie de la page | | Valeur `image` | `{"media_id": "<32 caractères hexadécimaux>"}` | | Valeur `post` | Un UUID | ### 6.6 Codes d'erreur des champs Erreurs de déclaration, signalées par `rankapp site check` et `site_validate` : | Code | Signification | Correction | | --- | --- | --- | | `TEMPLATE_NOT_FOUND` | Une déclaration vise un gabarit inexistant | Corriger le chemin | | `INVALID_TEMPLATE_JSON` | Le gabarit JSON ne peut pas être parcouru pour y lire les déclarations | Corriger le JSON | | `RESERVED_FIELD_ID` | L'identifiant est l'un de `handle`, `seo`, `id`, `locale`, `page`, `fields` | Renommer le champ | | `INVALID_FIELD_ID` | L'identifiant ne respecte pas `^[a-z][a-z0-9_]{0,63}$` | Utiliser du snake_case | | `UNSUPPORTED_FIELD_CONTROL` | Le contrôle n'est pas `input`, `textarea`, `richtext`, `image`, `post` | `text` n'est pas un contrôle ; utiliser `input` | | `UNKNOWN_FIELD_MODIFIER` | Le modificateur n'est ni `required` ni `shared` | Le retirer | | `TOO_MANY_FIELDS` | Plus de 40 champs atteignables depuis un gabarit | Découper la page ou retirer des champs | | `CONFLICTING_FIELD_DECLARATIONS` | Le même identifiant déclaré deux fois avec un contrôle ou des modificateurs différents | Rendre les déclarations identiques | | `FIELD_IN_UNREFERENCED_SNIPPET` | Un fragment déclare `{% field %}` mais aucun gabarit éditorial ne l'atteint par un `render` statique | Rendre le fragment statiquement, ou retirer le champ | | `INVALID_THEME_PAGES` | Les déclarations `{% page %}` sont incohérentes : identifiant dupliqué, parent inconnu, cycle, trop de pages, titre manquant pour une langue | Corriger les déclarations | Erreurs de valeur, signalées à l'enregistrement d'une Page : `field_not_shared`, `field_not_localized`, `unknown_field`, `system_field_not_editable`, `invalid_image_reference`, `invalid_text`, `text_too_long`, `invalid_post_reference`. ## 7. Référence Liquid ### 7.1 Délimiteurs et contrôle des espaces | Forme | Signification | | --- | --- | | `{{ expression }}` | Affichage | | `{% balise %}` | Balise | | `{{- ... -}}`, `{%- ... -%}` | Supprime les espaces adjacents de ce côté | Éviter un `}}` littéral (CSS ou JavaScript en ligne) sur la même ligne qu'un affichage `{{ }}` : le placer sur une autre ligne ou dans `assets/`. Les identifiants peuvent contenir `-` et se terminer par `?` (`posted_successfully?`, `gift_card?`). Mots-clés : `true`, `false`, `nil`, `null`, `empty`, `blank`, `contains`, `and`, `or`. ### 7.2 Balises | Balise | Syntaxe | Remarques | | --- | --- | --- | | `{% if %}` | `{% if expr %}...{% elsif expr %}...{% else %}...{% endif %}` | Expressions de comparaison complètes, `and`/`or`/`contains` | | `{% unless %}` | `{% unless expr %}...{% else %}...{% endunless %}` | | | `{% case %}` | `{% case expr %}{% when a, b %}...{% when c or d %}...{% else %}...{% endcase %}` | `,` et `or` séparent les valeurs de `when` | | `{% for %}` | `{% for x in expr [limit: N] [offset: N] [reversed] %}...{% else %}...{% endfor %}` | Paramètres dans n'importe quel ordre. L'itérable doit être une liste, un tuple ou un intervalle ; un dictionnaire ou une collection paginée par le serveur hors `{% paginate %}` rend la branche `{% else %}`. | | `{% tablerow %}` | `{% tablerow x in expr [cols: N] [limit: N] [offset: N] %}...{% endtablerow %}` | Émet des ``/`` | | `{% assign %}` | `{% assign v = primaire \| filtre ... %}` | Le membre droit est une expression primaire suivie de filtres, pas une comparaison. Écrit dans la **portée racine**. | | `{% capture %}` | `{% capture v %}...{% endcapture %}` | Capture le rendu dans une chaîne. Écrit dans la **portée racine**. | | `{% increment %}` / `{% decrement %}` | `{% increment v %}` | Espace de compteurs indépendant | | `{% cycle %}` | `{% cycle 'a', 'b' %}` ou `{% cycle 'groupe': 'a', 'b' %}` | | | `{% break %}` / `{% continue %}` | `{% break %}` | Dans une boucle | | `{% raw %}` | `{% raw %}...{% endraw %}` | Extraite avant la tokenisation ; corps émis tel quel, jamais analysé | | `{% comment %}` | `{% comment %}...{% endcomment %}` | Corps analysé puis supprimé | | `{% render %}` | `{% render 'fragment' [with expr [as alias]] [, clé: valeur ...] %}` ou `{% render 'fragment' for liste as item %}` | Portée isolée. Le nom du gabarit doit être une chaîne littérale. | | `{% include %}` | `{% include 'fragment' [with expr [as alias]] [, clé: valeur ...] %}` | Partage la portée parente ; ses liaisons remontent chez l'appelant | | `{% echo %}` | `{% echo expr \| filtres %}` | Forme d'affichage utilisable dans `{% liquid %}` | | `{% liquid %}` | `{% liquid ... %}` | Bloc multi-instructions, une par ligne ; `#` ouvre un commentaire de ligne | | `{% schema %}` | `{% schema %}{...}{% endschema %}` | JSON brut ; un seul par fichier de section | | `{% style %}` | `{% style %}...{% endstyle %}` | Corps analysé en Liquid, enveloppé dans ` ### 11.2 Liste de vérification | Vérification | Raison | | --- | --- | | Chaque chaîne visible est derrière un réglage, un réglage de bloc, un champ de Page ou une clé `t` | Sinon le marchand ne peut ni la modifier ni la traduire | | Boucles bornées, inclusions peu profondes | Un rendu de page trop lourd ou trop lent est rejeté | | Chaque élément répété est un bloc | Des réglages numérotés ne se réordonnent ni ne se suppriment | | Chaque preset a un `name` et une `category` valide | Sinon la section est absente ou mal classée dans la bibliothèque | | Aucune clé de preset hors des cinq autorisées | `SECTION_PRESET_KEY_UNKNOWN`, et les vignettes refusent de se construire | | `block.shopify_attributes` émis sur la racine des blocs | Sélection d'un bloc dans l'aperçu | | Aucun conteneur de section écrit à la main | Le rendu de section cible l'identifiant généré | | Identifiants existants inchangés | Les valeurs enregistrées restent rattachées | | Chaînes du marchand échappées | Injection et balisage cassé | | Contenu optionnel protégé par `!= blank` | `""` est vrai | | Liens internes construits depuis `routes.*` | Préfixes multilingues | | Aucun script externe, aucun secret, aucune donnée de démonstration | Publication et sécurité | | Corps de `{% javascript %}` / `{% stylesheet %}` statiques | `INVALID_STATIC_ASSET_BLOCK` | | Clés de traduction présentes dans la langue par défaut | `MISSING_TRANSLATION_KEY` | | `rankapp site check` propre, avertissements `sectionContract` à zéro | Le contrat tient | | Vidéos dans `assets/` uniquement, 4 au plus, 16 Mio chacune, `muted loop playsinline preload="none"` avec une image d'affiche | Admission du thème et poids des pages | | `rankapp site section-previews` régénéré | La bibliothèque montre la vraie section | | Validation lancée après le commit, pas avant | Sinon c'est le brouillon du marchand qui est validé | ### 11.3 Mettre à jour le thème de base Un thème du catalogue reçoit de nouvelles versions (chapitre 12). La plateforme les applique elle-même à un site dont le code n'a jamais été modifié, d'un tap dans l'application. Dès qu'un agent a personnalisé le code, la mise à jour lui appartient : RankApp ne fusionne rien à sa place. Ce que la plateforme fournit, c'est l'information et la nouvelle version. | Étape | CLI | Connecteur | | --- | --- | --- | | Savoir qu'une version existe | `rankapp site status`, ligne « Catalogue » | `site_brief`, bloc `theme.upgrade` | | Décrire l'impact au marchand | `rankapp site guide versions` | `site_guide` chapitre `versions` | | Code intact : appliquer | `rankapp site upgrade --apply` puis `git pull --no-rebase rankapp main` | proposer le tap dans l'application | | Code personnalisé : récupérer la nouvelle version | `rankapp site upgrade --fetch` → `.rankapp/upgrade//` | `theme_upgrade_read` fichier par fichier | | Reporter les personnalisations et vérifier | modifier, `rankapp site check`, `git push rankapp main` | `theme_write`, `theme_commit`, `site_validate` | Règles pour l'agent : signaler la version disponible au marchand avant toute autre chose, ne jamais mettre à jour sans son accord, et personnaliser par les réglages, les compositions et de nouvelles sections plutôt qu'en réécrivant les sections natives, pour que les versions suivantes restent faciles à prendre. ## 12. Versions ### 12.1 1.3.0 — 17 septembre 2026 Thème de référence `rankapp-default` **1.40.0**. | Domaine | Ce que la release apporte | | --- | --- | | Sections | Contrat des sections pour l'éditeur visuel : `presets[].category`, `limit`, `max_blocks`, `enabled_on` / `disabled_on` ; vignettes de sections avec `rankapp site section-previews` | | Sections génériques | `rankapp-text-image`, `rankapp-gallery`, `rankapp-features`, `rankapp-cta`, autonomes grâce à `{% stylesheet %}` | | Pages | Contrat de page natif : `{% field %}`, `{% page %}`, `{% field_default %}` | | Validation | Avertissements consultatifs `sectionContract` dans `rankapp site check` et `site_validate` | | Outillage | CLI `rankapp site` (login, pull, check, dev, section-previews, preview, refresh, pages, publish) ; outils du connecteur, dont `site_guide` | | Runtime | Le runtime expose sa release dans `window.rankappCommerce.release` | | Sections | Générateur de sections : `rankapp site new-section` et l'outil `section_scaffold` produisent une section conforme au contrat (schéma, preset catégorisé, `{% stylesheet %}` autonome, blocs typés) | | Runtime | Scripts de boutique minifiés : environ 15 % de moins à télécharger sur les pages paiement, commande et participation | | Runtime | QR des billets dessiné côté serveur dans la réponse privée de la commande, à la place du jeton brut ; plus aucune bibliothèque tierce chargée sur le détail de commande (−10 Ko compressés) | | Outillage | CLI 0.1.0 : `status`, `sections`, `render `, `guide `, `doctor`, `version`, toutes avec `--json` — un agent lit l'état, le thème et la référence sans navigateur | | Éditeur | Cliquer une image de l'aperçu ouvre le sélecteur de médias du réglage qui la rend ; sélection des blocs et glisser-déposer des presets dans l'aperçu ; canvas sur tous les gabarits JSON | | Vignettes | Générées côté serveur après un commit du connecteur (`section_previews_refresh` à la demande) | | Runtime | Scripts de boutique livrés en un seul bundle de release immuable | | Fichiers | Vidéos de thème : `.mp4` et `.webm` sous `assets/`, au plus 4 par thème et 16 Mio chacune, hors du total de 25 Mio (`THEME_VIDEO_TOO_LARGE`, `THEME_VIDEO_LIMIT`) ; la hero du thème de référence prend un réglage `video` (nom du fichier, lu via `asset_url`) ; `rankapp site dev` sert les fichiers par plages d'octets ; CLI 0.1.1 |