Rubik's Cube Simulation

A modern, interactive 3D Rubik's Cube simulator supporting 3x3x3 up to 7x7x7 cubes, built with Three.js and Tailwind CSS. Scramble and solve cubes of various sizes with smooth animations and a clean UI.

Features

• 3D Visualization: Realistic Rubik's Cube rendered in 3D using Three.js.
• Multiple Sizes: Supports 3x3x3, 4x4x4, 5x5x5, 6x6x6, and 7x7x7 cubes.
• Scramble & Solve: One-click scramble and auto-solve (reverse scramble) for any cube size.
• Move Notation Display: See each move in standard notation as the cube is scrambled or solved.
• Responsive UI: Clean, modern interface styled with Tailwind CSS.
• No Backend Required: All logic runs in the browser; no server or environment variables needed.

Getting Started

Prerequisites

• A modern web browser (Chrome, Firefox, Edge, Safari, etc.)

Running the Simulation

1. Download or Clone the Repository:

   git clone <your-repo-url>
   cd <repo-directory>
   

2. Open the App:
   • Simply open rubiks_cube.html in your web browser.
   • No build step or server required.

File Structure

• rubiks_cube.html — Main HTML file containing all JavaScript, CSS, and UI logic.

Technology Stack

• Three.js — 3D rendering
• Tailwind CSS — UI styling
• TWEEN.js — Smooth animations

Usage

• Select Cube Size: Use the dropdown in the top bar to choose the cube size (3x3x3 to 7x7x7).
• Scramble: Click the "Scramble" button to randomize the cube.
• Solve: Click the "Solve" button to reverse the scramble and restore the cube.
• View Moves: The right panel displays each move in standard notation as it happens.
• Rotate/Zoom: Drag to rotate the view, scroll to zoom in/out.

Customization

• All logic is in rubiks_cube.html. You can edit this file to tweak visuals, controls, or add new features.

Security & Environment

• No environment variables or secrets are required.
• No backend or API keys are used.
• No installation or dependencies beyond a web browser.

License

MIT License. See LICENSE if present.