Skip to content

GurjeetSahu/StarVault

Repository files navigation

StarVault

A local solution to organize your GitHub stars. Built for developers who want more ways to categorize and manage their starred repositories on their own machine.


Features

  • Organize your GitHub stars into custom categories locally.
  • Fully local-first, powered by IndexedDB via Dexie.js.
  • Clean, modern UI built with React + Next.js and shadcn/ui.
  • Uses OAuth for GitHub authentication — no live hosting or server-side storage required.

Screenshots

Screenshot

Getting Started

  1. Clone the repository:

    git clone https://github.com/GurjeetSahu/StarVault.git
    cd StarVault
  2. Install dependencies:

    npm install
  3. Create a GitHub Personal Access Token(PAT)

    • Go to GitHub Developer Settings → Fine-Grained Token → Generate New Token.
    • Under Account Permissions, Select "Starring".
    • Copy the Token.
  4. Add your credentials: On .env.local file:

    PAT=your_token
  5. Run the app:

    npm run dev

    Open http://localhost:3000 in your browser.


Tech Stack

  • React + Next.js – UI and app logic
  • Dexie.js – Local IndexedDB management
  • shadcn/ui – Accessible, modern components

Acknowledgements

  • Thanks to shadcn/ui for their clean and accessible UI components.
  • Thanks to Dexie.js for making IndexedDB easy to work with.
  • Inspired by developers and open-source projects that make building tools like this possible.

Contributing

Contributions, feedback, and suggestions are welcome! Please open issues or submit pull requests.


License

MIT License © 2025 [gurjeetsahu]