{"id":34666705,"url":"https://github.com/gurjeetsahu/awesomeness","last_synced_at":"2025-12-24T19:03:41.621Z","repository":{"id":316664713,"uuid":"1061964278","full_name":"GurjeetSahu/awesomeness","owner":"GurjeetSahu","description":"Manage your full star lists of Github.","archived":false,"fork":false,"pushed_at":"2025-12-01T20:33:20.000Z","size":205,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-04T09:55:49.968Z","etag":null,"topics":["actions","awesome","awesome-list","awesome-lists","awesomeness","github","github-actions","github-api","github-stars","list","lists","nextjs","nodejs","star","stars","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GurjeetSahu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-22T16:09:41.000Z","updated_at":"2025-12-01T20:33:23.000Z","dependencies_parsed_at":"2025-09-26T01:23:30.956Z","dependency_job_id":"ad2c6753-6cac-461e-af3e-84de84f60372","html_url":"https://github.com/GurjeetSahu/awesomeness","commit_stats":null,"previous_names":["gurjeetsahu/awesomeness"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/GurjeetSahu/awesomeness","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GurjeetSahu%2Fawesomeness","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GurjeetSahu%2Fawesomeness/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GurjeetSahu%2Fawesomeness/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GurjeetSahu%2Fawesomeness/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GurjeetSahu","download_url":"https://codeload.github.com/GurjeetSahu/awesomeness/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GurjeetSahu%2Fawesomeness/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28006375,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-24T02:00:07.193Z","response_time":83,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["actions","awesome","awesome-list","awesome-lists","awesomeness","github","github-actions","github-api","github-stars","list","lists","nextjs","nodejs","star","stars","typescript"],"created_at":"2025-12-24T19:00:56.725Z","updated_at":"2025-12-24T19:03:41.607Z","avatar_url":"https://github.com/GurjeetSahu.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\n\n# Awesomeness\n\nA **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.\n\n\u003e **Beta version:** still a bit unstable and may need some polishing.\n\n---\n## Caution\n⚠️ CAUTION\n\nTHIS REPOSITORY IS INTENDED FOR PERSONAL AND EDUCATIONAL USE ONLY.\nIT INTERACTS WITH THE GITHUB API TO FETCH STARRED REPOSITORIES AND MAY SEND MULTIPLE REQUESTS DEPENDING ON USAGE.\n\nTHIS APPLICATION RESPECTS GITHUB’S API LIMITS AND INFRASTRUCTURE AND FETCHES DATA ONLY WHEN NEEDED TO AVOID UNNECESSARY LOAD OR RATE LIMIT VIOLATIONS.\n\nOVERUSE, 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.\n\nTHE DEVELOPER IS NOT RESPONSIBLE FOR ANY BANS, RESTRICTIONS, OR DAMAGES RESULTING FROM IMPROPER OR EXCESSIVE USE OF THIS CODE.\n\nUSE RESPONSIBLY.\n\n## Features\n\n* Organize your GitHub stars into custom categories locally.\n* Fully **local-first**, powered by IndexedDB via **Dexie.js**.\n* Clean, modern UI built with **React + Next.js** and **shadcn/ui**.\n* Uses OAuth for GitHub authentication — no live hosting or server-side storage required.\n\n---\n\n## Why I Built This\n\nThis 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.\n\n---\n\n## Tech Stack\n\n* **React + Next.js** – UI and app logic\n* **Dexie.js** – Local IndexedDB management\n* **shadcn/ui** – Accessible, modern components\n\n---\n\n## Getting Started\n\n1. **Clone the repository:**\n\n   ```bash\n   git clone https://github.com/your-username/awesomeness.git\n   cd awesomeness\n   ```\n\n2. **Install dependencies:**\n\n   ```bash\n   npm install\n   ```\n\n3. **Create a GitHub Personal Access Token(PAT)**\n\n   * Go to [GitHub Developer Settings](https://github.com/settings/personal-access-tokens) → Generate New Token.\n   * Copy the **Token**.\n\n4. **Add your next-auth secret:**\n   \n   ```env\n   npx auth secret\n   ```\n   \n5. **Add your OAuth credentials:**\n   On `.env.local` file:\n\n   ```env\n   PAT=your_token\n   NEXTAUTH_URL=http://localhost:3000\n   ```\n\n6. **Run the app:**\n\n   ```bash\n   npm run dev\n   ```\n\n   Open [http://localhost:3000](http://localhost:3000) in your browser.\n\n---\n\n## Usage\n\n* Sign in with your GitHub account via OAuth.\n* Click refresh button to fetch all your starred repositories from github.\n* Browse your starred repositories locally.\n* Organize them into categories or create new ones.\n* All data is stored **locally on your machine**.\n\n---\n\n\n## Acknowledgements\n\n* Thanks to **[shadcn/ui](https://github.com/shadcn/ui)** for their clean and accessible UI components.\n* Thanks to **[Dexie.js](https://dexie.org/)** for making IndexedDB easy to work with.\n* Inspired by developers and open-source projects that make building tools like this possible.\n\n---\n\n\n## Contributing\n\nContributions, feedback, and suggestions are welcome! Please open issues or submit pull requests.\n\n---\n\n## License\n\nMIT License © 2025 \\[gurjeetsahu]\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgurjeetsahu%2Fawesomeness","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgurjeetsahu%2Fawesomeness","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgurjeetsahu%2Fawesomeness/lists"}