{"id":50874277,"url":"https://github.com/april-jk/stoke-your-code","last_synced_at":"2026-06-15T08:04:17.033Z","repository":{"id":361499132,"uuid":"1254684764","full_name":"april-jk/stoke-your-code","owner":"april-jk","description":"Trading-terminal style Git history viewer that turns repository activity into candlestick charts and volume bars.","archived":false,"fork":false,"pushed_at":"2026-05-30T22:42:09.000Z","size":1433,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"feature/local-clone-analysis","last_synced_at":"2026-05-31T00:12:14.471Z","etag":null,"topics":["analytics","candlestick-chart","data-visualization","developer-tools","git-history","git-visualization","github","lightweight-charts","react","typescript"],"latest_commit_sha":null,"homepage":"https://april-jk.github.io/stoke-your-code/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/april-jk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-30T22:04:20.000Z","updated_at":"2026-05-30T22:42:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/april-jk/stoke-your-code","commit_stats":null,"previous_names":["april-jk/stoke-your-code"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/april-jk/stoke-your-code","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/april-jk%2Fstoke-your-code","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/april-jk%2Fstoke-your-code/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/april-jk%2Fstoke-your-code/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/april-jk%2Fstoke-your-code/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/april-jk","download_url":"https://codeload.github.com/april-jk/stoke-your-code/tar.gz/refs/heads/feature/local-clone-analysis","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/april-jk%2Fstoke-your-code/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34353197,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-15T02:00:07.085Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["analytics","candlestick-chart","data-visualization","developer-tools","git-history","git-visualization","github","lightweight-charts","react","typescript"],"created_at":"2026-06-15T08:04:16.240Z","updated_at":"2026-06-15T08:04:17.022Z","avatar_url":"https://github.com/april-jk.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Stoke Your Code\n\n[中文说明](./README.zh-CN.md)\n\nStoke Your Code is a trading-terminal style Git history viewer. It turns repository movement into OHLC candles and volume bars so you can read a codebase like a market chart.\n\nLive project page: [https://april-jk.github.io/stoke-your-code/](https://april-jk.github.io/stoke-your-code/)\n\nThe project supports:\n- Local Git repositories\n- GitHub repositories\n- Branch selection for both local and GitHub sources\n- Multi-timeframe chart aggregation: `5M`, `1H`, `1D`, `1W`, `1M`\n\n## Screenshots\n\n### Landing page\n\n![Landing page preview](./docs-src/screenshots/landing-page.png)\n\n### Analysis terminal\n\n![Analysis page preview](./docs-src/screenshots/analysis-page.png)\n\n## What It Does\n\nInstead of browsing commit lists, Stoke Your Code translates repository history into a visual tape:\n\n- `Open / Close`: codebase LOC before and after movement\n- `High / Low`: intraperiod extremes during commit activity\n- `Volume`: added + deleted lines\n- `Timeframes`: aggregate the same commit event stream into multiple chart intervals\n\nThe goal is not to mimic finance superficially, but to make software history legible at a glance.\n\n## Features\n\n- Trading-terminal inspired landing page and analysis UI\n- Real repository analysis for local Git paths\n- Remote GitHub repository analysis through server-side clone/fetch\n- Live branch dropdowns for local and GitHub repos\n- Hover ticker with OHLC, change, volume, and commit count\n- Single-screen analysis layout\n- Public-facing product presentation with English by default and Chinese documentation included\n\n## Tech Stack\n\n- React 19\n- TypeScript\n- Vite\n- Lightweight Charts\n- Git CLI for repository parsing\n\n## Run Locally\n\n```bash\nnpm install\nnpm run dev\n```\n\nOpen the local Vite URL, usually [http://localhost:5173](http://localhost:5173).\n\n## GitHub Pages\n\nThe public Pages site is a static presentation build:\n\n- Landing page is fully available online\n- Analysis page opens in demo mode with sample repository data\n- Real local Git analysis and live GitHub clone/fetch analysis still require the local dev server or a backend runtime\n\nTo refresh the public Pages build from the repository itself:\n\n```bash\nnpm run build:pages\n```\n\n## Scripts\n\n```bash\nnpm run dev\nnpm run build\nnpm run lint\nnpm run preview\n```\n\n## How Analysis Works\n\n1. Validate a local path or GitHub repository URL\n2. Resolve the branch selection\n3. Read commit history from Git\n4. Convert commit events into codebase movement\n5. Aggregate those events into the selected chart timeframe\n6. Render OHLC + volume in a terminal-style chart\n\n## Repository Notes\n\n- GitHub analysis on this branch uses server-side clone/fetch into a local cache\n- Multi-timeframe candles are derived from real commit events, not from re-bucketed daily candles\n- Sparse `5M` or `1H` views are expected on repositories with low intraday commit frequency\n\n## Documentation\n\n- English: `README.md`\n- Chinese: [`README.zh-CN.md`](./README.zh-CN.md)\n- Product context: [`PRODUCT.md`](./PRODUCT.md)\n- Design context: [`DESIGN.md`](./DESIGN.md)\n- Early idea notes: [`docs-src/idea.md`](./docs-src/idea.md)\n\n## Status\n\nThe current version is a strong prototype with a polished landing page and a functional analysis terminal. It is suitable for demos, iteration, and further productization work.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapril-jk%2Fstoke-your-code","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapril-jk%2Fstoke-your-code","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapril-jk%2Fstoke-your-code/lists"}