{"id":13549949,"url":"https://github.com/VictorUvarov/provider_architecture_template","last_synced_at":"2025-04-02T23:31:26.459Z","repository":{"id":54289398,"uuid":"201681216","full_name":"VictorUvarov/provider_architecture_template","owner":"VictorUvarov","description":"A production ready flutter application template for the provider architecture.","archived":true,"fork":false,"pushed_at":"2020-10-23T02:44:31.000Z","size":1161,"stargazers_count":165,"open_issues_count":12,"forks_count":55,"subscribers_count":22,"default_branch":"master","last_synced_at":"2024-11-03T19:37:24.741Z","etag":null,"topics":["architecture","boilerplate-front-end","dart","flutter","flutter-demo","flutter-examples","provider-architecture"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/VictorUvarov.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-08-10T20:46:27.000Z","updated_at":"2024-08-31T17:38:20.000Z","dependencies_parsed_at":"2022-08-13T11:10:10.367Z","dependency_job_id":null,"html_url":"https://github.com/VictorUvarov/provider_architecture_template","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VictorUvarov%2Fprovider_architecture_template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VictorUvarov%2Fprovider_architecture_template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VictorUvarov%2Fprovider_architecture_template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VictorUvarov%2Fprovider_architecture_template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VictorUvarov","download_url":"https://codeload.github.com/VictorUvarov/provider_architecture_template/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246910960,"owners_count":20853652,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["architecture","boilerplate-front-end","dart","flutter","flutter-demo","flutter-examples","provider-architecture"],"created_at":"2024-08-01T12:01:27.360Z","updated_at":"2025-04-02T23:31:24.191Z","avatar_url":"https://github.com/VictorUvarov.png","language":"Dart","funding_links":[],"categories":["Dart"],"sub_categories":[],"readme":"# provider_start\n\nA production ready flutter application template for the provider architecture.\n\n## Inspiration\n\n- This project is a starting point for a Flutter application using the provider architecture.\n- This project heavily uses the flutter tutorials and snippets of the filled stacks YouTube channel.\n- Feel free to send in Pull Requests to improve the application.\n\nFilled Stacks Links:\n\n- [Filled Stacks Website](https://www.filledstacks.com/)\n- [Filled Stacks Github Tutorials](https://github.com/FilledStacks/flutter-tutorials)\n- [Filled Stacks YouTube](https://www.youtube.com/channel/UC2d0BYlqQCdF9lJfydl_02Q)\n- [Filled Stacks Slack](https://filledstacks.slack.com/join/shared_invite/enQtNjY0NTQ3MTYwMzEwLTJjZmU0ODRhOTA5ZGE3MTUxOTUzODdlNzFjMDg0ZGU4ZDQzMzVlMDQ0MzYxZWNhOWViOGI1NjZiZDE1YTQ3NGM)\n\n## Setup\n\nGenerate your platform specific folders with kotlin/swift\n\n```bash\nflutter create .\n```\n\nor generate your platform specific folders with objc/java\n\n```bash\nflutter create -i objc -a java .\n```\n\nSince this project uses 3 locales add this to your info.plist\n\n```plist\n\u003ckey\u003eCFBundleLocalizations\u003c/key\u003e\n\u003carray\u003e\n    \u003cstring\u003ees\u003c/string\u003e\n    \u003cstring\u003eru\u003c/string\u003e\n    \u003cstring\u003een\u003c/string\u003e\n\u003c/array\u003e\n```\n\nGenerate the launcher icon (optional)\n\n```bash\nflutter pub get \u0026\u0026 pub run flutter_launcher_icons:main\n```\n\n## Folder structure\n\n```bash\n.\n├── core\n│   ├── constant\n│   ├── data_sources\n│   ├── enums\n│   ├── exceptions\n│   ├── localization\n│   ├── managers\n│   ├── mixins\n│   ├── models\n│   ├── repositories\n│   ├── services\n│   └── utils\n└── ui\n    ├── shared\n    ├── views \u0026 viewModels\n    └── widgets\n```\n\n## Features\n\n### Master branch\n\n- [x] bottom navigation bar\n- [x] intuitive UI router\n- [x] script for auto formatting on commits\n- [x] localization\n- [x] validation mixin for forms\n- [x] json serialization\n- [x] auth service example\n- [x] dialog service\n- [x] connectivity service\n- [x] hardware info service\n- [x] http service\n- [x] navigation service\n- [x] key storage service\n- [x] local storage service (NoSQL)\n- [x] system light/dark theme support\n- [x] platform adaptive widgets\n- [x] life cycle manager to start/stop background services\n- [x] app settings launcher\n- [x] custom fonts\n- [x] custom app icons\n- [x] custom native splash screen\n- [x] snack bar service\n- [x] unit tests\n- [x] view model tests\n- [ ] widget tests\n- [ ] responsive views\n\n### Geolocator branch\n\n- [x] location service\n- [x] location permission service\n\n## Example pages included\n\n- Home View (Renders a list of posts fetched from JSON place holder API)\n- Login View (Form that simulates user login and form validation)\n- Main View (View that handles tab navigation)\n- Splash View (Initial loading screen that uses flare animations)\n- Post Details (Dynamic view that loads the post's user information)\n- Settings View (Example view that launches app settings and signs out user)\n\n## Getting started\n\n- run `chmod +x ./format.sh \u0026\u0026 ./format.sh` to setup git pre commit formatting or\n- run `chmod +x ./manual_format.sh` and run `./manual_format.sh` whenever you want to format the dart code\n- run `flutter packages pub run build_runner build --delete-conflicting-outputs` if you plan to add/change any serializers once\n- run `flutter packages pub run build_runner watch --delete-conflicting-outputs` if you plan to add/change any serializers multiple times\n- Setup [derry](https://pub.dev/packages/derry) (optional) to avoid typing the above commands manually\n\n## Adding support for another language\n\n- Find the language local code from here [codes](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)\n- Inside of `lib/local_setup.dart` add the local code to `supportedLocalCodes`\n- Add the local code to the `CFBundleLocalizations` array in `ios/Runner/Info.plist`\n- Create a `\u003clocal\u003e.json` file under assets/lang/ and fill out every value for your language\n- Run `flutter clean` inside you lib apps directory if flutter complains\n- There is also a different way to implement locals using the [intl](https://pub.dev/packages/intl) package. An example on how to do so can be found [here](https://github.com/flutter/website/tree/master/examples/internationalization/intl_example)\n\n## Adding app icon\n\n- Change icon `assets/images/logo.png` to another image\n- If new icon has a different path update `flutter_icons:` in the `pubspec.yaml` file\n- Run `flutter pub get` and then `flutter pub run flutter_launcher_icons:main`\n\n## Adding another route\n\n- create your view and view model in `lib/ui/views/\u003cview-folder\u003e/`\n- add your view to the list of routes in `lib/ui/router.dart`\n- generate the new router with\n\n```sh\nflutter packages pub run build_runner build --delete-conflicting-outputs\n```\n\n## Adding another model\n\n### Simple model\n\n- Create a `\u003cYOUR_MODEL\u003e.dart` under `core/models/\u003cYOUR_MODEL\u003e/\u003cYOUR_MODEL\u003e.dart`\n- Copy the `AlertRequest` from `core/models/alert_request/alert_request.dart` and replace all the class model names with `\u003cYOUR_MODEL\u003e`\n- Add your own custom getter values.\n- Add a part file. Ex: `\u003cYOUR_MODEL\u003e.g.dart` above the class\n- Run `flutter packages pub run build_runner build --delete-conflicting-outputs` to build your new model\n\n### Serializable model\n\n- Create a `\u003cYOUR_MODEL\u003e.dart` under `core/models/\u003cYOUR_MODEL\u003e/\u003cYOUR_MODEL\u003e.dart`\n- Copy the `User` from `core/models/user/user.dart` and replace all the class model names with `\u003cYOUR_MODEL\u003e`\n- Add your own custom getter values.\n- Add `\u003cYOUR_MODEL\u003e` to the list in `@SerializersFor` class constructor found under `core/models/serializer.dart`\n- Run `flutter packages pub run build_runner build --delete-conflicting-outputs` to build your new model\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FVictorUvarov%2Fprovider_architecture_template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FVictorUvarov%2Fprovider_architecture_template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FVictorUvarov%2Fprovider_architecture_template/lists"}