Paste a repo URL. Get an interactive timeline, contributor map, and milestone journey — instantly.
Try it now → · Compare Repos · GitHub Wrapped · Report Bug
Every repository has a story — the first commit, the early contributors, the milestones, the growth. Commit Story makes it visible.
Enter any public GitHub repo URL and get a complete visual overview: how active is the project, who drives it, when did it peak, and how does it compare to others.
📊 Repository Story — Stats at a glance: total commits, contributors, project age, weekly commit average, most active day, top author.
📈 Commit Activity Heatmap — GitHub-style contribution grid showing the last 52 weeks of activity, powered by the GitHub Statistics API.
🕐 Interactive Timeline — Visual timeline of the latest 100 commits with milestone markers (first commit, version tags, 100th commit milestone).
⚔️ Compare Repos — Put two repositories side by side. See which one has more commits, more contributors, higher weekly velocity. Winner badge included.
🎁 GitHub Wrapped — Enter any username and see their profile summary: top repos by stars, most-used languages, total stars, member since date.
📅 Year in Review — Annual commit breakdown with a monthly bar chart. See which month was the busiest and how many contributors were active.
📛 README Badge — Drop a live badge into your project's README with one click. Three styles: Flat, Square, For the Badge.
🔗 Embeddable Widget — A compact card widget you can iframe into any page or blog post.
🌙 Dark Mode — Toggle between light and dark themes. Light mode is the default.
🔍 Category Filters — Filter commits by type: feat, fix, docs, chore, perf.
📤 Share Buttons — One-click share to X/Twitter, LinkedIn, Reddit, or copy the link.
| Page | Link |
|---|---|
| Story — vercel/next.js | commitstory.dev/story/vercel/next.js |
| Story — facebook/react | commitstory.dev/story/facebook/react |
| Compare — Next.js vs React | commitstory.dev/compare?repo1=vercel/next.js&repo2=facebook/react |
| Wrapped — Linus Torvalds | commitstory.dev/wrapped/torvalds |
| Year in Review — Next.js 2025 | commitstory.dev/story/vercel/next.js/2025 |
| Trending | commitstory.dev/trending |
Show off your project's commit stats:
[](https://commitstory.dev/story/YOUR_OWNER/YOUR_REPO)Example:
Three styles available: flat (default), square, for-the-badge.
All endpoints are public and free to use.
GET /api/story/:owner/:repo → Repository story as JSON
GET /api/badge/:owner/:repo → SVG badge (query: ?style=flat|square|for-the-badge)
GET /api/og/:owner/:repo → OG image (1200×630)
| Layer | Technology |
|---|---|
| Framework | Next.js 15 — App Router, Server Components |
| Language | TypeScript |
| Styling | Tailwind CSS |
| Data | GitHub REST API via Octokit |
| Heatmap | GitHub Statistics API |
| Theme | next-themes |
| Hosting | Vercel |
- Node.js 18+
- A GitHub Personal Access Token (for higher API rate limits)
git clone https://github.com/scuton-technology/commit-story.git
cd commit-story
npm installcp .env.example .env.localEdit .env.local and add your GitHub token:
GITHUB_TOKEN=ghp_your_token_here
npm run devOpen http://localhost:3000 and paste any repo URL.
docker compose up -dThe app runs on port 3000. Set GITHUB_TOKEN as an environment variable.
commit-story/
├── src/
│ ├── app/ # Next.js App Router pages
│ │ ├── story/ # Repository story page
│ │ ├── compare/ # Compare two repos
│ │ ├── trending/ # Trending repositories
│ │ ├── wrapped/ # GitHub user wrapped
│ │ └── api/ # Badge, OG image, story endpoints
│ ├── components/ # React components
│ └── lib/ # GitHub API client, utilities
├── public/ # Static assets
├── Dockerfile # Docker support
├── docker-compose.yml # Docker Compose
└── next.config.ts # Next.js configuration
Contributions are welcome. Please read CONTRIBUTING.md before opening a PR.
- Fork the repo
- Create your branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'feat: add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
MIT — see LICENSE for details.
Built by Scuton Technology