GitStuff 🐱

Identify unfollowers, track growth, and protect your social circle.

Features • Tech Stack • Getting Started • Contributing

📖 About

GitStuff is a powerful yet simple tool designed for developers who want to keep track of their GitHub connections. Whether you want to see who unfollowed you, find people you follow who don't follow back, or manage a "whitelist" of users to never flag, GitStuff has you covered.

Built with privacy in mind, your data stays yours, synced securely via Better Auth & PostgreSQL.

✨ Features

• 🕵️ Follower Tracking
  Instantly identify who unfollowed you or who isn't following you back.

• 🛡️ Whitelist System (Shield)
  Mark specific users as "safe" so they never appear in your unfollow lists (perfect for bot accounts or inactive friends).

• 💎 Supporter Tier
  Unlock advanced features like unlimited whitelists and deeper analytics.

• 🔒 Privacy First
  Secure authentication via GitHub OAuth. No shady data practices.

🛠️ Tech Stack

• Framework: Next.js 16 (Turbopack enabled)
• Language: TypeScript
• Styling: Tailwind CSS 4 + shadcn/ui
• Database: PostgreSQL + Prisma ORM
• Authentication: Better Auth
• State Management: Zustand with Persistence
• Testing: Vitest

� Getting Started

Follow these steps to get the project running locally.

Prerequisites

Ensure you have the following installed:

• Node.js: v20 or higher
• Package Manager: pnpm (Recommended)
• Database: PostgreSQL instance

Installation

1. Clone the repository

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

2. Install dependencies

   pnpm install

3. Set up environment variables Create a .env file in the root directory and add the following keys:

   # Database
   DATABASE_URL="postgresql://user:password@localhost:5432/gitstuff"
   
   # Authentication (GitHub OAuth)
   GITHUB_CLIENT_ID="your_github_client_id"
   GITHUB_CLIENT_SECRET="your_github_client_secret"
   BETTER_AUTH_SECRET="your_generated_secret"
   BETTER_AUTH_URL="http://localhost:3000"
   
   # Public URL
   NEXT_PUBLIC_BASE_URL="http://localhost:3000"

4. Initialize the database

   pnpm prisma migrate dev

5. Start the development server

   pnpm dev

   Visit http://localhost:3000 to see the app in action.

� Available Scripts

Command	Description
pnpm dev	Starts the development server with Turbopack
pnpm build	Builds the application for production
pnpm start	Starts the production server
pnpm lint	Runs ESLint to check for code issues
pnpm test	Runs the Vitest test suite
pnpm test:ui	Opens the Vitest UI for interactive testing

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

Distributed under the MIT License. See LICENSE for more information.