The Beach Mystery is an interactive choose-your-own-adventure story that runs entirely in the browser. Starting from a single sun-drenched beach, your choices branch the narrative across seven distinct storylines leading to four unique endings — no two playthroughs are the same.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/apursley2012/the-beach-mystery/llms.txt
Use this file to discover all available pages before exploring further.
How to Play
Learn the controls, choices, and flow of The Beach Mystery from start to finish.
Personalization
See how your five answers are woven directly into the story text.
Storylines
Explore all seven branching paths and the choices that lead to each one.
Endings
Discover the four unique endings and how to unlock every one.
What to Expect
Before the story begins, you answer five personalization questions — your name, favorite color, animal, cartoon character, and jewel. These details are woven into the narration so the adventure feels personal to you. From there, every major decision shapes the path ahead:- Open the chest or leave it buried? Opening it gives you a jewel and a treasure map. Leaving it sends you straight toward a cave.
- Follow the treasure map? The route leads to a mist-covered island guarded by two men who demand you solve a riddle.
- Enter the cave? A dark passage splits into two tunnels. The left leads to a hidden treasure chamber; the right leads to a guardian’s den.
Answer the five questions
Enter your name, favorite color, animal, cartoon character, and jewel. These personalize every story moment.
Read the story and make choices
Story text appears line by line. When a decision point arrives, click a choice button to branch the narrative.
Reach an ending
Each path ends with one of four unique story conclusions. Your journey summary is shown at the end.
Features at a Glance
7 Storylines
Seven complete paths branching from the same beach opening.
4 Endings
Island treasure, hidden chamber, guardian’s den, or peaceful walk.
Personalized Story
Your five answers appear naturally throughout the narration.
Inventory System
Collect the jewel and treasure map — they affect later story moments.
Riddle Challenge
Solve the guard’s riddle on the island path. A hint unlocks after two wrong answers.
Save & Replay
Save mid-story with localStorage. Resume exactly where you left off.
For Developers
If you want to extend the story, swap artwork, or deploy your own version, the Developer Reference section covers the complete architecture.Project Structure
Understand how files, components, data, and hooks are organized.
Story Node Graph
Learn how the branching narrative is modeled as a data-driven graph.
Adding Story Nodes
Step-by-step guide to extending the story with new branches and endings.
Deployment
Deploy your own copy to GitHub Pages in minutes.