The Problem
Nobody likes being the new person on a project and staring at a mountain of files with zero clue who’s responsible for what or where the action is happening. Or worse, you’ve been here a while, but you want to refactor something and have no idea who to yell at when it breaks. Git blame only gets you so far, and looking through commit history is a soul-sucking chore. If only there were a way to visualize contributions and the history of a repo instead of just scrolling through walls of text…
What This Does
Enter git-truck, the visualization tool you didn’t know you needed. It’s a slick, private-by-design app that slaps a coat of paint on your git repo's data, making it digestible for humans (not just commit log-reading robots). Want to know which files are hotspots for activity? Run npx -y git-truck, and you’ll get a browser-based UI that shows you where the action is happening. Curious about who’s been mucking around in a specific folder? The app can break down contributions by user, so you know who to thank (or, more realistically, blame).
Under the hood, the project is a mix of TypeScript and React, with src/components housing all the reusable UI bits like CommitHistory.tsx and BarChart.tsx. It’s powered by Vite for speedy builds and uses Playwright for end-to-end testing (check e2e/features/ for the tests). The backend logic lives in files like src/analyzer/git-caller.server.ts, which handles extracting contribution data from your local git repo. Everything runs locally—no cloud, no tracking, no nonsense.
Real-World Use
Let’s say you just joined a team working on a sprawling monorepo. Run git truck from the root directory. Within seconds, it opens in your browser, showing a breakdown of folders and contributions over time. You hover over the src/components folder and see that "Alice" has been doing all the heavy lifting there—good to know who to ping when your button component explodes. You also notice a bunch of commits from "Bob" in scripts/ last week—looks like he’s been tweaking build tools, so maybe give him a heads-up before you mess with the pipeline.
The Bottom Line
git-truck is a no-BS tool for developers who want to make sense of their repos without digging through endless logs. It’s perfect for onboarding, code audits, or prepping refactors. That said, it’s probably overkill for tiny projects or repos with one developer. But if you’re dealing with a large team or a legacy codebase and you’re tired of playing git detective, this thing is a lifesaver. Just don’t forget to install Node.js 22+ first—because yes, it’s picky.