Skip to content

RepoRewind v0.1.0

Choose a tag to compare

@OthmaneBlial OthmaneBlial released this 21 Aug 13:19
· 26 commits to main since this release

RepoRewind turns a local Git history into a living city that can be replayed, searched, compared, and exported as a film.

Highlights

  • Local-first Git analyzer with a portable, bounded schema v1 archive and no source-content collection.
  • Stable 3D city geography for files, districts, contributors, releases, refactors, and deleted-code ruins.
  • Keyboard-first archive search, building inspection, timeline landmarks, and rename-aware temporal comparison.
  • Browser-native 1080p/4K MP4 or WebM export with deterministic frame timing, cancellation, and runtime capability probing.
  • Responsive archival-daylight interface with reduced-motion behavior, focus handling, WebGL fallback, and clear fictional-demo labeling.
  • No backend, accounts, analytics, telemetry, cookies, remote ingestion, environment variables, or API credentials.

Quick start

git clone https://github.com/OthmaneBlial/RepoRewind.git
cd RepoRewind
npm ci
npm run dev

Node.js 24 is recommended; Node.js 22.13+ is supported. Run npm run analyze -- /path/to/repository --output ./reporewind-history.json, then import the resulting archive in the browser.

Trust and compatibility boundaries

RepoRewind analyzes Git metadata, paths, refs, messages, and numeric diffs locally; it does not include source contents. Generated archives can still contain sensitive names, paths, messages, and sanitized remotes, so review them before sharing. Browser imports stay in memory and disappear on reload.

MP4 requires a current secure-context browser with H.264 WebCodecs support. WebM remains the compatibility path. Timeline semantics are deterministic, but hardware encoders are not expected to produce byte-identical files.

Validation

The release commit passed formatting, strict linting, documentation and runtime-license checks, 41 tests across 13 files, TypeScript validation, web and CLI production builds, and a high-severity dependency audit with zero vulnerabilities. GitHub Actions also passed the exact commit on Node 24/Linux, Node 22/Linux, Node 24/macOS, and Node 24/Windows.

This is a source release. No npm or GitHub Package was published because the package is intentionally private.