{"name":"Warpchart: Live GitHub Repository Growth Telemetry and Star Ranking","description":"Warpchart offers a unique, live growth telemetry dashboard for any GitHub repository. It provides a dynamic star chart, tracking your repo's journey through the worldwide ranking with real-time updates and even sound. This tool transforms raw star data into actionable insights, helping maintainers understand their project's visibility and growth.","github":"https://github.com/santifer/warpchart","url":"https://osrepos.com/repo/santifer-warpchart","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/santifer-warpchart","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/santifer-warpchart.md","json":"https://osrepos.com/repo/santifer-warpchart.json","topics":["GitHub","Telemetry","Analytics","TypeScript","Dashboard","Star History","Next.js","Open Source"],"keywords":["GitHub","Telemetry","Analytics","TypeScript","Dashboard","Star History","Next.js","Open Source"],"stars":null,"summary":"Warpchart offers a unique, live growth telemetry dashboard for any GitHub repository. It provides a dynamic star chart, tracking your repo's journey through the worldwide ranking with real-time updates and even sound. This tool transforms raw star data into actionable insights, helping maintainers understand their project's visibility and growth.","content":"## Introduction\n\nWarpchart is an innovative open-source tool designed to provide live growth telemetry for any GitHub repository. It transforms raw star data into a dynamic, interactive star chart, visualizing your repository's journey through the worldwide ranking, complete with real-time updates and an optional soundscape. While GitHub offers basic star data, Warpchart provides a comprehensive \"flight console\" to monitor your project's visibility and growth in unprecedented detail.\n\nIt addresses the limitations of static star history charts and opaque trending lists by offering a clear view of your repository's position, velocity, and surrounding projects in the global ranking. With features like a live status bar, an interactive star chart, and \"scan cards\" for neighboring repos, Warpchart empowers maintainers with deep insights into their project's trajectory.\n\n[![Warpchart Screenshot](https://github.com/user-attachments/assets/1b04b08e-7154-4123-a1a5-184227882cf8)](https://warpchart.dev \"Warpchart Live Demo\" target=\"_blank\")\n\nExplore the live demo tracking [career-ops](https://github.com/santifer/career-ops \"career-ops GitHub Repository\" target=\"_blank\") or instantly scan any repository by visiting [warpchart.dev/r/owner/name](https://warpchart.dev/r/tinygrad/tinygrad \"Scan tinygrad on Warpchart\" target=\"_blank\").\n\n## Why Use Warpchart?\n\nWarpchart goes beyond basic star counts, offering a rich set of features that provide actionable insights into your repository's growth:\n\n*   **Real-time Telemetry**: Get live updates on stars, worldwide rank, velocity, and estimated time to reach the next milestone.\n*   **Interactive Star Chart**: Visualize your repository's position relative to others in a two-band space map, showing ranking neighbors and potential overtake targets.\n*   **Spike Forensics**: Automatically correlate star spikes with Hacker News posts, Reddit discussions, and your releases, helping you understand what drives growth.\n*   **Unique Soundscape**: Experience a fully synthesized Web Audio soundscape where each new star is a sonar ping, and milestone crossings play a quiet fanfare.\n*   **Comprehensive Data**: Access velocity metrics, daily ladders, cumulative charts, heatmaps, and rank over time, providing a full instrument panel for growth analysis.\n*   **Shareable Insights**: Easily embed badges and animated charts into your READMEs, and share dynamic Open Graph cards with live stats.\n*   **Developer-Friendly**: Access all telemetry via a public, free, and cache-only REST API, an MCP server, and a powerful CLI.\n\nWarpchart provides the cockpit GitHub doesn't, allowing you to truly understand and react to your project's journey in the open-source world.\n\n## Installation and Setup\n\nSetting up Warpchart for your repository is designed to be quick and straightforward, taking just about five minutes:\n\n1.  **Use as a Template**: Start by using the Warpchart repository as a template for your new project.\n2.  **Configure `mission.config.json`**: Edit the `mission.config.json` file to specify your repository's `owner/name` and an accent color.\n    \n    { \"repo\": \"owner/name\", \"accent\": \"cyan\" }\n    \n3.  **Run Bootstrap**: Navigate to the \"Actions\" tab in your GitHub repository and run the `bootstrap` workflow. Alternatively, you can run it locally:\n    bash\n    GH_TOKEN=$(gh auth token) node collector/bootstrap.mjs\n    \n    After running locally, commit the `data/` directory.\n4.  **Deploy to Vercel**: Import your repository into Vercel. Add a `GITHUB_TOKEN` environment variable, which should be a fine-grained Personal Access Token (PAT) with read-only access to public repositories.\n5.  **Done**: The hourly `collect` workflow will automatically maintain your repository's history and trigger redeployments on Vercel.\n\nFor local development, simply run:\n\nbash\nnpm install\nGITHUB_TOKEN=$(gh auth token) npm run dev\n\n\n## Examples\n\nWarpchart provides multiple ways to access its powerful telemetry, catering to developers, agents, and maintainers alike.\n\n### CLI Usage\n\nThe command-line interface offers quick access to key metrics:\n\nbash\nnpx warpchart vuejs/core              # rank, velocity, a braille star chart + who's hunting it\nnpx warpchart hunters d3/d3           # who's about to pass it (and who it's about to pass)\nnpx warpchart top 20 --lang Rust      # the biggest repos, optionally by language\nnpx warpchart velocity --lang Go      # the fastest-growing repos right now\nnpx warpchart compare react/react vuejs/core\nnpx warpchart embed OWNER/NAME        # a README embed snippet\nnpx warpchart vuejs/core --json       # raw JSON (agent friendly)\n\n\n### REST API\n\nAccess telemetry programmatically via the public, cache-only REST API at `/api/v1`:\n\nbash\ncurl \"https://warpchart.dev/api/v1/repo?repo=vuejs/core\"          # rank, velocity, neighbours, next gate\ncurl \"https://warpchart.dev/api/v1/leaderboard?language=Rust\"     # biggest repos, optionally by language\ncurl \"https://warpchart.dev/api/v1/velocity?limit=20&language=Go\" # fastest movers, optionally by language\ncurl \"https://warpchart.dev/api/v1/overtakes?repo=d3/d3\"          # who is hunting a repo (and who it's about to pass)\ncurl \"https://warpchart.dev/api/v1/compare?repos=vuejs/core,react/react\"\ncurl \"https://warpchart.dev/api/v1/embed?repo=OWNER/NAME\"         # README embed snippet\n\nThe `GET /api/v1` endpoint provides a self-documenting index.\n\n### Embeddable Assets\n\nEasily share your repository's growth with dynamic badges and animated charts:\n\n#### Embeddable Badge (SVG)\n\nmarkdown\n[![World rank](https://warpchart.dev/api/badge?repo=OWNER/NAME)](https://warpchart.dev/r/OWNER/NAME)\n\n\n#### Embeddable Animated Chart (SVG)\n\nhtml\n<a href=\"https://warpchart.dev/r/OWNER/NAME\" target=\"_blank\">\n  <picture>\n    <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://warpchart.dev/api/chart?repo=OWNER/NAME&theme=dark\">\n    <img alt=\"Live star telemetry\" src=\"https://warpchart.dev/api/chart?repo=OWNER/NAME&theme=light\" loading=\"lazy\">\n  </picture>\n</a>\n\n\n## Links\n\n*   **GitHub Repository**: [santifer/warpchart](https://github.com/santifer/warpchart \"Warpchart GitHub Repository\" target=\"_blank\")\n*   **Live Demo**: [warpchart.dev](https://warpchart.dev \"Warpchart Live Demo\" target=\"_blank\")\n*   **License**: [MIT License](https://github.com/santifer/warpchart/blob/main/LICENSE \"MIT License\" target=\"_blank\")","metrics":{"detailViews":2,"githubClicks":1},"dates":{"published":null,"modified":"2026-06-14T00:17:09.000Z"}}