The Flutter project developing under The Uplift Project.
This project is a starting point for a Flutter application.
A few resources to get you started if this is your first Flutter project:
For getting started with Flutter, you can also refer online documentation, which offers tutorials, samples, guidance on mobile development, and a full API reference.
-
Go to the project repo and fork it by clicking "Fork".
-
If you are working on Windows, download the Git Bash for Windows to get a full Unix Bash with Git Functionality.
-
Clone the repo to your system using
`git clone https://github.com/<your-github-username>/flutter`
- Navigate to the project directory.
cd flutter
- Create a new branch.
git checkout -b <your_branch_name>
-
Make changes in source code.
-
Stage your changes and commit
#Add changes to Index
git add .
#Commit to the local repo
git commit -m "<your_commit_message>"
Sync up your local repo with original repo (Upstream) before pushing your commits. This avoids unnecessary conflicts during the merge.
- Push your local commits to the remote repo.
git push -u origin <your_branch_name>
-
Create a PR !
-
Congratulations! you've made your contribution to tradewinds project.
To raise specific issues, bugs, or feature requests use this link.
- General Rule of thumb is to have 1 Widget per File, If a screen has multiple widgets break them down and put them in to their file either in the same folder or in the widgets folder.
- Each file should be a maximum of 200-300 lines. If longer than that, extract code to another widget.
- Variables, Methods, Objects to be readable
e.g. updateStatus, showConfirmButton
(Please do not use generic words. Ask your teammates if you are confused about what wordings to use.) - Reuse code. Do not duplicate code in many places. Reuse code that has been written.
- Remove unused code and unused libraries.
- File names to hyphenated. E.g. profile_screen.dart. (Please do not use ProfileScreen).
- Always use a Strongly Typed Code i.e. Every Variable should have concrete type, Don't use dynamic type for variables.
- All static values to be declared constants in lib > util.
E.g. “Action performed successfully” to be moved into lib > util > display_constants.dart
- If you are building a page, please name it with suffix, _screen.dart. If you are creating Profile Screen, then name it as
profile_screen.dart
. - If you are building a widget that is specific to only single screen then put it in to screen folder, else put it in to the widgets folder. E.g. If you are buidling a widget that will only be used in the profile screen, then put it in to the profile screen folder, else if you are building a widget that can be used more than one location, put it in the widgets folder.
- Use Standard formatting and trailing commas. For More Info, check the official Docs.