Sinew is a plug-and-play app architecture: response mapping, results, a coded error model, paging, presentation base classes, an HTTP client with token refresh, secure storage, and developer tools. This repository is the Dart and Flutter implementation.
The design and the full documentation live in the umbrella repository, srctool/sinew.
| Package | Kind | Holds |
|---|---|---|
sinew_models |
Dart | Domain, Remote, Entity, envelope bases, paging shapes, ViewState, Result |
sinew_exception |
Dart | SinewException types, handlers, processCall, CrashReporter, Localizer |
sinew_paging |
Dart | Pager, PagingState, LoadType |
sinew_presentation |
Dart | StateEffectHandler, EventActionHandler, EffectEmitter |
sinew_l10n |
Flutter | English and Indonesian for the local error keys (generated, committed) |
sinew_riverpod |
Flutter | notifier mixins, hooks, AsyncValue conversions |
sinew_riverpod_providers |
Flutter | ready providers for network, storage and security |
sinew_network |
Flutter | SinewHttp (Dio), the auth layer, processApiCall, retry, polling |
sinew_security |
Flutter | FieldCipher, BiometricVault (a plugin with native Android and iOS code) |
sinew_storage |
Flutter | SecureStore, KeyValueStore, processStorageCall, pagedQuery |
sinew_testing |
Flutter | fakes and test helpers (dev dependency only) |
sinew_camouflage |
Flutter | PagingState.toCamo() for Camouflage's CamoPagedList |
sinew_devtools, sinew_devtools_ui |
Flutter | developer tools, compiled out of production builds |
Status: pre-1.0, not published yet. The API may change before 1.0.
- Implemented:
sinew_models,sinew_exception,sinew_l10n,sinew_paging,sinew_presentation,sinew_riverpod,sinew_riverpod_providers,sinew_network,sinew_security,sinew_storage,sinew_testing. - In progress:
sinew_camouflageand the example list screen. - Planned for 1.1:
sinew_devtools,sinew_devtools_ui(placeholders for now).
See the roadmap.
dart pub global activate melos
flutter pub get # resolves the whole pub workspace
melos run analyze
melos run graph # tool/check_graph.dart against tool/sinew_graph.txt
melos run test
melos run l10n # regenerate sinew_l10n after editing its ARB files, then commit the outputApache 2.0, see LICENSE.