Thank you for your interest in contributing to FlutterFolio! We welcome contributions from everyone. Whether you're fixing a bug, improving the documentation, or adding a new feature, your contributions are appreciated.
Before sending your pull requests, make sure to read these guidelines:
-
Familiarize yourself with the project by exploring the app and understanding its structure.
-
Choose an issue from the Issues section to work on or create a new issue if you have an improvement in mind.
-
Fork the repository and clone it to your local machine.
Follow these steps to contribute to FlutterFolio:
-
Fork the Repository: Click the "Fork" button at the top right of the repository's page to create your fork.
-
Clone Your Fork: Clone your forked repository to your local machine using
git clone
. -
Create a Branch: Create a new branch for your contribution with a meaningful name. For example, if you're fixing a bug related to widget buttons, create a branch named
fix-widget-button-bug
. -
Make Changes: Make your changes in the code, following the project's guidelines.
-
Commit Your Changes: Commit your changes with a clear and concise message describing your work.
-
Push Changes: Push your changes to your forked repository on GitHub.
-
Create a Pull Request (PR): Create a PR from your branch to the
main
branch of the original repository. Ensure that your PR includes a clear description of the changes you made. -
Review and Feedback: Be prepared for feedback and discussions on your PR. Make necessary adjustments based on feedback.
-
PR Approval: Once your PR is approved by a maintainer, it will be merged into the project.
Please adhere to the following guidelines when submitting a PR:
-
Fill out the PR Template with relevant information.
-
Ensure your code follows the Flutter style guide.
-
Your work should be original, and you must comment your code where necessary.
-
Include issue numbers in your commit messages (e.g., "Fixes #123").
-
Your solution should be better in terms of performance and other parameters compared to the previous work, if applicable.
If you need help with Git, GitHub, or Flutter, here are some resources to get you started:
If you have any questions or need assistance, don't hesitate to reach out to the project admins or mentors. We're here to help you make your contribution a success!
π π π Happy Contributing! π π π