From 3a10668f400b75f4399fc35ed16d0f8132db3884 Mon Sep 17 00:00:00 2001 From: HumanoidSandvichDispenser Date: Wed, 6 Nov 2024 20:56:55 -0800 Subject: [PATCH] Add README.md --- README.md | 38 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..6dbce5c --- /dev/null +++ b/README.md @@ -0,0 +1,38 @@ +# availabili.tf + +Scheduling for TF2 + +## Setup (dev) + +### Frontend + +```sh +# first time setup +npm install + +npm run dev +``` + +### Backend + +In virtual environment: + +```sh +# first time setup +pip install -r requirements.txt +flask db migrate + +flask run --debug +``` + +### OpenAPI + +The backend will automatically serve its OpenAPI-compliant spec at +`/apidoc/openapi.json` which can also be viewed at `/apidoc/redoc` or +`/apidoc/swagger` or `/apidoc/scalar`. + +To generate the frontend client: + +```sh +npx openapi --input 'http://localhost:5000/apidoc/openapi.json' --output src/client +```