rex is a Really EXcellent way to develop webapps.
First, (install Docker)[https://docs.docker.com/install/].
Next, run
npm run docker:db:sync:force
npm start
To get a development environment. The first time you run these commands we'll build a bunch of docker images and do a bunch of initialization - please be patient.
Visit (http://localhost:8080)[http://localhost:8080] to see your running app.
npm run db:sync-force # you only need this the first time you run the app
npm start
This will spin the whole system up in docker containers. Code changes
in either the api
or ui
projects will be automatically reloaded
(though there is usually at least a short delay).
npm run storybook
This will spin up storybook
on your machine (without Docker). Watch
the console for instructions on accessing the Story Book. Code changes
in the ui
project will be automatically reloaded.
npm run docker:api:watch:test
This will run the api
project tests and then automatically re-run
them when code in the api
project changes. API development should be
primarily test-driven.
npm test
npm db:sync-force
Add a new section with the thing you'd like to be able to do and TODO: in the body. Submit a PR. Ask someone who might know how to do the thing to review and update the PR!
This error sometimes occurs when first running the stack. To fix this, try signing out of your Docker desktop account.