gfstat — GitHub Follow Stats

Know your GitHub follow stats: mutuals, who doesn't follow you back, whom you don't follow back — with follow/unfollow right from the app.

Tech

SvelteKit (TypeScript, server-side), Cloudflare Pages, utc-ds design system. Plain fetch against GitHub REST API.

Local Dev

npm install
cp .env.example .env   # edit with your OAuth app credentials
npm run dev

Required env vars

GITHUB_CLIENT_ID=your_oauth_client_id
GITHUB_CLIENT_SECRET=your_oauth_client_secret

OAuth App Setup

1. Register a new OAuth app at https://github.com/settings/developers
2. Homepage URL: http://localhost:5173 (dev)
3. Authorization callback URL: http://localhost:5173/auth/callback
4. Copy Client ID and Secret to .env

Deploy

Cloudflare Pages (Git integration)

Cloudflare builds and deploys on every push to main.

Setting	Value
Build command	npm run build
Build output directory	.svelte-kit/cloudflare
Root directory	/

Environment variables (set in Cloudflare Dashboard → Settings → Environment variables):

• GITHUB_CLIENT_ID
• GITHUB_CLIENT_SECRET

KV namespace: Create a KV namespace named SESSIONS and bind it via the Cloudflare Dashboard (Pages → Settings → Bindings). The id in wrangler.toml is a placeholder — Cloudflare resolves it at deploy time.

Update your OAuth app callback URL to https://your-domain.pages.dev/auth/callback.

Manual deploy

npm run build
npm run deploy

Commands

Command	What
npm run dev	Dev server
npm run build	Production build
npm test	Vitest
npm run check	Type-check