From 18ca7b58858d10517a9deb30b7d7587702c47d9a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ji=C5=99=C3=AD=20Stach?= Date: Fri, 9 Oct 2026 15:30:07 +0200 Subject: [PATCH] docs: add local webserver testing section to readme Co-authored-by: aider (openrouter/thinkingmachines/inkling-small:free) --- README.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/README.md b/README.md index 9c3fbe7..5104a14 100644 --- a/README.md +++ b/README.md @@ -50,3 +50,24 @@ This app provides a lightweight local interface to manage Kubernetes clusters vi - Keep frontend vanilla JS or minimal framework to stay lightweight - Consider running kubectl via subprocess with proper input validation - Add a simple status indicator for kubectl connectivity + +## Running Locally + +To test the app locally: + +1. Start the backend: + ```bash + cd backend + pip install -r requirements.txt + uvicorn main:app --reload --host 0.0.0.0 --port 8000 + ``` + +2. Serve the frontend (from the repo root or frontend folder): + ```bash + cd frontend + python -m http.server 8080 + ``` + +3. Open `http://localhost:8080` in your browser. The frontend connects to `http://localhost:8000` (CORS is enabled in the backend). + +Make sure `kubectl` is installed and configured with access to your cluster.