Skip to content
This repository has been archived by the owner on Sep 12, 2024. It is now read-only.

EddieHubCommunity/good-first-issue-finder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Open in Gitpod
RepoRater GitHub code size in bytes GitHub contributors Discord

Good First Issue Finder by EddieHub

Good First Issue Finder helps new open source contributors to make it easy to get into the world of open source through good first issues.

eddiehub issue finder

πŸ‘¨β€πŸ’» Live Version

Check out the website: Good First Issue Finder

πŸ‘‡ Prerequisites

Before installation, please make sure you have already installed the following tools:

πŸ› οΈ Installation Steps

  1. Fork the project here

  2. Clone the project

      git clone https://github.com/YOUR_USERNAME/good-first-issue-finder.git
  3. Navigate to the project directory cd good-first-issue-finder

  4. Install dependencies with npm install

  5. If you encountered error like engine not compatible with your version on node/npm

    Upgrade your node version from Here

    OR

    By following commands from Here

    We highly recommend installing the current LTS version of node.

  6. Create a .env file in the root of the project. Then add your GitHub Oauth values (see example in .env.example file)

Note: You need to set up an Oauth App(not GitHub App) in Github to get the required values. See the documentation here. The Callback Url needs to point to the endpoint of the baseURL the app should run on: http://localhost:5173/api/authentication/callback. Also, never commit the .env file, it is ignored by Git.

callback url

  1. Run npm run dev

Alternatively, skip all the steps by using Gitpod Ready-to-Code

Note: You still need to do the 6th step as defined earlier even if you are using Gitpod to run the app.

πŸ§ͺ Testing

We're using Playwright for running End-To-End Tests. For running the tests you would need to install the playwright dependencies by running

npx playwright install --with-deps

πŸ‘¨β€πŸ’» Contributing

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

πŸ›‘οΈ License

Good first issue finder is licensed under the MIT License - see the LICENSE file for details.

πŸ’ͺ Thanks to all Contributors

Thanks a lot for spending your time helping Good first issue finder grow. Thanks a lot! Keep rocking 🍻

Contributors

πŸ™ Support

This project needs a ⭐️ from you. Don't forget to leave a star ⭐️.

Our Pledge

We take participation in our community as a harassment-free experience for everyone and we pledge to act in ways to contribute to an open, welcoming, diverse and inclusive community.

If you have experienced or been made aware of unacceptable behaviour, please remember that you can report this. Read our Code of Conduct.