Documentation
The Complete Guide to Tralo
Everything you need to know to create, share and improve your branching stories and , including the JSON format for importing and exporting.
1. Getting started
Créez un compte gratuit, et vous arrivez sur votre dashboard : c'est votre bibliothèque. Vous y trouvez d'office deux histoires de démonstration (badge « Démo ») : jouez-les pour comprendre l'expérience élève. Elles ne sont pas modifiables, mais le menu ⋯ permet de les dupliquer dans votre bibliothèque pour les adapter librement.
Le bouton + Nouvelle histoire crée un brouillon avec une première scène et ouvre l'éditeur.
2. Writing a story
Une histoire est une suite de scènes. Chaque scène raconte une situation (texte + image facultative) et propose des choix à l'élève :
• Un choix bonne réponse mène à la scène suivante (champ « Mène à la scène »). Vous pouvez y ajouter un renforcement : une phrase qui confirme et explique.
• Un choix fausse piste affiche son explication (« pourquoi c'est une erreur »), puis l'élève réessaie sur la même scène. Si vous lui donnez une scène cible, il part au contraire sur cette branche : utile pour créer de vraies bifurcations.
Une scène marquée « Scène finale » termine l'histoire, avec un ton : réussite, neutre ou échec. L'onglet Map montre toutes les scènes et leurs connexions (vert = bonnes réponses, pointillés vermillon = fausses pistes).
Au moment de publier, Tralo vérifie votre histoire : scènes sans bonne réponse, bonnes réponses sans destination, scènes non reliées au départ, absence de fin… Vous pouvez corriger ou publier quand même.
3. Creating flashcards
En plus des histoires, Tralo propose des paquets de flashcards : des cartes recto/verso idéales pour la révision et la mémorisation rapide. Parfait pour les dates historiques, le vocabulaire, les formules, ou toute notion nécessitant une mémorisation active.
Un paquet se compose de multiples cartes. Chaque carte a :
• Un recto (la question, le terme ou le concept)
• Un verso(la réponse, la définition ou l'explication)
The student looks at the front, tries to recall the answer, then turns the card over to check. A tried-and-tested method for consolidate knowledge.
In the pack editor, you can: add, duplicate or delete cards, reorder them, and view a real-time preview with a 3D flipping effect.
4. Share with pupils
Le bouton Share de l'éditeur active le lien de partage (de la forme tralo.fr/s/abc123). Vos élèves l'ouvrent sur n'importe quel appareil, sans créer de compte.
Vous pouvez définir un code d'accès (ex. 6EMEB) pour réserver l'histoire à votre classe : les élèves le saisissent une fois, il reste mémorisé pendant leur session. Désactivez le lien à tout moment : il cesse immédiatement de fonctionner.
5. Statistics
Chaque lecture via le lien de partage alimente l'onglet Stats de l'éditeur : nombre de lectures, taux de complétion, score moyen, erreurs par lecture, et surtout les scènes les plus difficiles (où vos élèves se trompent le plus), précieux pour ajuster vos explications.
Le niveau de détail dépend de votre formule : les statistiques essentielles(cartes de synthèse) sont incluses dans le plan Gratuit ; l'analyse par scène est disponible dès le plan Essentiel ; les statistiques avancées (détail par session de lecture et export .csv) sont réservées aux plans Pro et Duo.
Les lectures sont sans identité déclaréepar défaut : aucun nom, prénom ni compte élève n'est demandé. Un identifiant technique de session et les données de progression restent toutefois enregistrés ; ces lectures sont donc pseudonymes, et non anonymes au sens strict du RGPD. Vos propres aperçus d'auteur ne comptent pas. Le bouton « Réinitialiser » efface l'historique (par exemple entre deux classes).
6. Organising your library
Créez des dossiers colorés (par classe, matière, projet…) depuis la barre latérale du dashboard. Le menu ⋯ de chaque histoire permet de la déplacer, la dupliquer, l'exporter ou la supprimer. Supprimer un dossier ne supprime pas ses histoires : elles reviennent à la racine.
7. Import/export and JSON format
Chaque histoire s'exporte en fichier .json (menu ⋯ → Exporter, ou paramètres de l'éditeur). Le bouton Importer (.json) du dashboard (réservé aux formules payantes) accepte :
• une histoire seule (le format ci-dessous) ;
• une sauvegarde complète : { "stories": [ … ] } (générée par « Tout exporter » dans les paramètres).
À l'import, tous les identifiants sont régénérés et l'histoire arrive en brouillon à la racine : aucun risque de collision, vous pouvez importer le même fichier plusieurs fois.
| Field | Type | Role |
|---|---|---|
| title | string | Story title (compulsory). |
| description | string | Presentation shown to pupils before they begin. |
| emoji | string | Cover emoji (e.g. “🗝 ”). |
| coverGradient | number | Cover colour, from 0 to 11. |
| startSceneId | string | ID of the starting scene; must exist in ‘scenes’ (required). |
| scenes | Scene[] | The list of scenes (required). |
| Field | Type | Role |
|---|---|---|
| id | string | Unique identifier within the file (unrestricted: “scene-1”…). |
| title | string | Scene title (displayed in the header on the student’s side). |
| text | string | The narrative. \n for line breaks. |
| image | string | null | Image URL, or null. |
| choices | Choice[] | The available choices ([] for a final scene). |
| isEnding | boolean | true = final scene (ends the story). |
| endingTone | string | "success", "neutral" or "failure": the end screen. |
| Field | Type | Role |
|---|---|---|
| id | string | Unique identifier within the file. |
| text | string | The text of the choice presented to the student. |
| targetSceneId | string | null | ID of the destination scene. For a wrong answer, null = the learner tries again on the spot. |
| isCorrect | boolean | true = correct answer, false = red herring. |
| explanation | string | The educational feedback displayed after the choice. |
Complete example (can be imported as is):
{
"title": "Le Trésor du CDI",
"description": "Une enquête au CDI pour apprendre à chercher l'information.",
"emoji": "🗝️",
"coverGradient": 2,
"startSceneId": "scene-depart",
"scenes": [
{
"id": "scene-depart",
"title": "L'énigme",
"text": "Un mot mystérieux vous attend sur la table du CDI : « Le trésor se cache dans le livre qui parle des volcans d'Auvergne. »\n\nComment le trouver ?",
"image": null,
"choices": [
{
"id": "choix-catalogue",
"text": "Chercher « volcans Auvergne » dans le catalogue en ligne",
"targetSceneId": "scene-rayon",
"isCorrect": true,
"explanation": "Exact : le catalogue indique la cote du livre en quelques secondes."
},
{
"id": "choix-hasard",
"text": "Ouvrir tous les livres un par un",
"targetSceneId": null,
"isCorrect": false,
"explanation": "Avec 5 000 livres au CDI, il vous faudrait des semaines. Le catalogue est fait pour ça !"
}
],
"isEnding": false,
"endingTone": "neutral"
},
{
"id": "scene-rayon",
"title": "Au rayon 550",
"text": "Le catalogue indique la cote 551.21 VOL. Vous trouvez le livre… et à l'intérieur, une carte de lecteur dorée !",
"image": null,
"choices": [],
"isEnding": true,
"endingTone": "success"
}
]
}This format lends itself well to
Generating a story with AI: prompt ready to copy
Collez le texte ci-dessous dans l'assistant de votre choix (ChatGPT, Claude, Gemini…), remplacez ce qui est entre crochets par votre sujet et vos réglages, puis enregistrez la réponse dans un fichier .json que vous importerez avec le bouton Importer (.json) du dashboard.
You are an educational designer. Create an interactive branching story (a narrative in which the pupil drives the plot forward by answering questions) intended to be imported into Tralo. SETTINGS (replace the text in square brackets): - Subject / theme: [SUBJECT, e.g. the water cycle] - Subject: [SUBJECT, e.g. Life Sciences] - Year group: [YEAR GROUP, e.g. Year 6] - Learning objective: [WHAT THE PUPIL SHOULD LEARN OR BE ABLE TO DO] - Number of scenes: [APPROX. 8] - Number of endings: [AT LEAST 2, including one successful and one unsuccessful outcome] - Choices per scene: [2 TO 3] - Tone / atmosphere: [e.g. investigation, adventure, everyday life] - Target reading time: [e.g. 10 minutes] - Language: [French] - To avoid / to prioritise: [prescribed vocabulary, concepts outside the syllabus to be excluded, etc.] INSTRUCTIONS: - Each scene offers choices: at least one correct answer that moves the story forward, and red herrings. Each red herring has a clear educational explanation (why it is wrong and what the student should have understood). - A red herring with ‘targetSceneId’: null makes the pupil try again on the same scene; otherwise, it may lead to a different branch. - Adapt the narrative and vocabulary to the specified level, without errors. The error must always be instructive. - Provide the required number of endings, with varied tones (success / failure / neutral). OUTPUT FORMAT: respond ONLY with a valid JSON object, without any surrounding text or Markdown tags, strictly adhering to this template: { "title": "string", "description": "string (presentation displayed before playing)", "emoji": "a single cover emoji", "coverGradient": an integer from 0 to 11, "startSceneId": "ID of a scene from the list below", "scenes": [ { "id": "unique identifier, e.g. scene-1", "title": "string", "text": "the scene’s narrative (\n for a line break)", "image": null, "choices": [ { "id": "unique identifier, e.g. choice-1", "text": "the choice presented to the student", "targetSceneId": "ID of the destination scene, or null to retry in the same scene", "isCorrect": true or false, "explanation": "the feedback displayed after this choice" } ], "isEnding": true or false, "endingTone": "success" | "neutral" | "failure" } ] } MANDATORY RULES: - All "ids" (scenes and choices) must be unique within the file. - "startSceneId" must correspond exactly to the "id" of an existing scene. - Every non-null "targetSceneId" points to an existing scene. - A final scene has "isEnding": true and "choices": []. - Every non-final scene has at least one choice with "isCorrect": true and a valid "targetSceneId". - Leave “image”: null everywhere (you do not add any images here). - The JSON must be valid and importable as is.AI can make mistakes: open the imported story in the editor and check the links between scenes, the correct answers and endings before sharing it. The import process checks the file format, not the educational accuracy.
8. Account settings
La page Settings (menu du compte → Paramètres) regroupe :
• Profile: changer votre nom ; changer d'e-mail (confirmé par un lien envoyé à la nouvelle adresse).
• Team : invitations, membres et dossier partagé.
• Preferences : affichage des histoires et flashcards de démonstration.
• Notifications : choisir les e-mails facultatifs ; les messages essentiels de sécurité, facturation et suppression restent actifs.
• Security : changer de mot de passe, activer la vérification en deux étapes, renouveler les codes de secours et déconnecter des appareils.
• My data : compteurs et export complet de vos histoires et images en un fichier (votre sauvegarde), durée de conservation des statistiques lecteurs et effacement immédiat de ces statistiques.
• Sensitive area : tout supprimer (après confirmation), demander la suppression du compte, se déconnecter.
Une question que cette page n'a pas résolue ? Écrivez-nous.
9. Subscription & invoices
Tout se gère depuis Paramètres → Abonnement & Factures, sans passer par un site externe. Vous pouvez à tout moment changer de formule, basculer entre mensuel et annuel (la différence est calculée au prorata), résilier ou réactiver. Vos factures y sont consultables et téléchargeables en PDF.
Les formules : Free (3 histoires, sans images), Essential (100 histoires, sans images), Pro (histoires illimitées + images dans les scènes). Duo & Small team (2 à 5 personnes) donne à chaque membre un accès Pro nominatif, un Dossier partagé et une facture unique ; gérez les membres depuis Réglages → Équipe.
Remise « TRALO50 » : elle offre −50 % pendant 3 mois sur les abonnements mensuels Essentiel et Pro. Elle est appliquée automatiquement sur la page de récapitulatif Tralo ; vous n'avez aucun code à saisir sur la page Stripe.
Que se passe-t-il si mon abonnement s'arrête ?Si vous résiliez ou qu'un paiement n'aboutit pas, l'accès aux fonctions payantes est suspendu, mais vos histoires restent là pendant un mois. Vous recevez un e-mail, puis un rappel une semaine avant, puis deux jours avant. Passé ce mois, le contenu est supprimé (histoires, dossiers, images, statistiques), mais votre compte est conservé : vous pouvez revenir et reprendre un abonnement quand vous voulez. Pendant ce mois, deux options : réactiver votre formule, ou télécharger tout votre travail.
10. Download my stories and images
Vous gardez la main sur vos données. Pour tout récupérer, images comprises :
• Paramètres → Mes données → « Tout exporter (.zip) ». Vous obtenez un fichier .zip contenant tralo-sauvegarde.json (toutes vos histoires) et un dossier images/ avec toutes vos illustrations.
• Juste les images ? Depuis le dashboard → « Mes images », téléchargez une image à la fois, ou « Tout télécharger (.zip) ».
Pour réimporter plus tard, utilisez le bouton Importer (.json) du dashboard avec le fichier tralo-sauvegarde.json issu du zip (voir le format JSON).
11. Managing an organisation
Tralo Adminest la console séparée réservée aux organisations ouvertes avec l'équipe Tralo. Elle sert à gérer la structure, les membres, les invitations, les rôles, les licences, les contenus partagés, les statistiques, la facturation, la sécurité et le journal d'audit. Un abonnement individuel ou Duo ne donne pas automatiquement accès à cette console.
Le guide complet de Tralo Admin pour les organisations explique le parcours depuis l'invitation et la double authentification jusqu'aux opérations quotidiennes d'un administrateur, notamment la désignation du gestionnaire initial et l'invitation d'autres gestionnaires administrateurs.