Skip to content

Repository files navigation

The Horology API

Wind a GitHub handle into a 3D mechanical watch — commits, languages, and stars as living complications.

Built by Abdul Wasay (@wasaybuilds).

Stack

  • Next.js (App Router) · TypeScript · React Three Fiber / Drei
  • Zustand · Tailwind CSS · Framer Motion
  • GitHub REST API (GET /api/github?username=…)

Getting started

pnpm install
pnpm dev

Open http://localhost:3000. Enter a handle in the command bar and press Wind.

Optional (higher GitHub rate limits):

# .env.local
GITHUB_TOKEN=ghp_…

Docs

In-app manual: /docs — pipeline, GitHub → watch mapping, ranks, API notes.

Mapping (short)

Signal Complication
Commits / day Balance beat + seconds sweep
Top languages Caliber code + hand / escape angles
Age + stars Power reserve
Activity blend Horologist rank

Assets

3D movement based on mechanical watch mechanism by abdelghani.0 (CC-BY-4.0). See public/scene-license.txt.

Provisional fallback GLB: pnpm exec node scripts/generate-luxury-watch-glb.mjs

License

App code: see repository. Sketchfab model: CC-BY-4.0 (credit required).

About

Your GitHub activity, wound into a luxury timepiece. Translate public GitHub stats into a fully functional 3D watch.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages