/issue-finder

A search engine for newbie-friendly github issues from YCombinator startups.

Primary LanguageCSSMIT LicenseMIT

Issue-Finder

A search engine to find newbie-friendly github issues. The issue finder helps you find a list of beginner-friendly GitHub repos, backed by Y Combinator, that have Ruby and Javascript issues that are good for new contributors.

👉 Watch this YouTube video for a quick user's guide!

Your Open Source FinderIssue Finder

Issue Finder Live

Demo

Learn About Issue Finder from the first Contributors

Issue Scraper Logic - Repository Owner

Video: Oscar Mier

React/Redux Logic | API's | Actions - Project Maintainer

Video: Shadman Ali

UI - Project Maintainer

Video: Steve W Dames Jr

Data Retrieval From Github API

Video: Jose Ramon Castaños

API Request from Y Combinator

Video: Ricardo Valtierra

Honorable Mentions:

Firebase Analytics

Linkedin Post: Denis Lafontant

Built With

  • JavaScript
  • REACT
  • REDUX
  • THUNK
  • Tailwind CSS

Milestones

  • Milestone 1: Setup the project and install dependencies

  • Milestone 2: Setup Redux store

  • Milestone 3: Setup thunk

  • Milestone 4: Add label logic

  • Milestone 5: Add filter logic

  • Milestone 6: Create basic UI/UX to display App information

  • Milestone 7: Add Analytics support

  • Milestone 8: Refactor and optimize components/redux

  • Milestone 9: Update Meta for SEO

  • Milestone 10: Deploy live APP

  • Debug linter errors

Screenshots

Cell Desktop

Getting Started

To get a local copy up and running follow these simple example steps.

Pre-requisites

  • Text Editor
  • Git and Github set up

Usage

In your terminal, navigate to the directory you would like to store the project and run this code:

git clone https://github.com/voscarmv/issue-finder.git

Then run:

cd issue-finder

Open the project in your favorite code editor code . for VS Code.

Dependencies

  • Run npm install - to install the necessary packages listed in the package.json file

  • Run touch .env

  • Generate your GitHub token here https://github.com/settings/tokens

  • Run echo REACT_APP_API_KEY=ghp_my_github_token > .env make sure you replace ghp_my_github_token with your generated token

  • Then in your terminal type npm start and view app in your browser

  • Then in your terminal run npm start and view app in your browser

Linter Setup

  • Run npx eslint . which will print any errors found.
  • Run npx eslint . --fix to automatically fix the errors.

npm test

Launches the test runner in the interactive watch mode.
See the section about running tests for more information.

npm run build

Builds the app for production to the build folder.
It correctly bundles React in production mode and optimizes the build for the best performance.

The build is minified and the filenames include the hashes.
Your app is ready to be deployed!

See the section about deployment for more information.

Usage

  • Select a label from the first drop down menu
  • Select a language from the second drop down menu
  • Click FIND ISSUES to filter through great issues matching your search query
  • Click on a issue from the list of issues below to view your next open source contribution on GitHub

Make some coffee in the time you saved finding an amazing issue for your next contribution!

Author 1:

👤 OSCAR MIER

Author 2:

👤 SHADMAN ALI

Author 3:

👤 STEVE W DAMES JR

Author 4:

👤 JOSE RAMON

Author 5:

👤 RICARDO VALTIERRA

Author 6:

👤 DENIS LAFONTANT

🤝 Contributing

Join our Whatsapp group!

Contributions, issues, and feature requests are welcome!

Feel free to check the issues page.

Show your support

Give a ⭐️ if you like this project!

Acknowledgments

  • Hat tip to anyone whose code was used.

📝 License

This project is MIT licensed.