feat: add api docs

2026-07-30 11:04:42 -04:00
parent 09daf6d511
commit fedd000efc
2 changed files with 670 additions and 1 deletions
@@ -1,4 +1,4 @@
-.PHONY: build_local docker_build_local docker_build_release_dev docker_build_release_latest build_tailwind legacy_tailwind dev dev_backend dev_frontend dev_noauth clean tests
+.PHONY: build_local docker_build_local docker_build_release_dev docker_build_release_latest build_tailwind legacy_tailwind dev dev_backend dev_frontend dev_noauth clean tests docs

 DEV_ENV = GIN_MODE=release \
 	CONFIG_PATH=./data \
@@ -56,6 +56,10 @@ dev_frontend:
 dev_noauth:
 	DISABLE_AUTH=true DISABLE_AUTH_USER=$(DEV_USER) $(MAKE) dev

+docs:
+	mkdir -p docs
+	npx -y @redocly/cli@latest build-docs api/v1/openapi.yaml -o docs/api.html
+
 clean:
 	rm -rf ./build