# Rippr — source snapshot

Point-in-time export of the Rippr working tree, exported with `git archive HEAD`
(tracked files only — no build outputs, no `local.properties`, no nested `.git`).

**Commit:** `2f76983` — "Fix live readout and blank map, both found on the first real ride"

## Two copies live here, for different jobs

| File | Purpose |
|---|---|
| `rippr-src/` | Browsable source. No history — a snapshot that will drift. |
| `rippr-full-history.bundle` | Full git history (18 commits). The real backup. |

The canonical repo is `~/dojo/rippr`, which **has no git remote** — it exists only on that
machine. The bundle is therefore the only off-machine copy of the history.

## Restoring from the bundle

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

Verified: the bundle reports "records a complete history" and clones cleanly to all 18
commits.

## Building

Needs JDK 17–21 (AGP does not support 25) and the Android SDK with platform 35 and
build-tools 35. See `docs/v2/01-baseline.md`.

```bash
./gradlew assembleDebug testDebugUnitTest lintDebug   # 84 unit tests
./gradlew connectedDebugAndroidTest                   # 46, needs a device
```

## Where to start reading

- `docs/v2/README.md` — task index and architecture decisions
- `docs/v2/PROGRESS.md` — per-task outcomes, bugs found, and known gaps
- `app/src/main/java/com/rippr/TrackingService.kt` — the recording pipeline