How anicolao/blueroux works
Blueroux appears to be a browser-based Rubik’s Cube solving and practice application: it supports custom solving methods, solve reconstruction and optimization, solve/timer and analysis screens, and GAN smart-cube pairing. A solve can be reconstructed into configured stages and optimized in a worker; the sampled code supports those internal calls, but does not show how the route screens initiate them. The README is an untouched Svelte starter template, so product capabilities are inferred from the source tree and module names; unsampled route behavior and wiring are not asserted.
Main entry points: store.ts Application state · MethodReconstruction.ts Stage reconstruction · bluetooth.ts Bluetooth GATT · OptimizerWorker.ts Optimization worker
Components 26
Application screens
- App shell
src/routes/(app)/+layout.svelte - Practice screens
src/routes/(app)/timer/+page.svelte - Analysis screen
src/routes/(app)/analysis/+page.svelte - Solve history
src/routes/(app)/history_edu/+page.svelte - Method editor
src/routes/(app)/mask_editor/+page.svelte - Embed views
src/routes/(embed)/embed/+page.svelte
Solve methods
- Solve display
src/lib/components/Solve.svelte - Stage reconstruction
src/lib/components/MethodReconstruction.ts - Optimization worker
src/lib/OptimizerWorker.ts - Solution optimizer
src/lib/optimizer/optimizer.ts - Method definitions
src/lib/components/methods.ts - Stage definitions
src/lib/components/stages.ts
Smart cube
- Bluetooth screen
src/routes/(app)/bluetooth/+page.svelte - Device pairing
src/lib/bluetooth/pair.ts - Bluetooth GATT
src/lib/bluetooth/bluetooth.ts - GAN protocol v1
src/lib/bluetooth/gan/gan356i_v1.ts - GAN protocol v2
src/lib/bluetooth/gan/gan356i_v2.ts
State and services
- Application state
src/lib/store.ts - Authentication state
src/lib/components/auth.ts - User preferences
src/lib/components/preferences.ts - Cube records
src/lib/components/cubes.ts - Solve records
src/lib/components/solves.ts - Firebase adapter
src/lib/firebase.ts
Other components
- User
- Browser Bluetooth
- Firebase services
Connections 18
- Optimization worker → Stage reconstruction: analyzes solve
src/lib/OptimizerWorker.ts - Optimization worker → Solution optimizer: optimizes stages
src/lib/OptimizerWorker.ts - Stage reconstruction → Solution optimizer: visualizes cube
src/lib/components/MethodReconstruction.ts - Stage reconstruction → Method definitions: reads method map
src/lib/components/MethodReconstruction.ts - Stage reconstruction → Stage definitions: reads stage rules
src/lib/components/MethodReconstruction.ts - Application state → Authentication state: registers reducer
src/lib/store.ts - Application state → Method definitions: registers reducer
src/lib/store.ts - Application state → Stage definitions: registers reducer
src/lib/store.ts - Application state → User preferences: registers reducer
src/lib/store.ts - Application state → Cube records: registers reducer
src/lib/store.ts - Application state → Solve records: registers reducer
src/lib/store.ts - Firebase adapter → Application state: reads user state
src/lib/firebase.ts - Firebase adapter → Firebase services: uses Firestore
src/lib/firebase.ts - Device pairing → Bluetooth GATT: requests device
src/lib/bluetooth/pair.ts - Bluetooth GATT → Browser Bluetooth: requests device
src/lib/bluetooth/bluetooth.ts - GAN protocol v1 → Bluetooth GATT: reads characteristics
src/lib/bluetooth/gan/gan356i_v1.ts - GAN protocol v2 → Bluetooth GATT: reads characteristics
src/lib/bluetooth/gan/gan356i_v2.ts - GAN protocol v2 → GAN protocol v1: reuses protocol code
src/lib/bluetooth/gan/gan356i_v2.ts