juprodh.me / tangled-stars
Star history for tangled repositories tangled-stars.com
atproto git tangled
1
Fork 0

Configure Feed

Select the types of activity you want to include in your feed.

TypeScript 93.8%
CSS 3.1%
HTML 0.6%
Shell 0.6%
JavaScript 0.4%
Vim Snippet 0.3%
Dockerfile 0.2%
Other 1.0%
17 1 0

Clone this repository

https://tangled.org/juprodh.me/tangled-stars https://tangled.org/did:plc:4wzdciymisxnahqcxzwwnsmx
git@tangled.org:juprodh.me/tangled-stars git@tangled.org:did:plc:4wzdciymisxnahqcxzwwnsmx

For self-hosted knots, clone URLs may differ based on your setup.


Download tar.gz Download .zip
README.md

Star-history charts for Tangled repositories, a decentralized git platform built on the AT Protocol.

Enter a Tangled repo, get its star-growth chart, compare repos, and export or embed the result.

Tangled Stars Chart

What it does#

  • Hand-drawn (xkcd-style) D3 star-history chart
  • Compare multiple repos on one chart
  • Date and Timeline (days-since-first-star) modes, optional log scale
  • One-click PNG and CSV export
  • Embed a live SVG chart via the API server's /svg endpoint

How stars are resolved#

Tangled has no such reverse lookup: a star is an AT-Proto record (sh.tangled.feed.star) stored in each starring user's own PDS. To answer "who starred repo X" we use the Constellation backlink index (constellation.microcosm.blue), and decode each star's timestamp from its record key (a TID).

Architecture#

  • frontend/ : Vite + Preact SPA (static, hash routing) + D3 + Tailwind.
  • backend/ : Hono API server on Deno.serve; star history from a local SQLite store kept esh by a live Jetstream ingester, plus embeddable /svg charts.
  • shared/ : chart rendering, the AT-Proto/Constellation client, and shared types.
  • tangled/ : static seed data: seeds.json for the trending sweep, plus data/ (trending list + repo directory) used as the no-backend fallback.

Development#

Requires Deno.

deno task fmt      # format  (deno fmt)
deno task lint     # lint    (deno lint)
deno task check    # fmt --check + lint

Run the app:

deno task dev:backend     # Hono API on :8080 (SQLite + Jetstream ingester)
deno task dev:frontend    # Vite dev server (Preact SPA)
deno task build:frontend  # static build → frontend/dist

See CONTRIBUTING.md for the full workflow.

License#

AGPL-3.0-only (LICENSE).

Chart-rendering code derived from star-history remains under its original MIT terms, preserved in LICENSE-MIT; see NOTICE for the attribution.