n8r/fartstack
Template
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
76ea825509
fartstack/README.md

1.8 KiB
Raw Blame History

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, 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:
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

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/