Grzegorz Kucmierz 281614502e
Some checks failed
Deploy to Production / deploy (push) Failing after 9s
style: use default toastify css look for solver notifications
2026-02-24 00:03:24 +00:00
2026-02-22 19:49:32 +00:00

Rubik's Cube Logic Engine & Simulator

Cube Preview

Overview

This application is a 3D animated, Interactive Rubik's Cube simulator and mathematical solver built from scratch using Vue.js. It aims to provide seamless mechanical interactions and mathematically perfectly rigorous tracking of a classic 3x3 Rubik's Cube state.

The software operates entirely in the browser using a custom Group Theory mathematical engine (DeepCube.js), which separates the heavy analytical permutation tracking from the 3D CSS visual layer using Web Workers.

Features

  • Mechanical Realism: 3D CSS rendering precisely models physical cube mechanics. Dragging edge and corner pieces rotates the specific mechanical layer dynamically, while dragging the center elements pivots the entire camera view.
  • Reactive Algorithm Queue: Execute complex algorithms fluidly. The dynamic queue evaluates incoming inputs and instantly intercepts redundances (e.g. evaluating U U into a single U2 animation, or cancelling out F into F' on the fly).
  • Deep Mathematical Engine: Based entirely on Group Theory. It stores corner and edge permutation arrays combined with spatial orientation parities to guarantee that only physically legal mechanical states exist or can be scrambled.
  • Intelligent Solvers:
    • Beginner Method (Human): Constructs the solution layer-by-layer simulating human heuristics natively with instantaneous O(1) algorithmic macros.
    • Kociemba's Algorithm (Optimal): Offloads pruning tables and recursive heuristic searches to Web Workers to instantly calculate and stream back the objectively shortest path solution (typically <20 moves).
  • High Performance: Decoupling the single-threaded UI rendering stack from mathematical validations ensures 60 FPS 3D animations, even while executing computationally expensive analytical algorithms in the background.
Description
No description provided
Readme 14 MiB
Languages
JavaScript 57.4%
Vue 37.6%
CSS 3.6%
HTML 0.8%
Dockerfile 0.6%