Hacktoberfest Projects is an open-source Next.js web app that helps developers find GitHub repositories eligible for Hacktoberfest contributions. It relies on the GitHub API to surface repositories tagged with the hacktoberfest topic and runs live at finder.usmans.me.
What is Hacktoberfest Projects?
Hacktoberfest Projects is a web application built with Next.js and styled with Tailwind CSS and Daisy UI, created by Usman and Sunrit Jana. It takes GitHub repository data via the GitHub API and outputs a filtered view of repositories that meet Hacktoberfest participation criteria. The project is configured with a GitHub OAuth app and a Xata database for local development, as detailed in its CONTRIBUTING.md.
Key Features
- Tech stack — Uses Next.js as the React framework, Tailwind CSS for utility styling, and Daisy UI for component classes, with data sourced from GitHub's public API.
- Local setup — Running locally requires creating a GitHub OAuth application and setting up a Xata database; instructions live in CONTRIBUTING.md.
- Community-driven — Follows the all-contributors specification, with 51 contributors already credited and all contribution types welcome.
- Language policy — Pull requests that only add new languages are not merged; instead, users are asked to create an issue suggesting the language.
- Feedback channel — Users can report bugs or suggest improvements through the repository's GitHub issues.
- Commit convention — The project uses gitmoji for commit message icons, as shown by its badge.
Who is it for?
- Hacktoberfest participants — Quickly locate repositories with the hacktoberfest topic that are likely to count toward their pull request goals, avoiding wasted effort on non-participating projects.
- Open-source maintainers — Check whether their own repositories appear as eligible and understand how the project classifies them.
- First-time contributors — Discover beginner-friendly repositories that are explicitly labeled for Hacktoberfest, lowering the barrier to making a first open-source contribution.
What can you do with it?
- Find contribution targets — Browse repositories tagged with the hacktoberfest topic and identify ones that meet the program's eligibility rules.
- Verify repository eligibility — Confirm before starting work whether a given repository is participating in Hacktoberfest.
- Contribute to the project itself — Help improve the finder by coding, designing, writing content, or reporting issues; the all-contributors list shows many ways to take part.
FAQ
Is Hacktoberfest Projects free to use?
Yes, the app is open source and freely accessible at finder.usmans.me. The source code is public on GitHub, and there are no paid tiers or usage fees associated with using or contributing to the project.
How do I run Hacktoberfest Projects locally?
Follow the instructions in CONTRIBUTING.md. You will need to set up a GitHub OAuth application and create a Xata database, then configure the environment variables before starting the Next.js development server.
Can I add a new language to the app?
No, pull requests that only add languages are not accepted. If you want a language added, you must create an issue suggesting it, and the maintainers will review the request.
Who maintains Hacktoberfest Projects?
The project is authored by Usman (max-programming) and Sunrit Jana (janaSunrise), with contributions from a community of 51 contributors as shown in the all-contributors badge.
