The-POS/The-POS-Flutter

GitHub issues GitHub PR GitHub Forks

Contributors

GitHub Contributors

Your Repository's Stats

About ThePOS

An open-source initiative that belongs to Gaza Tech Community to encourage the Gazans developer to share their knowledge with each other and contribute to the open-source world.

Built With

• Flutter version: Flutter 2.5.0
• Architecture: Clean Architecture
• State Management: GetX
• Route Management: GetX
• Localization: GetX

We chose GetX as the main State Management for this project so we can balance the experience of the contributors, GetX will be easier for beginners to catch and at the same time, we ensure the separation of the business logic from the presentation correctly and avoid boilerplate code.

For more info about GetX check this link

Getting Started

You can contribute right now by just forking this project and adding your magic to this project that is in continuous growth. If it is your first time contributing you can check Mohammed Sufian's video explaining how to do your first Pull Request.

Watch the video

Main concepts

• Offline first support
• API Driven development
• Total separation between frontend and backend
• Use OpenAPI and Mocking to decouple teams
• Use Github and Kanban project board

Contributing

Thank you for considering contributing to thePOS project! Feel free to contribute in any way you want.

Contributions are what makes the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Important Resources for Contributing

1. API Specification here
2. Tablet/Desktop Design here
3. Mobile Design here

License

ThePOS is open-sourced software licensed under the MIT license.