gitopener.vercel.app

KO | EN

gitlite — search

#python #php #java #dotfiles #c #c-plus-plus #javascript #shell #ruby #cross-language #gtk #clojure

gitopener.vercel.app

★ 51 Open GitHub ↗

Git Opener is a learning web app if you are looking forward to get started with open source then you are in right place. Please read contribution guideline.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# GitOpener 🚪🔓

[![Open in GitPod](https://img.shields.io/badge/Gitpod-Ready--to--Code-blue?logo=gitpod)](https://gitpod.io/#https://github.com/pbclife/gitopener.vercel.app)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/pbclife/gitopener.vercel.app/blob/main/LICENSE)
[![Contributors](https://img.shields.io/github/contributors/badges/shields)](https://github.com/pbclife/gitopener.vercel.app/graphs/contributors)
![GitHub Repo stars](https://img.shields.io/github/stars/pbclife/gitopener.vercel.app?style=flat)
![GitHub forks](https://img.shields.io/github/forks/pbclife/gitopener.vercel.app?style=flat)
![GitHub issues](https://img.shields.io/github/issues/pbclife/gitopener.vercel.app?style=flat)
![GitHub pull requests](https://img.shields.io/github/issues-pr/pbclife/gitopener.vercel.app?style=flat)

![landingPage](https://user-images.githubusercontent.com/71945723/227792530-993f74ab-7c78-4e46-a3f6-69de0af9c597.jpg)

🚀 Start your Open Source Journey! Contribute Today! 🤝

## Table of Contents
- [What is GitOpener?](#what-is-gitopener)
- [Learn Contributing 📖](#learn-contributing-📖)
- [Become Contributor 👥](#become-contributor-👥)
- [How it works 🛠️](#how-it-works-🛠️)
- [How to create your profile 📝](#how-to-create-your-profile-📝)
- [Contribution guide 🤝](#contribution-guide-🤝)
  - [Installation 🚧](#installation-🚧)
  - [Contributing Guidelines 📜](#contributing-guidelines-📜)
- [📝 License](#📝-license)

## What is GitOpener?

Git Opener is a beginner friendly open source project. This project serves as a guide to open source, with step by step information on how you can contribute. If you want to see your code in action, you're in the right place! 💻

## Learn Contributing 📖

Everything you need to know to contribute to open source can be found here, from creating an issue to opening a pull request. Basic terminology can be found here! 📚

![guidesPage](https://user-images.githubusercontent.com/71945723/227792563-8ab9c59b-8187-4108-93cd-4157d97fe687.png)

## Become Contributor 👥

Contributors are featured on the web app. 👨‍💻👩‍💻

![contributorsPage](https://user-images.githubusercontent.com/71945723/227792580-531716bd-8404-4472-bb21-601d8ca62ce5.png)

## How it works 🛠️

Based on your contribution file `your-github-username.mdx`, GitOpener will authenticate you.

![profilePage](https://user-images.githubusercontent.com/71945723/227792597-05eb9130-3c99-4682-a1f1-8237a8c33efa.png)
![profilePage2](https://user-images.githubusercontent.com/71945723/227792601-5764ceaa-c289-41f4-b126-3b1d44a6eac4.png)

## How to create your profile 📝

Installation steps are featured [here](#installation).

If you want to skip the installation and create your profile directly, head over to [docs](docs/guides/starting-contribution/getting-started.mdx).

Check out the [contribution guidelines](#contributing-guidelines) before contributing.

## Contribution guide 🤝

### Installation 🚧

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

1. Fork the repo into your account 🍴
   ![Fork Image](https://i.imgur.com/mNw6zxu.png)
2. Clone the project into your local machine 🖥️

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

3. Navigate the folder 📂

```sh
cd gitopener.vercel.app
```

3. Install the dependencies 📦
   > As Git Opener uses yarn package manager, it is recommended to use yarn, [install yarn][yarn-website]

```sh
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][mongodb-docs]
- Generate github token here: [GITHUB TOKEN][github-token]

5. Run the project on local machine

```sh
yarn dev
```

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

## Contributing Guidelines 📜

Thank you for considering to contribute to this project.

### What do I need to know to contribute? 🤔

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](https://reactjs.org/docs/getting-started.html)
- [NextJS Documentation](https://beta.nextjs.org/docs)
- [Typescript Documentaion](https://www.typescriptlang.org/docs/)
- [TailwindCSS Docs](https://tailwindcss.com/docs/installation)

### How to make a Contribution? 🤝👩‍💻👨‍💻

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][contributing] file before contributing. 📖

## 📝 License

View [Project License][license]

This project is licensed under the terms of the [MIT license](https://opensource.org/license/mit/). The MIT license is a permissive free software license that allows you to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the software. It is a simple and short license that is compatible with most open source licenses and is widely used in the open source community.

The MIT license includes a disclaimer of liability, meaning that the project's contributors cannot be held liable for any damages that may arise from the use of the software. It also requires that any copies or modifications of the software include the same license terms and copyright notice as the original software.

## Thanks to all the Contributors ❤️

## Your Support means a lot

Give a ⭐ to the project if you liked it. 😊

[yarn-website]: https://classic.yarnpkg.com/lang/en/docs/install/#debian-stable
[mongodb-docs]: https://www.mongodb.com/docs/compass/current/connect
[github-token]: https://github.com/settings/tokens
[contributing]: https://github.com/pbclife/gitopener.vercel.app/blob/main/CONTRIBUTING.md
[license]: https://github.com/pbclife/gitopener.vercel.app/blob/main/LICENCE

gitopener.vercel.app

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README