About this project
Smokey is a static, single-file developer dashboard for watching the health of GitHub repositories. You open index.html in a browser, enter a GitHub username or organisation, list repositories in owner/repo format, and the page renders their current state in one sortable table. The stated goal is to see repo health without clicking around GitHub.
What the table shows
- Last push per repository, with oldest push listed first by default; any column header (repository, last push, PRs, issues) can be clicked to re-sort.
- Latest release version and release date, shown under the repository name.
- Counts of open pull requests and open issues; clicking a count opens the filtered GitHub page for that repository.
- Attention badges: one row for open PRs and one for open issues, appearing only for repositories with external contributor activity, with each badge linking to the filtered GitHub view. Bot-authored PRs (for example from github-actions[bot]) are filtered out automatically.
Authentication
Public repositories load without login. A GitHub personal access token can optionally be added in the settings panel to unlock private repositories and the CI status column, and is required for organisation repositories protected by SAML SSO if the token is authorised for that organisation. Since unauthenticated API access is capped at 60 requests per hour and each repository costs four requests, a token becomes necessary once roughly fifteen public repositories are monitored; an authenticated token raises the limit to 5,000 requests per hour. The README states the token is stored only in the browser's localStorage and sent only to api.github.com. Both classic tokens (repo scope) and fine-grained tokens (Contents: Read, Metadata: Read, Actions: Read for CI status) are described.
Traffic chart
Instead of GitHub's live traffic API, the dashboard draws a full-history traffic area chart using a daily snapshot kept in a traffic-log branch, accumulated by a separate weekly GitHub Actions workflow (log-traffic.yml). The chart uses a logarithmic time axis that expands recent days and a square-root value scale. This view requires no token. If the branch or logged rows do not exist yet, the chart reports no traffic history.
Hosting and setup
There is no build step, no dependency installation and no server. A hosted copy is available on GitHub Pages, so the dashboard can be used without installing anything; otherwise you download index.html and open it locally. To run your own instance, fork the repository and enable GitHub Pages from the main branch root folder. The layout is described as mobile-friendly and compact, without sidebars.
The README also documents troubleshooting cases: a stale cached page producing a persistent "add a PAT" message (resolved by a hard refresh, noting localStorage is cleared in private windows), 403 errors caused by unauthenticated rate limits or missing SAML authorisation, and the traffic chart remaining empty until the logging workflow has run at least once after repositories were added.
Licence and contact: MIT License, copyright 2025 Scott Kirvan. Contributions are invited through issues, forks and pull requests; contact channels listed include LinkedIn and a Discord server, and the repository includes a CHANGELOG and TODO in its notes folder.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.