Understand any GitHub repository instantly.
Beacon analyzes repository health, activity, contributors, and trends into actionable insights — a single health score, five pillars, an AI summary, and embeddable widgets for any owner/repo.
Everything you need to read a repository at a glance
Beacon turns the raw signals GitHub exposes into a structured, explainable picture of a project's health — the same engine powers the CLI, the REST API, and the dashboard.
Repository Intelligence
One call collects a full snapshot from the GitHub API — metadata, languages, contributors, commit activity, releases, issues, pull requests, and README signals.
Health Scores
A deterministic 0–100 Beacon Score across five weighted pillars — Activity, Community, Maintenance, Documentation, and Security — with an Excellent-to-Critical grade.
Contributor Analytics
See the contributor base, the balance of external contribution, and who is carrying the project — with each pillar backed by explainable reasons.
Timelines & Trends
Weekly commit-activity histograms and release cadence reveal whether a project is accelerating, steady, or stalling over the last year.
AI Summaries
A natural-language "Beacon Summary" — headline, paragraph, highlights, and risks — from pluggable providers: an offline heuristic by default, or OpenAI / Anthropic.
Dependency & Security Signals
Language breakdown plus dependency manifests and security signals — security policy, Dependabot, and vulnerability alerts — feed the Security pillar.
Embeddable Widgets
Drop a live health card, activity graph, language, contributor, or release widget — or a compact badge — into any README or site as an SVG. Themeable (dark / light / transparent) and sizeable.
GitHub App & Monitoring
A self-hostable GitHub App listens for push, pull_request, issues, release, star, and fork webhooks and re-scores a repository as it changes — no manual re-runs.
Health History
Beacon snapshots scores over time, so you can see trends across 30, 90, and 365 days — “health improved 4% this month” instead of a single point in time.
A repository, distilled
This is the kind of report Beacon produces for any repository — a headline score, five explainable pillars, activity trends, and a language breakdown, all in one view.
Real-time data-sync engine for local-first apps.
- TypeScript68%
- CSS14%
- JavaScript11%
- Shell4%
- Other3%
Aurora is a thriving, well-maintained project: frequent commits, timely releases, and strong docs. Watch the single-maintainer bus factor as it grows.
Illustrative data for a fictional repository. Run it for real with beacon analyze owner/repo.
Embed your repository’s health anywhere
Beacon serves live SVG widgets and badges from your own instance. Drop a health card into a README, an activity graph into a portfolio, or a maintenance badge at the top of any project — themeable and sizeable.
Six widget types plus a shields-style badge — in dark, light, and transparent themes.
Built in the open, yours to run
Beacon is MIT licensed and self-hostable. It's a newly published project — no adoption metrics to show yet, just a real, working codebase. The most useful thing you can do is read it, run it, and open an issue or PR.
apps/webappThe Beacon dashboard — a Next.js web UI for repository intelligence.
apps/apiappA Fastify REST API that serves analyses over HTTP.
apps/cliappThe `beacon` CLI — analyze any repo from your terminal.
packages/corepackageThe analysis engine: GitHub client, scoring, and AI summaries.
packages/databasepackagePrisma schema and client for persisting analyses.
packages/configpackageShared TypeScript and ESLint configuration.
How Beacon is structured
The GitHub API feeds a single analysis engine that collects a snapshot, computes the score, and generates an AI summary. Three surfaces — the CLI, the REST API, and the dashboard — all read from that one engine, so every product agrees on the numbers.
One lifecycle, four tools
Beacon is the understand stage of the Blink Dev toolchain — from creating and building software to protecting and understanding it.
Repository intelligence & health scores.