A Rust desktop math practice tool focused on fast arithmetic drills.
This repository is a compact Rust project. It is useful for understanding how a Cargo application is structured and how terminal-based practice tools can be built.
- Using Cargo to manage a Rust binary project.
- Keeping application logic in
src/main.rsfor a small command-line tool. - Building and running a fast local utility from source.
| Path | Purpose |
|---|---|
Cargo.toml |
Rust package metadata and dependency configuration. |
Cargo.lock |
Resolved dependency versions for reproducible builds. |
src/main.rs |
Application entry point, UI state, scoring, timer logic, and problem generation. |
docs/ARCHITECTURE.md: runtime state, UI flow, and extension points.docs/GAMEPLAY.md: scoring, timer, difficulty, and problem-generation rules.CONTRIBUTING.md: setup and improvement guidance.
cargo run
cargo build --releaseRead src/main.rs first. If the project grows, the next documentation step is to split input handling, scoring, and drill generation into separate modules.
This README is the first cleanup pass. The next documentation pass should add:
- A fuller problem statement or assignment prompt.
- Setup notes for required tools, environment variables, or services.
- Example input and output.
- Screenshots, diagrams, or architecture notes where they clarify the project.
- Testing instructions and known limitations.
This repository has been renamed and labeled as part of a GitHub organization cleanup. The goal is to make the project understandable to future readers, reviewers, and collaborators.