Ramifica is a browser-based authoring tool for branching scenarios: interactive activities where the learner watches a scene, makes a decision, and the story branches according to each choice, ending with an automatic, personalised debrief.
O Ramifica é uma ferramenta de autoria, que roda no navegador, para criar branching scenarios: atividades interativas em que o aluno assiste a uma cena, toma uma decisão e a história se ramifica conforme cada escolha, terminando com uma devolutiva automática e personalizada.
Open RamificaAbrir o RamificaThe Ramifica editor runs in your browser at app.ramificastudio.com. It works best in an up-to-date desktop browser such as Chrome, Edge, Firefox or Safari. Everything it needs comes from the same address — no third-party scripts or fonts — so it also works on school networks that block outside services.
Ramifica works from your account, so signing in comes first. Open the editor and it asks for your email and sends you a link that signs you in — there is no password. Creating an account is free, and the free plan builds, publishes and reports in full.
Where your work is kept still depends on what you do with it. Writing, testing and saving a .zip to your own computer stay in the browser: the editor never uploads anything on its own. Saving to the cloud, publishing and the dashboard put that work on Ramifica's servers under your account, and each of those is a choice you make explicitly.
The editor interface is available in English and Portuguese: use the EN / PT toggle in the top bar. This only changes the editor; the language your learners see is a separate setting described below.
The sidebar shows the four steps of building an activity: Activity, Structure, Content and Publish. You can move between them freely at any time.
This step holds the general settings. Activity title and opening instructions are the first things learners see, so use the instructions to set the scene: who the learner is in the story, what their role will be, and how the activity works.
You can address the learner by name: type {{nome}} (or {{name}}) anywhere in the activity texts — opening instructions, situations, questions, options, feedback or ending texts — and the player replaces it with the name the learner typed on the start screen. On the start screen itself the swap happens live as they type, so Congratulations, ...! becomes Congratulations, Maria! letter by letter. In SCORM packages the name comes from the LMS instead, since learners do not type it.
What this activity is for is the one setting that changes how your results are read, and it is worth a moment. Choose Practice — teach and consolidate when the activity exists to build a skill and you want most learners to get it right. Choose Simulation — test decisions in a realistic situation when it exists to reveal what they would actually do, and being right should not be easy. The report uses this: on a practice screen, 90% good decisions is the goal reached; on a simulation screen, the same 90% is a warning that the clue was too obvious. Leave it on Not saying if neither fits — the report then keeps quiet instead of judging by the wrong standard.
Your classes is an optional list, separated by commas. Fill it in and the publish panel gives you one link per class, with the learner typing nothing; leave it empty and each learner types their own class. Filling it in is what stops “9A”, “9a” and “9 A” from becoming three different classes in your report.
New screens start with shuffled options sets the default for screens you create from now on. Screens you already made are never changed on their own — there is a button beside it if you want to apply it to all of them at once.
Activity language controls every fixed label your learners (and the dashboard) will see: buttons, the name and class fields, and the headings of the final debrief. Choose English (Australia) or Português (Brasil). It is independent of the editor language, so you can edit in Portuguese and publish in English.
Decision feedback sets when learners see the feedback you write for each option. With Immediate (after each choice) — the default — a feedback panel opens right after the learner picks an option: it shows the quality label (Good decision, Attention point or Neutral), the option they chose and your feedback text, and a Continue button takes them to the next scene. Options you leave without feedback text simply move straight on, so you can be selective about which choices deserve a pause. With Only in the final debrief, the story flows without interruption and all feedback is saved for the end. In both modes the final debrief always shows the complete path with your feedback under every decision.
The teacher access code protects the results dashboard when you publish to your own server. Choose something you will remember; the dashboard cannot be opened without it, and an empty code blocks access entirely. The footer text is printed at the bottom of every learner screen and on the dashboard; use it for your author credit, for example © 2026 Your Name · Your Organisation.
Just below it, the sharing code (optional) is a second code for the same dashboard, meant for someone else — a coordinator, a colleague, the person who asked how the class went. It opens exactly the same report, with Did the activity work? and Where the class stumbles, but with no learner names anywhere and without the per-learner list at the end. The names are not merely hidden on screen: when the dashboard is opened with this code, the report.php file in your package never sends the names to the browser at all, so there is nothing to dig out. That is what makes it safe to hand the code to a colleague. Leave the field empty if you do not want a second code.
Leave alternative webhook empty unless your web server cannot run PHP; in that case you can point results at another endpoint, such as a Google Apps Script, and the built-in dashboard is not used.
Here you create the skeleton of the story. A practical workflow is to add all the screens first with + Add screen, name them, set their types, and only then connect the decisions.
Each screen has one of three types:
| Type | What it does |
|---|---|
| Decision | Shows the scene and a question with two or more options. Each option leads to another screen, and each will carry pedagogical feedback (added in Step 3). These are the screens that count in the final debrief. |
| Information | Shows a scene with a single continue button; no question, no feedback. Use it for context, transitions or instructions between decisions. |
| Ending | Finishes the activity and triggers the debrief. An activity can have several endings; create at least one. |
On decision screens, type the text of each option and choose where it leads with → goes to…. On information screens, set the destination with Continues to:. Use the Start screen selector to mark where the activity begins.
An option's destination can also be ↩ Retry this screen — the first item in the destination list. Choose it when a wrong answer should make the learner try the same question again instead of moving on. The learner always sees that option's feedback first (even when the activity is set to show feedback only in the final debrief — otherwise they would be sent back with no explanation), and the button reads Try again instead of Continue. Each attempt is recorded and appears in the final debrief and the dashboard, so you can see how many tries each learner needed. On video screens, retrying does not force the learner to watch the video again. Two guardrails help you: a warning if a retry option has no feedback text, and an error if every option on a screen retries it — the learner would be trapped, so leave at least one way forward.
The flow map on the right redraws as you work. The colours follow the screen types: start, decision, information, ending, and red for a problem, such as a screen no path can reach or an option that leads nowhere. Clicking a box in the map scrolls to that screen in the list. The list under the map summarises anything that needs fixing; issues in red block the export, while warnings in amber are only reminders.
Select a screen in the chip row at the top; the dot on each chip turns green once that screen has everything it needs. For each screen you can set a video or image, the situation text and, depending on the type, the question and options feedback or the closing text.
Choose Video or Image and upload the file. Video is a Ramifica Pro feature; the free plan uses images, audio and text, which is enough for most activities. Videos should be mp4 (H.264); images jpg, png or webp. Files are embedded in the exported package, so size matters: for smooth loading aim for 720p at roughly 1.5 to 2.5 Mbps, which is about 10 to 20 MB per minute. The free tool HandBrake (preset “Web” 720p) compresses batches of videos well. The practical limit per file is 180 MB, but staying far below it makes a real difference for learners on slow connections.
Right below the media you will find the accessibility fields. For an image, there is an alternative text box: a one-or-two-sentence description that screen readers speak aloud. For a video, there are two: a captions (.vtt) upload, which overlays subtitles on the video, and a text alternative box, shown to learners as an expandable section below the video describing what happens and what is said. What to write in each, and how to create a captions file, is covered step by step in Creating accessible activities.
For video screens, the option Lock the answer until the video ends (ticked by default) keeps the question visible but the answers disabled, with a note telling learners the options unlock when the video finishes. Untick it if you want answers available immediately. The player also preloads the media of the possible next screens in the background while the learner watches, so transitions feel fast.
The situation text appears with the media and sets the scene; the question is the decision prompt. For every option you assign a quality, Good decision, Attention point or Neutral decision, and write a short feedback paragraph. When learners see this feedback depends on the Decision feedback setting from Step 1: immediately after each choice (the default) or only at the end. Either way, the final debrief lists the path they took, decision by decision, with your feedback under each one and a summary count of good decisions and attention points. The {{nome}} marker from Step 1 also works in all of these texts.
Each decision screen also has a Show the options in random order checkbox. Tick it and every learner sees that screen's options in a different, random order — useful when the position of the right answer should not be a clue, or when learners sit side by side. The debrief and the dashboard keep the original numbering, so your data stays comparable across learners.
On ending screens, the closing text explains what happened in that outcome. The automatic debrief appears right below it. On information screens you can also customise the label of the continue button.
An accessible activity is one that a learner who is deaf, blind, has low vision or navigates by keyboard can complete on equal terms. Ramifica splits this work fairly: the player already handles the technical side for you, and three small fields in Step 3 cover the part only you, the author, can do. This section explains both halves.
Every export is fully operable by keyboard (Tab to move, Enter or Space to activate). Whenever the screen changes, focus moves to the new question or heading and the page title updates, so screen-reader users always know where they are. While a video plays with the answer lock on, the options remain visible to assistive technology, and the moment the video ends a spoken announcement says the options are unlocked. Decision qualities are never conveyed by colour alone — they always carry a text label — and all colours meet contrast standards. Learners who set their system to reduce motion get the activity without animations. None of this needs anything from you; it ships in every export.
The alternative text box in Step 3 is what a screen reader speaks in place of the image. Write one or two sentences describing what matters in the scene for the decision at hand, as if telling a colleague over the phone: “Miguel sits alone at his desk, head down, while the rest of the class works in pairs.” Skip openings like “image of” (the screen reader announces that already) and skip decoration that carries no meaning.
Captions make videos usable for deaf and hard-of-hearing learners, and help everyone in noisy classrooms or on muted phones. Ramifica uses the standard WebVTT format, a plain-text file you upload once per video in Step 3; the player then shows the captions over the video, switched on by default, and carries them automatically into saved projects, web exports and SCORM packages.
A .vtt file is simple enough to write by hand for short clips. Create a plain-text file (Notepad, TextEdit in plain-text mode) saved with the .vtt extension:
| A minimal captions file |
|---|
WEBVTT00:00:01.000 --> 00:00:04.500Miguel, you've been quiet all morning.00:00:05.000 --> 00:00:08.000[school bell rings in the background] |
The first line must be exactly WEBVTT. Each cue is a time range (hours:minutes:seconds.milliseconds) followed by the text spoken in that interval. Include meaningful sounds in square brackets, and identify speakers when it is not obvious. For longer videos, let a tool do the timing: upload the video to YouTube (it can stay unlisted), let it auto-generate captions, correct them in YouTube Studio and download the .vtt; or use the free program Subtitle Edit, which plays the video alongside the text as you type. Always review automatic captions — they miss names and technical terms.
The text alternative box is the written version of the whole scene: what happens, what is said, in narrative form. Learners see it as a collapsed “Text alternative” section under the video and open it if they need it — because they cannot see the video, cannot play it where they are, or want to re-read a detail before deciding. Captions and the text alternative complement each other; for full accessibility provide both, but if you can only do one, the export check will be satisfied by either.
In the Publish step, the activity check now includes accessibility warnings: a video with neither captions nor a text alternative, or an image without alternative text, is flagged in amber. Warnings do not block publishing — you stay in charge — but they are the honest list of who might be excluded.
Test activity (top bar, or the first card in the Publish step) opens the activity in a new tab exactly as learners will see it, marked with a banner and with results recording switched off. In test mode a Start again button appears at the end so you can walk every branch. Test each path at least once before publishing; the checker catches structural problems, but only you can catch a video attached to the wrong scene.
Save ▸ to this computer downloads a file named like your-title.ramifica-project.zip. That file is the complete project, media included; keep it as your master copy and back it up like any important document. Open ▸ from this computer restores it fully, on any computer. This is backup, and it is on every plan.
The editor also keeps an automatic draft in the browser and offers to restore it when you return. Treat it as a safety net only: it does not include media files and does not travel between computers or browsers.
On any plan — free or Pro — Save ▸ to the cloud keeps the project on Ramifica's servers, with its images, audio and captions (and video, on Pro). Open ▸ from the cloud brings it back on any computer with everything in place. Sending the same file twice costs nothing: the server recognises it and does not transfer it again, which is why re-saving a project with video is quick.
Once a project is in your account, the editor keeps it up to date on its own while you work — the text and the media alike — and the top bar tells you where things stand: Cloud: saved 14:32. Each image, audio or video file goes up once, in the first pause after you add it, and the bar shows its progress while it uploads. The editor also creates the project in your account the first time there is something to save, as long as you have a free slot (free accounts hold five); without one, the bar tells you so.
If a file cannot go up — a video on the free plan, or a full storage quota — the bar says Cloud: saved 14:32 — 1 file not uploaded, and hovering over it names the file and the reason. When you click New activity, the editor tells you whether everything is already in your account; if something is missing, it offers to finish saving to the cloud before clearing the editor.
If the same project is changed somewhere else — another tab, another computer — the editor stops and tells you, instead of one version quietly overwriting the other. Nothing is lost: you choose whether to keep what is on your screen (save it under a new name) or the other version (reload the page).
Download, in the cloud project list, gives you the complete .zip of any project — media included — without opening it. It works for read-only projects too, which matters if your plan changed: you can always take your work out. A project too large for your browser to build as one file falls back to a list of links, one per file, so there is never a project you cannot retrieve.
Opening a project replaces everything currently in the editor, so if you have unsaved changes you are asked to confirm first, and told what would be lost.
.json)Open ▸ from this computer also accepts a plain .json file, which is how you bring in a project drafted outside the editor — for instance one an AI assistant wrote for you. Pick the file the same way you would a .zip.
A .json file carries the structure and all the text, but no media: it cannot contain video, images or caption files. A project that names a media file is refused for that reason. The right way to describe media that has not been recorded yet is to set the screen's media type and leave the file empty; the screen then opens with everything else in place and you attach the recording in Step 3.
The file is checked before anything in the editor changes, so a file with problems never leaves you halfway. If something is wrong you get the full list at once, each item naming the exact spot — screens[3].choices[1].feedback — with a plain-language explanation. Nothing is imported until the list is empty. Sometimes you get warnings instead: those do not block the import, they just tell you what to look at.
docs/schema-en.md.The next section hosts the activity on a server of your own. With a Ramifica account you can skip all of that: one click publishes the activity to Ramifica's own servers and hands you a ready-made link and an embed code — no server, no PHP, no file upload of your own. Publishing works on the free plan, within its limits: five projects, ten screens per activity, 50 MB, images and audio rather than video, and a small “Made with Ramifica” line in the footer while the activity runs.
Sign in from the top bar with your email — Ramifica emails you a one-time sign-in link, so there is no password to create or remember. An account is the one thing publishing does require: nothing leaves your browser without one.
Click Publish. The activity check runs first — fix anything in red — then the editor packages everything and sends it up. An activity with video is uploaded in the background, one piece at a time, with a progress bar; on a slow connection a large one can take a few minutes, which is normal, and any piece that fails is resent on its own, so the button never stalls in silence. When it finishes you get:
https://ramifica.studio/ab7cd2, to send straight to learners. The code is the whole address, so renaming the activity never breaks a link you already shared;<iframe>) to paste into any web page or LMS so the activity plays inside it.Learner attempts are collected on Ramifica's servers under your account, so you do not set a teacher access code or handle a results.jsonl file the way the self-hosted export does. Sizes work as in Step 3 — up to 180 MB per video, on Pro — with a ceiling of about 500 MB for the whole activity; the Publish step shows the running total and warns you before you reach it.
Use Export activity (.zip) when you want to host the activity yourself and have the standalone teacher dashboard. It is a Ramifica Pro feature; on the free plan, publishing above already gives learners a link, a dashboard and the same full report, with no server of your own to look after. The Publish step first shows the activity check; fix anything marked in red. Then:
index.html, dashboard.html, save.php, report.php and the media/ folder.index.html, for example https://yoursite.com/activities/my-activity/index.html.Learners enter their name and class code, complete the activity, see their debrief, and their attempt is recorded on your server in results/results.jsonl (created automatically). Requirements: a server with PHP enabled, which almost all shared hosting has. A read-me.txt with these instructions is included in every export.
If you published from your account, the dashboard is already there: sign in and open My activities. The full report comes with every plan, free included, and it is the same report described below — the self-hosted export and the cloud read from one and the same engine, so neither is the poor relation.
You can also hand out a share code for one activity, which opens the same report for a colleague without learner names. It reaches that one activity and nothing else in your account.
For the self-hosted export, open dashboard.html in the same folder and enter your teacher access code. You will see the total attempts, the list of classes, and the overall percentage of good decisions and attention points. The attempts table shows each learner with date, duration, outcome reached and their counts; click a row to expand the full path, decision by decision. A class filter narrows everything to one class code, Download CSV exports the (filtered) table for Excel, and the decision distribution panel shows, for every decision screen, how many learners chose each option, coloured by quality, which is gold for spotting the moments where a class systematically goes down the risky path.
Results accumulate in results/results.jsonl on your server; back that file up if the data matters to you.
SCORM export is a Ramifica Pro feature. On the free plan the button is not shown, and the way to put an activity inside a course is to publish it and paste the embed code — which works in Moodle and LearnWorlds alike, though it does not write to the gradebook.
Use Export SCORM 1.2 (.zip) when the activity will live inside an LMS. Upload the zip without unzipping it: in LearnWorlds, add a SCORM/HTML5 learning activity to the course and upload the file; in Moodle, choose Add an activity or resource, then SCORM package.
In SCORM mode the LMS already knows who the learner is, so the name and class fields are not shown. The learner still sees the full personalised debrief at the end. What the LMS records is deliberately simple: a score equal to the percentage of good decisions along the path taken (0 to 100), completion when the learner reaches any ending, and the session time.
“This project was changed somewhere else.” You have the same project open in two places — another tab, or another computer — and one of them saved after this one opened it. Nothing was overwritten and nothing is lost. Decide which version you want: to keep what is on this screen, save it to the cloud under a new name; to keep the other one, reload the page. Automatic saving stays paused until you choose.
A file did not go up when I saved. The text and structure are saved anyway — losing your writing to save a file would be the wrong trade — and the editor names each file that stayed behind, with the reason. The two common ones: a video on the free plan (video is a Pro feature) and a full quota. Fix that one thing and save again.
The media did not come back when I reopened the project. If the message says the file is no longer on the server, that project was saved by a version of the editor that did not upload media yet; re-attach the files in Step 3 and save again. If it says what came back does not match what was sent, stop and tell us — that means the file was altered in transit, and it is a fault on our side, not yours.
The project is marked “read-only”. Your plan holds five projects in the cloud; the others stay visible, downloadable and deletable, but not editable. Free a slot by deleting or downloading one you no longer need, or go Pro for unlimited projects. Nothing was deleted.
How do I know I am running the current version? The editor shows its version (for example, Ramifica v2.0) at the bottom of the sidebar, and the player logs it in the browser console (F12 → Console). If an old version appears after you updated the file on your server, force a refresh with Ctrl+F5 (Cmd+Shift+R on Mac).
The dashboard says the access code is wrong. The code was set in Step 1 at the moment of export. If it was left empty, the dashboard is locked: set a code and export again, or edit report.php on the server and put the code in the line $expected = '';.
The dashboard cannot load results. Check that the server runs PHP and that report.php and the results/ folder sit in the same folder as dashboard.html.
Results are not being recorded. Opening index.html straight from a computer folder (a file:// address) plays the activity but cannot save results; recording only works once the files are on the server. In test mode, recording is off by design.
Videos are slow to start. Compress them (see Step 3). The player preloads upcoming videos while the current one plays, but the very first video can only load as fast as the connection allows.
Captions do not appear on the video. Open the .vtt in a text editor and check that the very first line is WEBVTT and the times use the 00:00:01.000 --> 00:00:04.500 format. Captions are set per screen, so confirm the file was uploaded on that screen in Step 3 — and remember that adding captions requires re-exporting the activity.
The feedback panel is not showing after choices. Check two things in order: the Decision feedback setting in Step 1 is on Immediate, and the options actually have feedback text (options with an empty feedback box move straight on by design). Then re-export; activities exported before the change keep the old behaviour.
The learner's name is not appearing (the text shows {{nome}} literally). Two common causes: the activity was exported with a version older than v1.8 — open the project in the current editor and export again — or the marker has a typo. Write it exactly as {{nome}} or {{name}}, with double braces and nothing else inside.
Answers never unlock on a video screen. The options unlock when the video ends, and also if the video fails to load, so learners are never stranded. If you do not want the lock on a given screen, untick Lock the answer until the video ends in Step 3 and export again.
O editor do Ramifica roda no seu navegador, em app.ramificastudio.com. O ideal é um navegador de computador atualizado, como Chrome, Edge, Firefox ou Safari. Tudo de que ele precisa vem do mesmo endereço — nenhum script ou fonte de terceiros — então ele também funciona em rede de escola que bloqueia serviços externos.
O Ramifica funciona a partir da sua conta, então entrar vem primeiro. Ao abrir o editor, ele pede o seu e-mail e envia um link que já entra — não há senha. Criar conta é gratuito, e o plano gratuito constrói, publica e traz o relatório por inteiro.
Onde o seu trabalho fica continua dependendo do que você faz com ele. Escrever, testar e salvar um .zip no seu computador ficam no navegador: o editor nunca envia nada por conta própria. Salvar na nuvem, publicar e o dashboard põem esse trabalho nos servidores do Ramifica, na sua conta, e cada um deles é uma escolha explícita sua.
A interface do editor existe em inglês e português: use o seletor EN / PT na barra superior. Isso muda apenas o editor; o idioma que os alunos veem é uma configuração separada, descrita adiante.
A barra lateral mostra as quatro etapas de construção: Atividade, Estrutura, Conteúdo e Publicar. Você pode transitar entre elas livremente, a qualquer momento.
Esta etapa reúne as configurações gerais. O título da atividade e as instruções iniciais são a primeira coisa que o aluno vê; use as instruções para ambientar: quem o aluno é na história, qual será o papel dele e como a atividade funciona.
Dá para chamar o aluno pelo nome: escreva {{nome}} em qualquer texto da atividade — instruções iniciais, situações, perguntas, opções, feedbacks ou textos de encerramento — e o player substitui pelo nome que o aluno digitou na tela de abertura. Na própria tela de abertura a troca acontece ao vivo, enquanto ele digita: Parabéns, ...! vira Parabéns, Maria! letra a letra. Em pacotes SCORM o nome vem do LMS, já que o aluno não o digita.
Para que serve esta atividade é a única configuração que muda como os seus resultados são lidos, e merece um instante. Escolha Prática — ensinar e consolidar quando a atividade existe para construir uma habilidade e você quer que a maioria acerte. Escolha Simulação — testar decisão em situação realista quando ela existe para revelar o que as pessoas fariam de fato, e acertar não deveria ser fácil. O relatório usa isso: numa tela de prática, 90% de boas decisões é o objetivo alcançado; numa de simulação, os mesmos 90% são um aviso de que a pista estava óbvia demais. Deixe em Não dizer se nenhuma das duas serve — aí o relatório fica calado, em vez de julgar pelo critério errado.
Suas turmas é uma lista opcional, separada por vírgulas. Preencha e o painel de publicação dá um link por turma, sem o aluno digitar nada; deixe vazia e cada aluno digita a turma dele. Preencher é o que impede “9A”, “9a” e “9 A” de virarem três turmas diferentes no seu relatório.
Telas novas nascem com as opções em ordem aleatória define o padrão para as telas que você criar de agora em diante. As que você já fez nunca mudam sozinhas — há um botão ao lado se quiser aplicar a todas de uma vez.
O idioma da atividade controla todos os textos fixos que os alunos (e o dashboard) verão: botões, os campos de nome e turma e os títulos da devolutiva final. Escolha English (Australia) ou Português (Brasil). Ele é independente do idioma do editor, então dá para editar em português e publicar em inglês.
Feedback das decisões define quando o aluno vê o feedback que você escreve para cada opção. Em Imediato (após cada escolha) — o padrão — um painel de feedback abre logo depois que o aluno escolhe: ele mostra a qualidade da decisão (Boa decisão, Ponto de atenção ou Neutra), a opção escolhida e o seu texto de feedback, e um botão Continuar leva à próxima cena. Opções que você deixar sem texto de feedback seguem direto, então dá para escolher quais decisões merecem uma pausa. Em Somente na devolutiva final, a história flui sem interrupções e todo o feedback fica guardado para o fim. Nos dois modos, a devolutiva final sempre mostra o caminho completo com o seu feedback sob cada decisão.
O código de acesso do professor protege o dashboard de resultados quando você publica no seu próprio servidor. Escolha algo que vá lembrar; sem ele o dashboard não abre, e um código vazio bloqueia o acesso por completo. O texto de rodapé aparece na base de todas as telas do aluno e no dashboard; use-o para o crédito autoral, por exemplo © 2026 Seu Nome · Sua Organização.
Logo abaixo dele, o código para compartilhar (opcional) é um segundo código para o mesmo dashboard, pensado para outra pessoa — a coordenação, um colega, quem perguntou como a turma foi. Ele abre exatamente o mesmo relatório, com A atividade funcionou? e Onde a turma tropeça, mas sem nenhum nome de aluno e sem a lista por aluno do final. Os nomes não ficam apenas escondidos na tela: quando o dashboard é aberto com esse código, o arquivo report.php do seu pacote nem chega a enviar os nomes para o navegador, então não há o que garimpar. É isso que torna seguro passar o código adiante. Deixe o campo vazio se não quiser um segundo código.
Deixe o webhook alternativo vazio, a menos que o seu servidor não rode PHP; nesse caso você pode apontar os resultados para outro destino, como um Google Apps Script, e o dashboard embutido deixa de ser usado.
Aqui você cria o esqueleto da história. Um fluxo de trabalho prático é adicionar primeiro todas as telas com + Adicionar tela, nomeá-las, definir os tipos e só então conectar as decisões.
Cada tela tem um de três tipos:
| Tipo | O que faz |
|---|---|
| Decisão | Mostra a cena e uma pergunta com duas ou mais opções. Cada opção leva a outra tela e carregará um feedback pedagógico (inserido na Etapa 3). São essas telas que contam na devolutiva final. |
| Informação | Mostra uma cena com um único botão de continuar; sem pergunta e sem feedback. Serve para contexto, transições ou instruções entre decisões. |
| Final | Encerra a atividade e dispara a devolutiva. Uma atividade pode ter vários finais; crie pelo menos um. |
Nas telas de decisão, digite o texto de cada opção e escolha o destino em → leva para…. Nas telas de informação, defina o destino em Continua para:. Use o seletor Tela inicial para marcar onde a atividade começa.
O destino de uma opção também pode ser ↩ Refazer esta tela — o primeiro item da lista de destinos. Escolha-o quando uma resposta errada deve fazer o aluno tentar a mesma pergunta de novo, em vez de seguir adiante. O aluno sempre vê primeiro o feedback daquela opção (mesmo quando a atividade está configurada para mostrar feedback só na devolutiva final — do contrário ele voltaria sem explicação nenhuma), e o botão vira Tentar de novo no lugar de Continuar. Cada tentativa fica registrada e aparece na devolutiva final e no dashboard, então dá para ver quantas tentativas cada aluno precisou. Em telas com vídeo, refazer não obriga o aluno a assistir ao vídeo de novo. Duas proteções ajudam você: um aviso quando uma opção de refazer está sem texto de feedback, e um erro quando todas as opções de uma tela refazem a própria tela — o aluno ficaria preso, então deixe pelo menos um caminho adiante.
O mapa de fluxo à direita se redesenha enquanto você trabalha. As cores seguem os tipos: início, decisão, informação, final, e vermelho para problema, como uma tela que nenhum caminho alcança ou uma opção sem destino. Clicar numa caixa do mapa rola até aquela tela na lista. A lista abaixo do mapa resume o que precisa de correção; problemas em vermelho impedem a exportação, enquanto avisos em âmbar são apenas lembretes.
Selecione uma tela na fileira de botões no topo; o ponto de cada botão fica verde quando aquela tela tem tudo o que precisa. Para cada tela você define um vídeo ou imagem, o texto da situação e, conforme o tipo, a pergunta e os feedbacks das opções ou o texto de encerramento.
Escolha Vídeo ou Imagem e envie o arquivo. Vídeo é recurso do Ramifica Pro; o plano gratuito usa imagem, áudio e texto, o que basta para a maioria das atividades. Vídeos devem ser mp4 (H.264); imagens jpg, png ou webp. Os arquivos são embutidos no pacote exportado, então tamanho importa: para carregar bem, mire 720p com 1,5 a 2,5 Mbps, o que dá cerca de 10 a 20 MB por minuto. O programa gratuito HandBrake (preset "Web" 720p) comprime lotes de vídeos muito bem. O limite prático por arquivo é 180 MB, mas ficar bem abaixo disso faz diferença real para alunos com conexão lenta.
Logo abaixo da mídia ficam os campos de acessibilidade. Para imagem, há a caixa de texto alternativo: uma descrição de uma ou duas frases que os leitores de tela falam em voz alta. Para vídeo, são dois campos: o envio de legendas (.vtt), que sobrepõe as legendas ao vídeo, e a caixa de alternativa em texto, exibida ao aluno como uma seção expansível abaixo do vídeo descrevendo o que acontece e o que é dito. O que escrever em cada um, e como criar um arquivo de legendas, está passo a passo em Criando atividades acessíveis.
Nas telas com vídeo, a opção Bloquear a resposta até o fim do vídeo (marcada por padrão) mantém a pergunta visível mas as respostas desabilitadas, com uma nota avisando que as opções liberam quando o vídeo termina. Desmarque se quiser respostas disponíveis desde o início. O player também pré-carrega em segundo plano as mídias das próximas telas possíveis enquanto o aluno assiste, para as transições ficarem rápidas.
O texto da situação acompanha a mídia e ambienta a cena; a pergunta é o convite à decisão. Para cada opção você atribui uma qualidade, Boa decisão, Ponto de atenção ou Decisão neutra, e escreve um parágrafo curto de feedback. Quando o aluno vê esse feedback depende da configuração Feedback das decisões da Etapa 1: logo após cada escolha (o padrão) ou somente no fim. Nos dois casos, a devolutiva final lista o caminho percorrido, decisão por decisão, com o seu feedback sob cada uma e um resumo com a contagem de boas decisões e pontos de atenção. O marcador {{nome}} da Etapa 1 também funciona em todos esses textos.
Cada tela de decisão também tem a caixa Apresentar as opções em ordem aleatória. Marque-a e cada aluno verá as opções daquela tela em uma ordem diferente, sorteada — útil quando a posição da resposta certa não deve servir de pista, ou quando os alunos fazem a atividade lado a lado. A devolutiva e o dashboard mantêm a numeração original, então seus dados continuam comparáveis entre alunos.
Nas telas finais, o texto de encerramento explica o que aconteceu naquele desfecho. A devolutiva automática aparece logo abaixo dele. Nas telas de informação você também pode personalizar o texto do botão de continuar.
Uma atividade acessível é aquela que um aluno surdo, cego, com baixa visão ou que navega pelo teclado consegue completar em igualdade de condições. O Ramifica divide esse trabalho de forma justa: o player já cuida da parte técnica por você, e três pequenos campos na Etapa 3 cobrem a parte que só você, autor, pode fazer. Esta seção explica as duas metades.
Toda exportação é totalmente operável pelo teclado (Tab para mover, Enter ou Espaço para acionar). A cada troca de tela, o foco vai para a nova pergunta ou título e o título da página é atualizado, então quem usa leitor de tela sempre sabe onde está. Enquanto um vídeo toca com o bloqueio de resposta ativo, as opções continuam perceptíveis para a tecnologia assistiva, e no instante em que o vídeo termina um anúncio falado avisa que as opções foram liberadas. A qualidade das decisões nunca é transmitida só por cor — sempre há um rótulo em texto — e todas as cores atendem aos padrões de contraste. Alunos que configuram o sistema para reduzir movimento recebem a atividade sem animações. Nada disso exige algo de você; vai embutido em toda exportação.
A caixa de texto alternativo na Etapa 3 é o que o leitor de tela fala no lugar da imagem. Escreva uma ou duas frases descrevendo o que importa na cena para a decisão em questão, como se contasse a um colega pelo telefone: “Miguel está sozinho na carteira, de cabeça baixa, enquanto o resto da turma trabalha em duplas.” Dispense aberturas como “imagem de” (o leitor de tela já anuncia isso) e detalhes decorativos sem significado.
As legendas tornam os vídeos utilizáveis por alunos surdos e com perda auditiva, e ajudam todo mundo em salas barulhentas ou no celular sem som. O Ramifica usa o formato padrão WebVTT, um arquivo de texto simples que você envia uma vez por vídeo na Etapa 3; o player então exibe as legendas sobre o vídeo, ativas por padrão, e as carrega automaticamente nos projetos salvos, nas exportações web e nos pacotes SCORM.
Um arquivo .vtt é simples o bastante para escrever à mão em clipes curtos. Crie um arquivo de texto puro (Bloco de Notas; no Mac, TextEdit em modo texto) salvo com a extensão .vtt:
| Um arquivo de legendas mínimo |
|---|
WEBVTT00:00:01.000 --> 00:00:04.500Miguel, você está quieto a manhã toda.00:00:05.000 --> 00:00:08.000[sinal da escola toca ao fundo] |
A primeira linha precisa ser exatamente WEBVTT. Cada bloco é um intervalo de tempo (horas:minutos:segundos.milissegundos) seguido do texto falado naquele trecho. Inclua sons relevantes entre colchetes e identifique quem fala quando não for óbvio. Para vídeos mais longos, deixe uma ferramenta fazer a marcação de tempo: suba o vídeo no YouTube (pode ficar como não listado), deixe gerar as legendas automáticas, corrija-as no YouTube Studio e baixe o .vtt; ou use o programa gratuito Subtitle Edit, que toca o vídeo ao lado do texto enquanto você digita. Sempre revise legendas automáticas — elas erram nomes e termos técnicos.
A caixa de alternativa em texto é a versão escrita da cena inteira: o que acontece e o que é dito, em forma de narrativa. O aluno a vê como uma seção recolhida “Alternativa em texto” abaixo do vídeo e a abre se precisar — porque não pode ver o vídeo, não pode reproduzi-lo onde está, ou quer reler um detalhe antes de decidir. Legendas e alternativa em texto se complementam; para acessibilidade plena, forneça as duas, mas se só puder fazer uma, a verificação da exportação aceita qualquer uma delas.
Na etapa Publicar, a verificação da atividade agora inclui avisos de acessibilidade: um vídeo sem legendas nem alternativa em texto, ou uma imagem sem texto alternativo, é sinalizado em âmbar. Avisos não impedem a publicação — a decisão continua sua — mas são a lista honesta de quem pode ficar de fora.
Testar atividade (na barra superior ou no primeiro cartão da etapa Publicar) abre a atividade numa nova aba exatamente como o aluno verá, com uma faixa indicando o modo de teste e o registro de resultados desligado. No modo de teste aparece um botão Recomeçar no final, para você percorrer todos os ramos. Teste cada caminho pelo menos uma vez antes de publicar; a verificação pega problemas estruturais, mas só você pega um vídeo anexado à cena errada.
Salvar ▸ no computador baixa um arquivo com nome no formato seu-titulo.ramifica-project.zip. Esse arquivo é o projeto completo, mídias incluídas; guarde-o como sua cópia mestra e faça backup como de qualquer documento importante. Abrir ▸ do computador o restaura por inteiro, em qualquer computador. Isso é backup, e está em todos os planos.
O editor também mantém um rascunho automático no navegador e oferece restaurá-lo quando você volta. Trate-o apenas como rede de segurança: ele não inclui as mídias e não transita entre computadores ou navegadores.
Em qualquer plano — gratuito ou Pro — o Salvar ▸ na nuvem guarda o projeto nos servidores do Ramifica, com as imagens, os áudios e as legendas (e o vídeo, no Pro). O Abrir ▸ da nuvem traz tudo de volta em qualquer computador. Enviar o mesmo arquivo duas vezes não custa nada: o servidor reconhece e não transfere de novo, e é por isso que regravar um projeto com vídeo é rápido.
Depois que o projeto está na sua conta, o editor o mantém atualizado sozinho enquanto você trabalha — o texto e as mídias — e a barra superior mostra em que pé está: Nuvem: salvo 14:32. Cada imagem, áudio ou vídeo sobe uma vez, na primeira pausa depois de anexado, e a barra mostra o andamento enquanto ele sobe. O editor também cria o projeto na sua conta na primeira vez em que há algo a salvar, desde que haja vaga (a conta gratuita guarda cinco); sem vaga, a barra avisa.
Se um arquivo não puder subir — um vídeo no plano gratuito, ou a cota de armazenamento cheia —, a barra diz Nuvem: salvo 14:32 — 1 arquivo não subiu, e ao passar o mouse sobre ela aparecem o nome do arquivo e o motivo. Ao clicar em Nova atividade, o editor diz se está tudo na sua conta; se faltar algo, oferece terminar de salvar na nuvem antes de limpar o editor.
Se o mesmo projeto for alterado em outro lugar — outra aba, outro computador — o editor para e avisa, em vez de deixar uma versão sobrescrever a outra em silêncio. Nada se perde: você escolhe se fica com o que está na sua tela (salvando com outro nome) ou com a outra versão (recarregando a página).
O Baixar, na lista de projetos da nuvem, entrega o .zip completo de qualquer projeto — com mídia — sem precisar abri-lo. Funciona também para projetos somente leitura, o que importa se o seu plano mudou: você sempre consegue tirar o seu trabalho de lá. Projeto grande demais para o navegador montar num arquivo só cai numa lista de links, um por arquivo, então não existe projeto que você não consiga recuperar.
Abrir um projeto substitui tudo o que está no editor, então, se houver alterações não salvas, você é avisado antes e informado do que se perderia.
.json)O Abrir ▸ do computador também aceita um arquivo .json simples, que é como você traz um projeto redigido fora do editor — por exemplo, um que um assistente de IA escreveu para você. Escolha o arquivo do mesmo jeito que escolheria um .zip.
Um arquivo .json carrega a estrutura e todos os textos, mas nenhuma mídia: ele não pode conter vídeo, imagem nem arquivo de legenda. Por isso, um projeto que cite um arquivo de mídia é recusado. A forma certa de descrever mídia que ainda não foi gravada é definir o tipo de mídia da tela e deixar o arquivo vazio; a tela abre com todo o resto no lugar, e você anexa a gravação na Etapa 3.
O arquivo é conferido antes de qualquer mudança no editor, então um arquivo com problema nunca deixa você pela metade. Se houver algo errado, você recebe a lista inteira de uma vez, cada item apontando o lugar exato — screens[3].choices[1].feedback — com uma explicação em linguagem comum. Nada é importado enquanto a lista não estiver vazia. Às vezes vêm avisos em vez de erros: esses não impedem a importação, apenas indicam o que vale conferir.
docs/schema-pt.md.A próxima seção hospeda a atividade no seu próprio servidor. Com uma conta Ramifica, você pode pular tudo isso: um clique publica a atividade nos servidores do próprio Ramifica e devolve um link pronto e um código de embed — sem servidor, sem PHP e sem upload de arquivos da sua parte. Publicar funciona no plano gratuito, dentro dos limites dele: cinco projetos, dez telas por atividade, 50 MB, imagem e áudio em vez de vídeo, e uma linha discreta “Feito com Ramifica” no rodapé enquanto a atividade roda.
Entre pela barra superior com o seu e-mail — o Ramifica envia por e-mail um link de acesso de uso único, então não há senha para criar ou lembrar. A conta é a única coisa que publicar exige: nada sai do seu navegador sem ela.
Clique em Publicar. A verificação da atividade roda primeiro — corrija o que estiver em vermelho — e então o editor empacota tudo e envia. Uma atividade com vídeo sobe em segundo plano, um pedaço de cada vez, com barra de progresso; numa conexão lenta, uma atividade grande pode levar alguns minutos, o que é normal, e qualquer pedaço que falhe é reenviado sozinho, então o botão nunca trava em silêncio. Ao concluir, você recebe:
https://ramifica.studio/ab7cd2, para enviar direto aos alunos. O código é o endereço inteiro, então renomear a atividade nunca quebra um link que você já compartilhou;<iframe>) para colar em qualquer página web ou LMS e a atividade tocar dentro dela.As tentativas dos alunos ficam registradas nos servidores do Ramifica, na sua conta, então você não define código de acesso do professor nem lida com um arquivo results.jsonl como na exportação para servidor próprio. Os tamanhos seguem a Etapa 3 — até 180 MB por vídeo, no Pro — com um teto de cerca de 500 MB para a atividade inteira; a etapa Publicar mostra o total e avisa antes de você chegar lá.
Use Exportar atividade (.zip) quando quiser hospedar a atividade você mesmo e ter o dashboard independente do professor. É um recurso do Ramifica Pro; no plano gratuito, publicar acima já devolve link para os alunos, dashboard e o mesmo relatório completo, sem servidor nenhum para cuidar. A etapa Publicar mostra primeiro a verificação da atividade; corrija o que estiver em vermelho. Depois:
index.html, dashboard.html, save.php, report.php e a pasta media/.index.html, por exemplo https://seusite.com/atividades/minha-atividade/index.html.O aluno informa nome e código da turma, completa a atividade, vê a devolutiva, e a tentativa fica registrada no seu servidor em results/results.jsonl (criado automaticamente). Requisito: servidor com PHP habilitado, presente em praticamente toda hospedagem compartilhada. Um leia-me.txt com essas instruções acompanha cada exportação.
Se você publicou pela sua conta, o dashboard já está lá: entre e abra Minhas atividades. O relatório completo vem em todos os planos, o gratuito incluído, e é o mesmo relatório descrito abaixo — a exportação para servidor próprio e a nuvem leem do mesmo motor, então nenhuma das duas é a parente pobre.
Você também pode entregar um código de compartilhamento de uma atividade, que abre o mesmo relatório para um colega sem os nomes dos alunos. Ele alcança aquela atividade e mais nada da sua conta.
Para a exportação em servidor próprio, abra o dashboard.html da mesma pasta e informe o seu código de acesso. Você verá o total de tentativas, a lista de turmas e os percentuais gerais de boas decisões e pontos de atenção. A tabela de tentativas mostra cada aluno com data, duração, desfecho alcançado e as contagens; clique numa linha para expandir o caminho completo, decisão por decisão. O filtro de turma restringe tudo a um código de turma, Baixar CSV exporta a tabela (já filtrada) para o Excel, e o painel de distribuição das decisões mostra, para cada tela de decisão, quantos alunos escolheram cada opção, colorido pela qualidade, o que é ouro para localizar os momentos em que uma turma sistematicamente segue o caminho arriscado.
Os resultados se acumulam em results/results.jsonl no servidor; faça backup desse arquivo se os dados importarem para você.
A exportação SCORM é recurso do Ramifica Pro. No plano gratuito o botão não aparece, e o jeito de pôr uma atividade dentro de um curso é publicá-la e colar o código de embed — que funciona igual no Moodle e no LearnWorlds, embora não escreva no livro de notas.
Use Exportar SCORM 1.2 (.zip) quando a atividade for viver dentro de um LMS. Envie o zip sem descompactar: no LearnWorlds, adicione ao curso uma atividade de aprendizagem SCORM/HTML5 e suba o arquivo; no Moodle, escolha Adicionar atividade ou recurso e depois Pacote SCORM.
No modo SCORM o LMS já sabe quem é o aluno, então os campos de nome e turma não aparecem. O aluno continua vendo a devolutiva personalizada completa no final. O que o LMS registra é deliberadamente simples: uma nota igual ao percentual de boas decisões no caminho percorrido (0 a 100), a conclusão quando o aluno chega a qualquer final, e o tempo de sessão.
“Este projeto foi alterado em outro lugar.” Você está com o mesmo projeto aberto em dois lugares — outra aba, ou outro computador — e um deles salvou depois que este aqui abriu. Nada foi sobrescrito e nada se perdeu. Decida qual versão você quer: para ficar com o que está nesta tela, salve na nuvem com outro nome; para ficar com a outra, recarregue a página. O salvamento automático fica pausado até você escolher.
Um arquivo não subiu quando salvei. O texto e a estrutura são salvos assim mesmo — perder a sua escrita para salvar um arquivo seria a troca errada — e o editor diz qual arquivo ficou para trás, com o motivo. Os dois comuns: vídeo no plano gratuito (vídeo é recurso do Pro) e cota cheia. Resolva aquele ponto e salve de novo.
A mídia não voltou quando reabri o projeto. Se a mensagem diz que o arquivo não está mais no servidor, aquele projeto foi salvo por uma versão do editor que ainda não enviava mídia; reanexe os arquivos na Etapa 3 e salve de novo. Se diz que o que voltou não confere com o que foi enviado, pare e nos avise — isso significa que o arquivo foi alterado no caminho, e a falha é nossa, não sua.
O projeto está marcado como “somente leitura”. O seu plano guarda cinco projetos na nuvem; os demais continuam visíveis, baixáveis e excluíveis, mas não editáveis. Libere uma vaga excluindo ou baixando um de que você não precisa mais, ou assine o Pro para projetos ilimitados. Nada foi apagado.
Como sei que estou na versão atual? O editor mostra a versão (por exemplo, Ramifica v2.0) no rodapé da barra lateral, e o player a registra no console do navegador (F12 → Console). Se aparecer uma versão antiga depois de você atualizar o arquivo no servidor, force a atualização com Ctrl+F5 (Cmd+Shift+R no Mac).
O dashboard diz que o código está incorreto. O código foi definido na Etapa 1 no momento da exportação. Se ficou vazio, o dashboard fica trancado: defina um código e exporte de novo, ou edite o report.php no servidor e coloque o código na linha $expected = '';.
O dashboard não carrega os resultados. Verifique se o servidor roda PHP e se report.php e a pasta results/ estão na mesma pasta do dashboard.html.
Os resultados não estão sendo gravados. Abrir o index.html direto de uma pasta do computador (endereço file://) reproduz a atividade, mas não consegue salvar resultados; a gravação só funciona com os arquivos no servidor. No modo de teste, a gravação fica desligada de propósito.
Os vídeos demoram para começar. Comprima-os (veja a Etapa 3). O player pré-carrega os próximos vídeos enquanto o atual toca, mas o primeiro vídeo só consegue carregar na velocidade da conexão.
As legendas não aparecem no vídeo. Abra o .vtt num editor de texto e confira se a primeiríssima linha é WEBVTT e se os tempos usam o formato 00:00:01.000 --> 00:00:04.500. As legendas são definidas por tela, então confirme se o arquivo foi enviado naquela tela na Etapa 3 — e lembre que adicionar legendas exige reexportar a atividade.
O painel de feedback não aparece após as escolhas. Verifique duas coisas, nesta ordem: se a configuração Feedback das decisões da Etapa 1 está em Imediato, e se as opções realmente têm texto de feedback (opções com a caixa de feedback vazia seguem direto, por design). Depois reexporte; atividades exportadas antes da mudança mantêm o comportamento antigo.
O nome do aluno não aparece (o texto mostra {{nome}} literalmente). Duas causas comuns: a atividade foi exportada com uma versão anterior à v1.8 — abra o projeto no editor atual e exporte de novo — ou o marcador tem erro de digitação. Escreva exatamente {{nome}} ou {{name}}, com chaves duplas e nada mais dentro.
As respostas não liberam numa tela com vídeo. As opções liberam quando o vídeo termina, e também se o vídeo falhar ao carregar, para ninguém ficar preso. Se não quiser o bloqueio numa tela específica, desmarque Bloquear a resposta até o fim do vídeo na Etapa 3 e exporte novamente.