samplez/RIPPR.md

Rippr — copies held here

Rippr is a native Android GPS ride recorder for motorcycles. Its canonical repo is ~/dojo/rippr, which has no git remote — it exists only on that machine, so the bundle below is the only off-machine copy of its history.

Snapshot taken at: d418920 — "v3: add waypoint route planning; record that handlebar mounting changes the premise" (21 commits)

What is here

File	Purpose
rippr-src/	Browsable source, exported with git archive HEAD. No history; will drift.
rippr-full-history.bundle	Full git history. The actual backup.
rippr-2.0.1-debug.apk	Latest installable build (debug-signed)
rippr-2.0-debug.apk, rippr-1.0-debug.apk	Previous builds

rippr-src/ contains tracked files only — no build outputs, no local.properties, no nested .git.

Restoring the full repo

git clone rippr-full-history.bundle rippr
cd rippr
echo "sdk.dir=$HOME/Library/Android/sdk" > local.properties
./gradlew assembleDebug

Needs JDK 17–21 — AGP does not support 25 — and the Android SDK with platform 35 and build-tools 35.

Where to start reading

Inside rippr-src/:

• README.md — what the app is and its current state
• docs/ARCHITECTURE.md — the design decisions and why
• docs/v3/BACKLOG.md — known gaps, deferred work, what must not regress
• docs/TESTING.md — especially "What the emulator cannot verify"
• docs/v2/PROGRESS.md — every bug found during v2 development

Keeping these current

cd ~/dojo/samplez
rm -rf rippr-src && mkdir rippr-src
git -C ~/dojo/rippr archive HEAD | tar -x -C rippr-src
(cd ~/dojo/rippr && git bundle create /tmp/rb.bundle --all) && mv /tmp/rb.bundle rippr-full-history.bundle
git bundle verify rippr-full-history.bundle

Note the export wipes rippr-src/ wholesale, which is why this file lives at the repo root rather than inside it.