How dimizorgon/cube works
Cube Studio is a multilingual web platform for interactive cube simulation, speedcubing practice, method guides, and Bluetooth smart-cube analysis. Users enter through the site routes, choose a puzzle or tool, then manipulate a rendered cube, follow a guide, time a solve, or connect a smart cube. The cube store separates logical move validation from animated state; the smart-cube store coordinates device events and solve tracking. README capabilities are included where source excerpts are unavailable; those links are documented rather than inferred from folder names.
Main entry points: router.jsx Route table · useSmartCubeStore.js Smart-cube session · RubiksCube.jsx 3D cube renderer · MethodeBlind3x3.jsx Method guides
Components 27
Navigation and language
- Application entry
src/App.jsx - Route table
src/router.jsx - Route configuration
src/routes/routeConfig.js - French and English
src/i18n/en.js
Cube simulation
- Puzzle game
src/components/CubeGame.jsx - 3D cube renderer
src/components/RubiksCube.jsx - Cubie geometry
src/components/Cubie.jsx - Cube state
src/store/useCubeStore.js - Cube geometry math
src/utils/cubeMath.js
Learning guides
- Method guides
src/components/algos/MethodeBlind3x3.jsx - Method case data
src/data/blind3x3Data.js - Algorithm viewer
src/components/algos/AlgoDemoModal.jsx - Algorithm parser
src/utils/algoParser.js
Timing and settings
- Settings screen
src/components/SettingsPage.jsx - Persistent settings
src/store/useSettingsStore.js - Speed timer
src/components/SpeedTimer.jsx - Scramble generator
src/utils/scrambleGenerator.js - Solve records
src/utils/timerUtils.js
Smart cube
- Smart-cube screen
src/pages/SmartCubePage.jsx - Smart-cube session
src/store/useSmartCubeStore.js - Bluetooth driver
src/utils/smartCube/ganBleDriver.js - GAN protocol
src/utils/smartCube/ganProtocol.js - Block cipher
src/utils/smartCube/aesBlockCipher.js - Device address
src/utils/smartCube/macAddressUtils.js - Solve phase detector
src/utils/smartCube/solvePhaseDetector.js - WCA statistics
src/utils/smartCube/wcaStats.js
Other components
- Cube user
Connections 29
- Cube user → Application entry: opens
- Application entry → Route table: renders routes
src/App.jsx - Route table → Route configuration: resolves paths
src/router.jsx - Route table → Puzzle game: routes to
src/router.jsx - Route table → Smart-cube screen: routes to
src/router.jsx - Route table → Speed timer: routes to
- Route table → Settings screen: routes to
- Puzzle game → 3D cube renderer: renders
- 3D cube renderer → Cubie geometry: renders
src/components/RubiksCube.jsx - 3D cube renderer → Cube state: reads and updates
src/components/RubiksCube.jsx - Cube state → Cube geometry math: computes rotations
src/store/useCubeStore.js - Settings screen → Persistent settings: updates settings
src/components/SettingsPage.jsx - 3D cube renderer → Persistent settings: reads preferences
src/components/RubiksCube.jsx - Speed timer → Scramble generator: generates scrambles
src/components/SpeedTimer.jsx - Speed timer → Solve records: uses timing utilities
src/components/SpeedTimer.jsx - Cube user → Method guides: studies methods
- Method guides → Method case data: loads cases
src/components/algos/MethodeBlind3x3.jsx - Method guides → Algorithm viewer: opens demonstrations
src/components/algos/MethodeBlind3x3.jsx - Algorithm viewer → Algorithm parser: parses algorithms
src/components/algos/AlgoDemoModal.jsx - Smart-cube screen → Smart-cube session: controls session
src/pages/SmartCubePage.jsx - Smart-cube screen → 3D cube renderer: renders live cube
src/pages/SmartCubePage.jsx - Smart-cube session → Bluetooth driver: dispatches device actions
src/store/useSmartCubeStore.js - Smart-cube session → Device address: loads cached address
src/store/useSmartCubeStore.js - Bluetooth driver → GAN protocol: uses protocol
src/utils/smartCube/ganBleDriver.js - GAN protocol → Block cipher: uses encryption
src/utils/smartCube/ganProtocol.js - Smart-cube session → Solve phase detector: tracks solve phases
src/store/useSmartCubeStore.js - Smart-cube session → WCA statistics: computes session stats
src/store/useSmartCubeStore.js - Route table → French and English: configures languages
- Method guides → French and English: localizes guide data
src/components/algos/MethodeBlind3x3.jsx