Automatically follow people who star your repo ✨
Give back with a follow, powered by Next.js & GitHub Webhook

Star this repo and get an instant follow back 💖

A Next.js 14 serverless GitHub webhook API to auto-follow users who star your repo — ported from the Python version to Next.js API route with full secret verification and logging.

How it works

When someone stars this repo, GitHub sends a webhook that triggers this API. It:

• Validates the webhook signature
• Follows the user by sending a PUT request to https://api.github.com/user/following/{username} with the GitHub token in the Authorization header (Bearer <token>).

Features

• Secure webhook secret validation
• Instant follow-back of new stargazers
• Simple setup with environment variables
• Logs for success and errors

Setup

You can set this up yourself to automatically follow users who star your repository.

1. Clone or download this repo

2. Rename .env.example to .env.local and fill in your values:

GITHUB_TOKEN=your_github_personal_access_token
GITHUB_WEBHOOK_SECRET=your_webhook_secret

• The GitHub token needs the user:follow scope.

3. Deploy on Vercel

4. Add the webhook URL to your GitHub repo settings:

https://your-vercel-app.vercel.app/api/webhook

• Content type: application/json
• Secret: same as GITHUB_WEBHOOK_SECRET

Logs & Debugging

Logs are printed in Vercel serverless function console.

License

BSD-3-Clause license