Goal for this part
Search for a byte sequence.
Treat 10-Search as the source of truth for this checkpoint. If your local tree drifted, re-clone that folder rather than mixing files from neighbors.
What you should already know
You do not need prior egui experience for part 1. Later parts assume you finished the earlier snapshots on the same machine.
- A Rust toolchain (
cargo) is installed - You have a desktop session for the egui/gtk window
Why egui fits Bytequarry
egui is an immediate-mode GUI in pure Rust. A hex editor is a focused way to teach binary buffers and selection without a webview.
Draw offset, hex, and ASCII columns in a scrollable grid. Keep the byte buffer behind a small document struct.
After you run the snapshot, you should recognize the behavior described in the goal—before you move on. If the window (or server) never appears, stop and fix the run steps.
Code shape
Snapshots stay small on purpose. Look for this kind of core call as you read the folder:
buffer[offset] = value;How to run it
Clone the teaching repo, open 10-Search, install what the README asks for, then run cargo run.
git clone https://github.com/michaeldunga1/fcc-egui-hex.git
cd fcc-egui-hex/10-Search
cargo build
cargo runCommon mistakes
- Ignoring platform-specific install notes in the snapshot README
- Case-sensitive filters that surprise users
- Filtering the wrong collection (all rows vs current folder)
- Clearing the query box without restoring the full list