# Rubik's Trainer

> CFOP practice for sub-20 solvers. A self-hosted CFOP practice tool: an algorithm library of 119 cases, self-assessment, spaced drills, a solve timer with per-phase splits, and a 3D viewer that animates any algorithm.

CFOP is the four-step speedcubing method — Cross, F2L, OLL, PLL. Each case below is one situation you learn to recognise, with the move sequence that solves it in Singmaster notation (`R` = right face clockwise, `R'` = anticlockwise, `R2` = half turn).

## Algorithm library

- [F2L](https://rubik-x2dwe.corp.smalometern.com/library/f2l): 41 cases, each with its algorithms, a setup scramble and an animated solve.
- [OLL](https://rubik-x2dwe.corp.smalometern.com/library/oll): 57 cases, each with its algorithms, a setup scramble and an animated solve.
- [PLL](https://rubik-x2dwe.corp.smalometern.com/library/pll): 21 cases, each with its algorithms, a setup scramble and an animated solve.
- [All phases](https://rubik-x2dwe.corp.smalometern.com/library/): the library index, with progress and search across every case.

Every case has its own page at `/library/case/<key>` — for example [Sune](https://rubik-x2dwe.corp.smalometern.com/library/case/oll-27) at `oll-27`. The page carries the algorithm, alternatives, a setup scramble and structured data describing both.

## Documentation

- [Documentation home](https://rubik-x2dwe.corp.smalometern.com/docs/): what the app does and how to run it.
- [Using the trainer](https://rubik-x2dwe.corp.smalometern.com/docs/user/index): The five-minute tour, the algorithm library, assessments, drills, plans, the timer and the 3D viewer.
- [Administration](https://rubik-x2dwe.corp.smalometern.com/docs/admin/index): Profiles, resetting student data, backups, re-importing the algorithm library and every configuration key.
- [Installation](https://rubik-x2dwe.corp.smalometern.com/docs/install/index): Requirements, `docker compose up`, the first run, upgrading and what to do when something breaks.
- [Developer](https://rubik-x2dwe.corp.smalometern.com/docs/developer/index): Architecture, the data model, the cube engine, the frontend, the JSON API, testing and contributing.

## Optional

- [JSON API](https://rubik-x2dwe.corp.smalometern.com/docs/api): every route, with a try-it console. Read-only endpoints under `/api/v1` return cases, groups and scrambles.

## Not included

The dashboard, profiles, drill sessions and timer results are one person's practice history rather than reference material, and are excluded from this file, from the sitemap and from robots.txt.