andoriyaprashant/OpSo

OpSo is a Flutter app that provides comprehensive information about various open-source programs, including Google Summer of Code, Summer of Bitcoin, Linux Foundation, and more. It allows users to explore different open-source opportunities, learn about their eligibility criteria, and access important resources.

🌟 Stars	🍴 Forks	🐛 Issues	🔔 Open PRs	🔕 Close PRs
Stars	Forks	Issues	Open Pull Requests	Close Pull Requests

License

This project is licensed under the MIT License.

Contributing to OpSo

Thank you for considering contributing to OpSo! We welcome contributions from the community to help improve the app and add new features. Below are some guidelines for contributing:

Bug Reports and Feature Requests

If you encounter any bugs or have ideas for new features, please open an issue on GitHub. Make sure to provide detailed information about the issue or feature request, including steps to reproduce the bug if applicable.

Code Contributions

We appreciate any code contributions that enhance the functionality or improve the user experience of OpSo. To contribute code, follow these steps:

1. Fork the repository to your GitHub account.
2. Clone your forked repository to your local machine.
3. Create a new branch for your feature or bug fix: git checkout -b feature-name.
4. Make your changes and ensure that the code follows the Flutter style guide.
5. Test your changes locally to ensure they work as expected.
6. Commit your changes with descriptive commit messages: git commit -m "Add feature XYZ".
7. Push your changes to your forked repository: git push origin feature-name.
8. Create a pull request against the main branch of the original repository.

Getting Started

To run the OpSo app locally, you need to have Flutter and Dart installed on your machine. Follow these steps:

1. Clone this repository:

git clone https://github.com/andoriyaprashant/OpSo.git

2. Navigate to the project's root directory:

cd OpSo

3. Install dependencies:

flutter pub get

4. Check for Flutter setup and connected devices:

flutter doctor

5. Run the app:

flutter run

---

Adding New Open Source Programs

If you would like to add information about a new open-source program to OpSo, you can contribute by:

1. Gathering comprehensive information about the program, including its objectives, eligibility criteria, application process, and important dates.
2. Creating a new screen in the app to display information about the program.
3. Adding the program to the list of options in the home screen with relevant details.
4. Testing the new feature to ensure it works correctly.

Improving Documentation

Good documentation is essential for the success of any open-source project. If you notice any areas where the documentation can be improved, feel free to make updates or additions.

---

GSSOC Logo	GSSOC 2024
	This project is part of GirlScript Summer of Code. We enthusiastically welcome community contributions to enhance OpSo.

---

Please note that by contributing to OpSo, you agree to abide by the code of conduct. We expect all contributors to uphold the principles of respect, inclusivity, and collaboration.

---