📖 Supertales

Interactive storytelling platform — create, share, and explore branching narratives.

Supertales is a web-based interactive fiction engine built with React. Players navigate branching story paths, make choices that affect outcomes, and experience immersive audio-driven narratives powered by Tone.js.

✨ Features

• Branching narratives — Stories with multiple paths and endings
• Audio immersion — Integrated soundscapes via Tone.js
• Choice-driven gameplay — Player decisions shape the story
• Responsive design — Works on desktop and mobile
• React-powered — Fast, component-based UI

🚀 Quick Start

git clone https://github.com/bonanza127/Supertales.git
cd Supertales
npm install
npm start

The app runs on http://localhost:3000.

📦 Build

npm run build

Production build outputs to build/.

🧪 Tests

npm test

🤝 Contributing

Contributions are welcome! Please read CONTRIBUTING.md for guidelines.

1. Fork the repo
2. Create your branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push (git push origin feature/amazing-feature)
5. Open a Pull Request

🗺️ Roadmap

• Story editor UI for non-technical creators
• Multiplayer story mode
• Export stories as standalone HTML
• Community story sharing platform
• Localization (i18n) support

📄 License

MIT — see LICENSE for details.

🔗 Links

• Report a bug
• Request a feature
• Discussions