Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aloisdeniel/dart-fullstack
Experimenting architectures for developing all layers of a typical application in Dart.
https://github.com/aloisdeniel/dart-fullstack
api dart flutter mobile rest website
Last synced: 3 months ago
JSON representation
Experimenting architectures for developing all layers of a typical application in Dart.
- Host: GitHub
- URL: https://github.com/aloisdeniel/dart-fullstack
- Owner: aloisdeniel
- License: mit
- Created: 2018-05-27T15:26:44.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2018-10-22T10:05:46.000Z (about 6 years ago)
- Last Synced: 2024-05-01T13:52:09.176Z (8 months ago)
- Topics: api, dart, flutter, mobile, rest, website
- Language: Dart
- Homepage:
- Size: 160 KB
- Stars: 26
- Watchers: 4
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Fullstack with Dart
An example that uses Dart language for developing all the application layers. This experiments purpose is also to find an approach to share a maximum of logic by applying interresting architectural patterns.
## Server (api)
### GRPC Specifications
The server is fully based on [GRPC](https://grpc.io/) and [Protocol Buffers](https://developers.google.com/protocol-buffers/). Basicaly, this technology allows you to specify your Services (and its messages) format through a dedicated language ([proto3](https://developers.google.com/protocol-buffers/docs/proto3)).
The [api](./api) project contains the type and service specifications. A set of Dart classes are generated into the [generated](./api/generated) folder by executing the following command (make sure you installed [protoc](https://github.com/google/protobuf/releases) and the [dart plugin](https://github.com/dart-lang/dart-protoc-plugin)):
```bash
> cd api/lib
> protoc --dart_out=grpc:generated --proto_path=/api/lib -Iprotos tasks.proto
```
This will generate a [TaskServiceClient](./api/lib/generated/generated.tasks.pbgrpc.dart) that will be used from the client side and a [TaskServiceBase](./api/lib/generated/generated.tasks.pbgrpc.dart) that is the abstract class in which the server must implement the actual logic.
### Service implementation
[A basic service implementation](./server/lib/services/tasks.dart) that keeps history in memory is provided.
### Running
To start the server, execute the following command:
```bash
> dart server/bin/server.dart
```
## Client (mobile, web)
### Shared
All the application state is shared through a reactive architecture based on `Stream`, `StreamBuilder`, `InheritedWidget` and reactive extensions.
To learn more, watch [Build reactive mobile apps with Flutter (Google I/O '18)](https://www.youtube.com/watch?v=RS36gBEp8OI).
Basically, all the application logic is stored in a [TaskBloc](./app/app_shared/lib/tasks_bloc.dart) that exposes various input and output streams.
### Mobile *(Flutter)*
The mobile is composed of [several widgets](./app/app_mobile/lib/widgets) which subscribe to the global [TasksBloc](./app/app_shared/lib/tasks_bloc.dart) container widget.
The [TasksProvider](./app/app_mobile/lib/tasks_provider.dart) allows any widget to access to the unique [TasksBloc](./app/app_shared/lib/tasks_bloc.dart) instance.
### Web *(Angular-Dart)*
*WIP*