brkrs 0.0.1

Breakout/Arkanoid-style game built in Rust using the Bevy engine, with physics powered by bevy_rapier3d
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

# brkrs Development Guidelines

Auto-generated from all feature plans. Last updated: 2025-11-24

## Active Technologies

- Rust 1.81 (Rust 2021 edition) + Bevy 0.17, bevy_rapier3d (physics/collision) (005-multi-hit-bricks)
- RON level files (existing format supports indices 10-13) (005-multi-hit-bricks)
- Rust 1.81 (Rust 2021 edition) + Bevy 0.17 (AudioPlugin, AudioSource, observers), bevy_rapier3d (006-audio-system)
- RON configuration file for audio settings persistence (006-audio-system)
- Rust 1.81 (project), Python 3.11 for docs toolchain + Sphinx, MyST-Parser, furo-theme, sphinx-rtd-theme-compat (if needed), `cargo doc` for rustdoc generation (001-sphinx-docs)
- N/A — documentation stored in repo under `/docs/` and `specs/` for plans (001-sphinx-docs)
- Rust 1.81 (Rust 2021 edition via rustup) + Bevy 0.17 (ECS, input handling, window management, Time, rendering), bevy_rapier3d (physics simulation control)

## Project Structure

```text
src/
tests/
docs/
assets/
```

## Commands

run these commands to verify your work:

- `cargo test`
- `cargo fmt --all`
- `cargo clippy --all-targets --all-features`
- `bevy lint`

## Code Style

Rust 2021 edition (toolchain managed by rustup): Follow standard conventions

## Recent Changes

- 006-audio-system: Added Rust 1.81 (Rust 2021 edition) + Bevy 0.17 (AudioPlugin, AudioSource, observers), bevy_rapier3d
- 005-multi-hit-bricks: Added Rust 1.81 (Rust 2021 edition) + Bevy 0.17, bevy_rapier3d (physics/collision)
- 001-sphinx-docs: Added Rust 1.81 (project), Python 3.11 for docs toolchain + Sphinx, MyST-Parser, furo-theme, sphinx-rtd-theme-compat (if needed), `cargo doc` for rustdoc generation

<!-- MANUAL ADDITIONS START -->
<!-- MANUAL ADDITIONS END -->