https://github.com/gurjeetsahu/awesomeness
Manage your full star lists of Github.
https://github.com/gurjeetsahu/awesomeness
actions awesome awesome-list awesome-lists awesomeness github github-actions github-api github-stars list lists nextjs nodejs star stars typescript
Last synced: 5 months ago
JSON representation
Manage your full star lists of Github.
- Host: GitHub
- URL: https://github.com/gurjeetsahu/awesomeness
- Owner: GurjeetSahu
- License: mit
- Created: 2025-09-22T16:09:41.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-12-01T20:33:20.000Z (6 months ago)
- Last Synced: 2025-12-04T09:55:49.968Z (6 months ago)
- Topics: actions, awesome, awesome-list, awesome-lists, awesomeness, github, github-actions, github-api, github-stars, list, lists, nextjs, nodejs, star, stars, typescript
- Language: TypeScript
- Homepage:
- Size: 200 KB
- Stars: 4
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
---
# Awesomeness
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.
> **Beta version:** still a bit unstable and may need some polishing.
---
## Caution
⚠️ CAUTION
THIS REPOSITORY IS INTENDED FOR PERSONAL AND EDUCATIONAL USE ONLY.
IT INTERACTS WITH THE GITHUB API TO FETCH STARRED REPOSITORIES AND MAY SEND MULTIPLE REQUESTS DEPENDING ON USAGE.
THIS APPLICATION RESPECTS GITHUB’S API LIMITS AND INFRASTRUCTURE AND FETCHES DATA ONLY WHEN NEEDED TO AVOID UNNECESSARY LOAD OR RATE LIMIT VIOLATIONS.
OVERUSE, ABUSE, OR MISUSE (E.G., EXCESSIVE API CALLS, AUTOMATION BEYOND RATE LIMITS, OR USE WITH UNAUTHORIZED TOKENS) CAN LEAD TO GITHUB ACCOUNT SUSPENSION OR API RESTRICTIONS.
THE DEVELOPER IS NOT RESPONSIBLE FOR ANY BANS, RESTRICTIONS, OR DAMAGES RESULTING FROM IMPROPER OR EXCESSIVE USE OF THIS CODE.
USE RESPONSIBLY.
## 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.
---
## Why I Built This
This project was inspired by the need for a **personal, customizable way to organize starred repositories**. It is meant for **local use only**, and does not replace GitHub’s platform or interfere with its services.
---
## Tech Stack
* **React + Next.js** – UI and app logic
* **Dexie.js** – Local IndexedDB management
* **shadcn/ui** – Accessible, modern components
---
## Getting Started
1. **Clone the repository:**
```bash
git clone https://github.com/your-username/awesomeness.git
cd awesomeness
```
2. **Install dependencies:**
```bash
npm install
```
3. **Create a GitHub Personal Access Token(PAT)**
* Go to [GitHub Developer Settings](https://github.com/settings/personal-access-tokens) → Generate New Token.
* Copy the **Token**.
4. **Add your next-auth secret:**
```env
npx auth secret
```
5. **Add your OAuth credentials:**
On `.env.local` file:
```env
PAT=your_token
NEXTAUTH_URL=http://localhost:3000
```
6. **Run the app:**
```bash
npm run dev
```
Open [http://localhost:3000](http://localhost:3000) in your browser.
---
## Usage
* Sign in with your GitHub account via OAuth.
* Click refresh button to fetch all your starred repositories from github.
* Browse your starred repositories locally.
* Organize them into categories or create new ones.
* All data is stored **locally on your machine**.
---
## Acknowledgements
* Thanks to **[shadcn/ui](https://github.com/shadcn/ui)** for their clean and accessible UI components.
* Thanks to **[Dexie.js](https://dexie.org/)** 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]
---