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 ↗