GitStuff is a powerful yet simple tool to track your GitHub followers. It helps you identify who unfollowed you, track new followers, and manage your social circle on GitHub with ease.

• Follower Tracking: Instantly see who unfollowed you and who followed you back since your last visit.
• Whitelisting: Mark specific users as "safe" to prevent them from appearing in your unfollow lists (e.g., bots or friends).
• Smart Sync: Automatically keeps your profile data in sync with GitHub.
• Privacy First: All history tracking is local or user-controlled. You can delete all your data with one click.
• Dark Mode: Fully supported dark/light themes for a comfortable viewing experience.

• Framework: Next.js 16 (App Router)
• Language: TypeScript
• Styling: Tailwind CSS 4 & shadcn/ui
• Database: PostgreSQL (via Prisma)
• Authentication: better-auth (GitHub OAuth)
• State Management: Zustand with persistence

• Node.js & pnpm
• PostgreSQL database
• GitHub OAuth App credentials

1. Clone the repository:

   git clone https://github.com/yourusername/gitstuff.git
   cd gitstuff

2. Install dependencies:

   pnpm install

3. Set up environment variables: Create a .env file in the root directory:

   DATABASE_URL="postgresql://..."
   GITHUB_CLIENT_ID="your_client_id"
   GITHUB_CLIENT_SECRET="your_client_secret"
   BETTER_AUTH_SECRET="your_auth_secret"
   BETTER_AUTH_URL="http://localhost:3000"

4. Initialize the database:

   pnpm prisma generate
   pnpm prisma db push

5. Run the development server:

   pnpm dev

   Open http://localhost:3000 to see the app.

Run the test suite using Vitest:

pnpm test

This project is open-source and available under the MIT License.