Checkout out contribution guidelines before you start with contributions

This is a Next.js project bootstrapped with create-next-app

1. Fork the repo into your account

2. Clone the project into your local machine

git clone https://github.com/<Your-GitHub-username>/gitopener.vercel.app.git

3. Navigate the folder

cd gitopener.vercel.app

3. Install the dependencies

As Git Opener uses yarn package manager, it is recommended to use yarn, install yarn

yarn install

4. Make .env.local file in root directory with these variables

This step is optional, Do this step if you want to run complete application with database support

MONGO_URI= 'YOUR MONGODB CONNECTION STRING GOES HERE'
GITHUB_TOKEN= 'YOUR GITHUB TOKEN GOES HERE'

• Get mongodb connection string here: MONGODB DOCS
• Generate github token here: GITHUB TOKEN

5. Run the project on local machine

yarn dev

6. Every time you start making changes to your forked repo make sure it's in sync with the original repo

Thank you for considering to contribute to this project.

This project is in a very early stage so anybody who's familiar with ReactJS/NextJS/Typescript/TailwindCSS can contribute. If you don't feel ready to make a contribution yet, no problem at all. You can also contribute to this ReadMe section or the Documentation part of our project.

If you are interested to contribute and want to learn more about the technologies that are used in this project, checkout the links below.

• ReactJS Official Docs
• NextJS Documentation
• Typescript Documentaion
• TailwindCSS Docs

Never made an open source contribution before? And wondering how to contribute to this project? No worries! Here's a quick guide,

1. Choose any feature/bug you wish to contribute to.
2. Fork the repository into your own account.
3. Clone the repo you have forked in your local machine using git clone https://github.com/<Your-GitHub-username>/gitopener.vercel.app.git
4. Create a new branch for your fix by using the command git checkout -b YourName-branch-name
5. Make the changes you wish to do and stage them using the command git add files-you-have-changed or use git add .
6. Use the command git commit -m "Short description of the changes" to describe the changes you have done with a message.
7. Push the changes to your remote repository using git push origin your-branch-name
8. Submit a PR(pull request) to the upstream repository pbclife/gitopener.vercel.app with a title and a small description.
9. Wait for the pull request to be reviewed by us.
10. Make appropriate changes if the maintainer recommends you to and submit it.
11. Await for your contribution to be merged into the repository.

Checkout the Contributing.md file before contributing.

MIT

Give a ⭐ to the project if you liked it. :)