Paolo Dalprato
ChoiceMap¶
Last updated: January 26, 2026
A framework for documenting multiple-choice processes.
ChoiceMap transforms complex workflows into interactive experiences. Instead of reading a document from start to finish, users navigate through a decision tree where each choice opens a different path.
Users see a series of cards with multiple choices leading to different paths. At any time, they can open the visual map to see the complete structure, visited nodes, and current position. This dual mode—guided navigation and overview—reduces the disorientation typical of branching content.
The tool is designed for corporate trainers, instructional designers, and educational content creators who want to transform static materials into engaging experiences. A procedures manual becomes a guided path, troubleshooting becomes an interactive guide, a case study becomes a decision-making simulation.
On GitHub, the repository is github.com/paolodalprato/ChoiceMap
What you can create¶
With ChoiceMap you can build different types of interactive content.
Training paths that adapt to user responses: those who answer correctly proceed, those who make mistakes receive additional explanations before continuing.
Process simulations that guide through complex procedures, such as support ticket escalation or customer request handling.
Branching quizzes where each answer leads to specific feedback and the path changes based on choices.
Interactive stories in "choose your own adventure" style for onboarding, safety training, or exploring business scenarios.
How it works¶
The framework consists of three tools that work together:
- Navigator: displays the scenario and manages user interaction.
- Scenario Editor: allows creating and modifying content visually.
- Theme Editor: enables customizing colors, fonts, and company branding.
The content is stored in simple JSON files, editable even with a text editor. No complex server is needed: a static web server is sufficient to publish scenarios, such as GitHub Pages.
Who this manual is for¶
The manual guides step by step from first installation to online publication. It requires no programming skills. Basic familiarity with using a browser and performing simple operations like downloading files and editing text is sufficient.
If you already know what a JSON file is, you'll find the data structure familiar. If you don't, the manual explains everything needed to create working scenarios.