A framework for turning reference material — course notes, papers, slides, datasets — into interactive quizzes, code labs, and simulations. Drop your sources into references/, pick a template, generate a learnable artifact. Comes with a working library covering data analysis, statistics, and marketing analytics that you can use as-is or remix. Vanilla HTML/CSS/JS, optional Supabase for auth and persistence, no build step.
The site runs in demo mode (no login, no setup) on GitHub Pages. Pick a game:
Hub: pashasan.github.io/learning-simulation-platform
Quiz games
- Analytics Quiz — regression, multiple regression, discrete choice, model evaluation
- Quantitative Marketing Methods — PhD-level empirical methods
Simulations
- Brew & Budget — marketing budget allocation
- RoboVault — product design with consumer research
Code labs (X-Ray / Assemble / Rewire)
- Intro to Python · Linear Regression 1 · Linear Regression 2
- Discrete Choice 1 · Discrete Choice 2 · A/B Testing
- PyTorch 1 · PyTorch 2 · PyTorch 3
- GPT 1 · GPT 2
Surveys
In demo mode, auth is bypassed and you play as a guest. Leaderboards and progress aren't persisted. To run with real persistence, see SETUP.md.
 |
 |
| Platform hub — game selector | Analytics quiz — interactive concept walkthroughs |
 |
 |
| Brew & Budget — marketing budget allocation sim | RoboVault — product design with consumer research |
 |
 |
| Code labs — X-Ray / Assemble / Rewire exercises | Surveys — course feedback collection |
The platform is two things at once: a working library of interactive learning apps you can run and learn from, and a framework for building your own from raw material.
The conversion workflow:
- Drop reference material into
references/— slides, lecture notes, papers, datasets, notebooks, anything you want to convert into interactive content. The folder is the canonical source-of-truth location for the content you'll build games from. - Pick a template that matches the kind of artifact you want:
- Quiz volume (concept walkthrough with multiple-choice + visualizations) →
choice-games/<topic>/templates/ - Code lab (X-Ray / Assemble / Rewire style coding exercise) → existing labs under
code-labs/as references - Simulation variant (resource-allocation or product-design style sim) →
simulation-games/<type>/ - Survey →
survey-games/course-feedback/as a reference - New game type entirely → docs/ADDING_GAME_TYPES.md
- Quiz volume (concept walkthrough with multiple-choice + visualizations) →
- Generate the interactive content from your reference using the methodology in docs/GAME_DESIGN_GUIDE.md — a 7-phase pipeline (analyze → extract concepts → narrative → screens → questions → interactions → polish) with case studies showing how real course sessions became finished games.
- Serve and play —
python -m http.server 8000, no build step, refresh-to-iterate.
Keep your additions private (just a local folder), or open a PR to add them to the shared library so others can learn from your material too — see CONTRIBUTING.md.
git clone https://github.com/Pashasan/learning-simulation-platform.git
cd learning-simulation-platform
python -m http.server 8000
# Visit http://localhost:8000/Quiz-based games that test knowledge through interactive questions and scenarios.
Quiz-based volumes covering core analytics topics. Each volume tells a story while teaching a concept through interactive questions, visualizations, and badges.
| Volume | Topic |
|---|---|
| Tutorial: Data Basics | Descriptive statistics, averages, spread, histograms |
| Vol 1: Regression Analysis | Linear regression, correlation, confidence intervals |
| Vol 2: Multiple Regression | Multicollinearity, VIF, adjusted R-squared, model comparison |
| Vol 3: The Choice Lab | Logistic regression, S-curve, coefficients, prediction calculator |
| Vol 4: The Choice Lab: Evaluation | Confusion matrix, precision & recall, AUC & ROC, multinomial logit |
Open: choice-games/analytics/ (after running the local server — see SETUP.md)
Hands-on simulations where you make decisions and see real-time results.
A marketing resource allocation simulation. Players manage a coffee shop's $300K/month marketing budget across three channels over 12 months, learning which metrics actually drive revenue and which are vanity metrics.
- Three difficulty modes with AI competitors
- In-game regression analytics that unlock progressively
- Scoring against a mathematically optimal benchmark
Open: simulation-games/resource-allocation/brew-and-budget/
A product design simulation where players act as product managers at a robotics startup. Players conduct consumer research, design robots (4 attributes + pricing), and launch products into a market with hidden consumer segments.
- Mixed logit consumer choice model with hidden segments and AI competitors
- Two research methods (conjoint analysis, pricing study) with realistic estimation noise
- Post-game insight quiz testing understanding of market structure
- Scoring against a mathematically optimal benchmark (oracle)
Open: simulation-games/product-design/robo-vault/
- Vanilla HTML/CSS/JavaScript (no build step)
- Supabase (Authentication + PostgreSQL)
- Static-hostable (GitHub Pages, Netlify, Vercel, Cloudflare Pages, or any file server)
- Shared auth across all games (one account works across every game on the same origin)
├── index.html # Platform hub page
├── 404.html # Redirect handler for old URLs
├── privacy.html # Privacy policy
├── terms.html # Terms of service
│
├── choice-games/
│ ├── analytics/ # Analytics quiz game
│ │ ├── index.html # Login & volume selector
│ │ ├── admin.html # Admin dashboard
│ │ ├── settings.html # User settings & account deletion
│ │ ├── css/game.css # Shared styles
│ │ ├── js/ # Shared libraries
│ │ ├── volumes/ # One folder per volume
│ │ ├── templates/ # Volume templates
│ │ └── scripts/ # Validation tools
│ ├── pytorch/ # (Placeholder)
│ ├── sat-math/ # (Placeholder)
│ └── alignment-research/ # (Placeholder)
│
├── simulation-games/
│ ├── resource-allocation/
│ │ └── brew-and-budget/ # Brew & Budget simulation game
│ │ ├── index.html # Auth/login page (cafe-themed)
│ │ ├── game.html # Game (Canvas 2D HUD + Three.js 3D scene)
│ │ ├── settings.html # User settings & account deletion
│ │ ├── admin.html # Admin dashboard
│ │ ├── js/ # All game JS (ES modules)
│ │ └── docs/ # Model spec, schema, variant guide
│ └── product-design/
│ └── robo-vault/ # RoboVault product design simulation
│ ├── index.html # Auth/login page (tech lab theme)
│ ├── game.html # Game (Canvas 2D HUD + Three.js 3D scene)
│ ├── settings.html # User settings & account deletion
│ ├── admin.html # Admin dashboard
│ ├── js/ # All game JS (ES modules)
│ └── docs/ # Schema definitions
│
└── docs/ # Platform-wide documentation
├── ARCHITECTURE.md # Platform overview & analytics quiz architecture
├── SCHEMA.md # Consolidated database schema reference
├── ADDING_VOLUMES.md # Guide for new quiz volumes
├── ADDING_GAME_TYPES.md # Guide for adding a new game type
├── GAME_DESIGN_GUIDE.md # Methodology for converting courses into games
├── SUPABASE_SETUP.md # Shared Supabase infrastructure reference
├── DEPLOYMENT.md # GitHub Pages deployment and URL structure
└── ANALYTICS_QUERIES.md # Example SQL queries for analytics data
| Guide | Description |
|---|---|
| SETUP.md | Step-by-step setup: Supabase project, credentials, tables, local serve |
| docs/ARCHITECTURE.md | Platform overview, data flow, Supabase schema |
| docs/SCHEMA.md | Consolidated database schema reference |
| docs/ADDING_VOLUMES.md | Creating new analytics quiz volumes |
| docs/ADDING_GAME_TYPES.md | Adding a new game type to the platform |
| docs/SUPABASE_SETUP.md | Shared Supabase infrastructure reference |
| docs/DEPLOYMENT.md | GitHub Pages deployment and URL structure |
| docs/GAME_DESIGN_GUIDE.md | Converting course materials into games |
| docs/ANALYTICS_QUERIES.md | Example SQL queries for analytics data |
| simulation-games/resource-allocation/brew-and-budget/docs/ADDING_VARIANTS.md | Creating new simulation game variants |
| simulation-games/resource-allocation/brew-and-budget/docs/SIMULATION_MODEL.md | Demand model, optimal strategy derivation |
| simulation-games/resource-allocation/brew-and-budget/docs/GAME_CREATOR_GUIDE.md | Simulation game design and parameter tuning |
| simulation-games/product-design/robo-vault/docs/SCHEMA.sql | RoboVault database schema |
No build step required. Serve from the repo root:
python -m http.server 8000Then visit:
http://localhost:8000/for the platform hubhttp://localhost:8000/choice-games/analytics/for the analytics quiz gamehttp://localhost:8000/simulation-games/resource-allocation/brew-and-budget/for Brew & Budgethttp://localhost:8000/simulation-games/product-design/robo-vault/for RoboVault
Contributions are welcome — new quiz volumes, code labs, simulation variants, bug fixes, docs improvements, accessibility work, and translations.
- New to open source? Start with docs/FIRST_CONTRIBUTION.md — a walkthrough of two small real PRs.
- Ready to dive in? Read CONTRIBUTING.md for setup, PR conventions, and where to start.
- Looking for somewhere to start? Browse issues tagged
good first issueorhelp wanted. - Reporting a security issue? See SECURITY.md — please don't file public issues for vulnerabilities.
All participants are expected to follow our Code of Conduct.
MIT — free to use, modify, and distribute with attribution.