GitHub 3D Metrics

Your Code. Your Universe.
Created by 0xAllow · MIT

Turn your public GitHub contribution calendar into an isometric skyline. Generate static SVG cards in your own repository, customize them on GitHub Pages, or render them locally through the MCP server.

Install in your profile README

1. Create a public repository under your user account. Give it the same name as your GitHub username and initialize it with a README.

2. Copy the example workflow into .github/workflows/update-now.yml in your profile repository. Replace YOUR-GITHUB-USERNAME with your own login. The workflow expects the upstream project to be publicly available at 0xAllow/github-3d-metrics.

3. Open your repository’s Actions → Update Now → Run workflow and select the default branch. If Actions asks you to enable workflows, enable this one.

4. Check the run summary. After a successful run, add the following line to your README.

![GitHub 3D Metrics](./assets/github-3d-metrics.svg)

Use Update Now again whenever you want to refresh. The workflow commits changed assets. A fetch or rendering failure leaves the previous committed image in place. A successful run can take several minutes, and updates may take longer to appear in GitHub’s image cache.

For dashboard-based setup, open the project’s expected Pages URL after the maintainer deploys it, enter your username, then copy the workflow and README embed from Setup. The studio uses sample data on first visit. After your first successful run, Load snapshot reads the generated public JSON from your profile repository’s default branch.

Related MCP server: GodProfile MCP Toolkit

Visualizations

The seven free palettes are shown in the theme gallery. Configure the view, theme, sizes, colors, geometry style, metrics, and optional date label using the configuration example. The date label is the UTC date when the snapshot contents last changed. GitHub’s own contribution rules determine calendar counts. The application declines calendars with reported restricted contributions.

Run locally

Use Node.js 24 LTS and npm.

npm install
npm run dev
npm run generate -- --username octocat --options '{"view":"stats"}'

Set GITHUB_TOKEN in your environment for GraphQL calendar views. See token guidance and troubleshooting. Use --root PATH to generate under another local repository, and --light-pair to add a separate light SVG. The CLI never commits or pushes. See MCP setup, architecture, and Pages deployment.

npm run test:core
npm run build
npm test
npx playwright install chromium
npm run e2e
npm audit --audit-level=high

See verification status, contribution guidance, and the security reporting process.