Bleepx — Learn SQL, Data Science & Cloud by Solving Cases
Bleepx is a browser-native learning platform where you master SQL (BleepxQuery), Python/R data science (BleepxLab), and cloud architecture (BleepxCloud) by solving realistic case studies. Everything runs client-side on WebAssembly — your code never leaves your device. And when you want a fight, the Bleepx Arena pits your champion against the house bot in real-code duels.
Live: bleepx.dev • Bio hub: /links • Source: github.com/Landrykb/sql-train
Table of contents
- What is Bleepx?
- Features
- The three verses + the Arena
- Guest policy
- Architecture
- Tech stack
- Getting started (local dev)
- Environment variables
- Deployment
- Supabase setup
- Analytics
- Project structure
- Contributing
- Privacy & Terms
- Security
- License
What is Bleepx?
Bleepx turns "another SQL tutorial" into narrative case studies you actually want to finish. Each case drops you into a believable scenario — a missing-data investigation, a supply-chain mystery, a telecom-churn prediction, an S3 misconfiguration — and hands you the tools to crack it.
Why it's different:
- Built-in guide, Bleepx — a pixelated mascot who gives hints, reacts to mistakes, and celebrates wins with bleepy commentary.
- Zero setup, zero wall — SQL runs via
sql.js, Python runs via Pyodide, cloud missions run in a client-side simulator. Browse and run everything as a guest; sign-in is only asked when you want progress saved.
- The Arena — coach a champion through real-code duels (live SQL execution, Pyodide duels, sandbox build missions), or tag in and fight the last round yourself. Shareable match cards + replays.
- Progression with teeth — points, streaks, achievements, a shop, a daily duel, a rival ladder, champion evolution bridged from training.
- Portfolio-ready — one click pushes your solved work to a GitHub repo (
sql-portfolio, ds-portfolio).
- Honest pricing — everything is free today; Bleepx Verified is labeled a free preview until real checkout lands.
Features
For learners
| Area | What you get |
|---|
| SQL cases | 100+ real-world cases across 9 domains (finance, healthcare, space, etc.) |
| Data-science projects | 38 guided projects in 9 domains (transport, churn, fraud, ESG, more) |
| Cloud missions | AWS/Azure/GCP/ESG/FinOps tracks — quizzes, scenarios, build missions, checklist |
| Interactive editors | CodeMirror with syntax highlighting, autocomplete, keyboard shortcuts |
| Live execution | sql.js for SQL, Pyodide for Python, client-side AWS simulator — all browser |
| The Arena | Coach or tag-team duels vs the house bot; daily duel, rival ladder, replays |
| Smart error help | Contextual hints + checkers that say why a result is wrong |
| Visualizations | Auto-charts (Plotly) for completed cases; Python/R viz guides in Lab |
| Hints & solutions | Progressive hints (first 3 free), thought-process walkthroughs, full solutions |
| Points & shop | Earn points for solving; spend on skips, trial unlocks, cosmetic titles |
| Quizzes | Per-topic quizzes for SQL trials, Lab, and Cloud |
| Test mode | Optional timed challenges with tier-based limits |
| GitHub export | Push solved work to your own portfolio repo with one click |
| Cross-device sync | Sign in with GitHub → progress syncs via Supabase |
| Mobile-friendly | Wrapping toolbars, sticky Run — works on phones |
For admins
- Anonymous PostHog analytics — which cases are popular, where users drop off.
- Save-time sign-in gate — guests run everything; GitHub sign-in is asked at completion (progress, points, portfolio push).
- Supabase daily keep-alive — GitHub Actions cron prevents free-tier pause.
- Security overrides — pnpm/npm overrides pin patched versions of flagged CVEs.
- YAML-driven curriculum — add a case by dropping a
.yaml file. No code changes needed.
The three verses + the Arena
BleepxQuery — SQL cases
- Routes:
/cases, /cases/[domain], /cases/[domain]/[caseId]
- Domains:
business, crime, farming, finance, healthcare, social, space, sports + trials (timed challenges + Master Quiz)
- Palette: blue/indigo
BleepxLab — Python/R data science
- Routes:
/lab, /lab/[domain], /lab/[domain]/[projectId]
- Domains: transport, forecasting, churn, music, fraud, esg_climate, decarb, agri_econ, fin_risk
- Runnable Python via Pyodide, R reference, topic quizzes
- Palette: teal/emerald
This is the beginning of the README. Read the rest at the original. Read the full README ↗
