# fartstack

Flutter and Dart full stack template, Lovingly called FartStack

## TLDR

Dev is done all in dart, with the flutter framework as a frontend. The
backend uses [dart_frog](), a dart backend framework with a focus on developer
experience. This whole stack revolves around my Dart expertise, so its not about
being the fastest stack, but the quickest stack I can build in. Because building
a product is like a fart: You can't be sure its not crap until the follow-through.

### Installing

If you have the nix package manager and direnv setup, its as easy as running `direnv allow`, bingo bango.

If not, well, you need to setup `flutter`, `dart` (should get installed with flutter), and `dart_frog`

### Running

This codebase makes use of [RPS](https://pub.dev/packages/rps/install), just to standardize calling
various tools, like Make, but for dart.

- Frontend is started with `cd frontend` and `flutter run` (not included in rps because there are lots of cli flags I change often with flutter run)
- Backend is started with `cd backend` and `rps dev` or `dart_frog dev`
- The `build_runners` (codegen) for each subproject can all be run `cd backend` and `rps watch` for development or `rps build` for a one off codegen
  - If you dont want to bother installing rps, you can run the script directly:
```sh
dart backend/scripts/run_build_runner.dart
```

And if you dont want to run all three watchers, you can just run an individual one with
```sh
dart run build_runner watch # or other args
```

### Testing

#### Backend

End to end tests can be run with `cd backend` and `rps e2e`.

All end to end tests are located in the `backend/test_e2e/tests` folder.
There is a helper script that compiles and launches the backend and runs some end to end tests through.

#### Frontend

:|


## Frontend `./frontend/`

WIP

## Backend `./backend/`