Flutter
一個使用 RiverPod、Dio、go_router、Freezed 並透過 very_good_cli 建立的 Flutter 模板專案
- 星標
- 668
- 分支
- 111
- 最近推送(UTC)
- 2023年4月4日
- 專案狀態
- 未封存
原始 README
以下為英文專案原文快照,最新內容請造訪 GitHub。
Flutter Boilerplate
A boilerplate project for Flutter using RiverPod, Dio, go_router, Freezed and generated with very_good_cli.
This is a very simple Boilerplate application, this has following features.
- User can Sign In and Up
- After signing in he can see a list of items
It uses a mock json server which doesn't store or validate anything, so for signing in/up any email, password will simply work.
RiverPod was used for state management, but there's an old implementation with Flutter bloc as well, you may check out bloc branch, though that branch doesn't have many of the latest changes.
Getting Started 🚀
You can go through this Flutter Starter Pack.
This project contains 3 flavors:
- development
- staging
- production
To run the desired flavor either use the launch configuration in VSCode/Android Studio or use the following commands:
# Development
$ flutter run --flavor development --target lib/main_development.dart
# Staging
$ flutter run --flavor staging --target lib/main_staging.dart
# Production
$ flutter run --flavor production --target lib/main_production.dart
*Flutter Boilerplate works on iOS, Android, and Web.
Use MakeFile / Derry to avoid writing your own scripts.
You can run all these scripts manually or could use MakeFile / Derry and maintain a file, where you can define all those scripts and run in a very convinient way. All the scripts for this project is defined here derry scripts and makefile scripts
Example:
run make watch or derry watch instead of
flutter pub run build_runner watch --delete-conflicting-outputs
run make build or derry build instead of
flutter pub run build_runner build --delete-conflicting-outputs
or run make build_apk_dev or derry build_apk_dev instead of
flutter build apk --flavor development -t lib/main_development.dart
Running Tests 🧪
To run all unit and widget tests use the following command:
$ flutter test --coverage --test-randomize-ordering-seed random
To view the generated coverage report you can use lcov.
# Generate Coverage Report
$ genhtml coverage/lcov.info -o coverage/
# Open Coverage Report
$ open coverage/index.html
Working with Translations 🌐
Adding Strings
- To add a new localizable string, open the
app_en.arbfile atassets/land/arb/en.json.
{
"home" : "Home",
"loading" : "Loading",
"email" : "Email",
"password" : "Password",
"name" : "Name",
"sign_in" : "Sign In",
"sign_up" : "Sign Up"
}
- After adding new
import 'package:easy_localization/easy_localization.dart';
@override
Widget build(BuildContext context) {
return Text("helloWorld".tr());
}
Same implementation in other platforms
TODO
- Updating it on daily basis as much as possible, work in progess[WIP].
Found this project useful :heart:
- Support by clicking the :star: button on the upper right of this page. :v:
Find me at
License
分類
使用的依賴
依賴清單 24 項
- flutter
{"sdk":"flutter"} - flutter_localizations
{"sdk":"flutter"} - cupertino_icons
^1.0.2 - flutter_riverpod
^2.3.0 - riverpod_annotation
2.0.0 - dio
^5.0.1 - pretty_dio_logger
^1.3.1 - flutter_secure_storage
7.0.1 - shared_preferences
^2.0.15 - google_fonts
^4.0.1 - lottie
^2.2.0 - connectivity_plus
^3.0.2 - flutter_dotenv
^5.0.2 - go_router
^6.0.3 - easy_localization
3.0.2-dev.5 - json_serializable開發依賴
— - go_router_builder開發依賴
any - build_runner開發依賴
any - build_verify開發依賴
any - flutter_gen_runner開發依賴
— - freezed開發依賴
^2.2.1 - riverpod_generator開發依賴
2.0.0 - import_sorter開發依賴
^4.6.0 - very_good_analysis開發依賴
4.0.0+1
所在榜單
如何選擇適合專案的儲存庫?
先依使用情境篩選,再比較專案活躍情況,最後到原始儲存庫確認使用要求。
- 透過儲存庫名稱、作者或描述搜尋,再依技術分類縮小範圍。
- 綜合星標、分支與最近推送比較專案;星標反映社群關注,不保證品質。
- 使用前在 GitHub 確認 README、授權條款與 Issues。
來源與維護
“A repository is the most basic element of GitHub.”
GitHub Docs — About repositories ↗