uhryniuk
280fd7f988
Two copies for two jobs. rippr-src/ is a browsable git archive export of the tracked tree at 2f76983 - no build outputs, no local.properties, no nested .git - which is convenient to read in gitea but carries no history and will drift. rippr-full-history.bundle is the real backup: all 18 commits, verified as "records a complete history" and test-cloned before committing. This matters because ~/dojo/rippr has no git remote and otherwise exists only on one machine. rippr-src/SNAPSHOT.md explains the difference and how to restore. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
45 lines
1.5 KiB
Markdown
45 lines
1.5 KiB
Markdown
# 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
|