README.md

# 3×3 Rubik's‑Style Color Password System (Gradio)

A Hugging Face Spaces‑ready simulator. Click tiles to cycle colors in this strict order:

**Red → Yellow → Green → Blue → White → Orange → (repeat)**

Each of the 6 sides has a fixed center color (its "middle"). You can save a custom code (the full 3×3 pattern) per side, shuffle tiles, and try to unlock by recreating the saved pattern.

## Files
- `app.py` – the Gradio app.
- `requirements.txt` – dependencies.

## How to deploy on Hugging Face
1. Go to **Hugging Face → New Space → Static: Gradio** (Python).
2. Give it a name, keep defaults.
3. Upload both files (`app.py` and `requirements.txt`) to the Space.
4. Wait for it to build. When it’s ready, open the Space.

## How to use
1. Pick a **Side**. Its center tile is locked to the stated middle color.
2. Click **🔀 Randomize** to shuffle the 8 non-center tiles.
3. Arrange tiles by **clicking them** (each click cycles the color).
4. Press **💾 Set Code** to save the current pattern for this side.
5. Shuffle again and try to reproduce the code; hit **🔓 Unlock** to check.
6. Use **Show Code Preview** if you want a small peek at the saved code.
7. **♻️ Reset Side** or **🧹 Reset All** if needed.

Enjoy!