From dce2175c1c19b41be3f1a114ede72fe3ae8e1e3f Mon Sep 17 00:00:00 2001 From: Nathan Woodburn Date: Mon, 26 May 2025 13:08:19 +1000 Subject: [PATCH] feat: Update README --- README.md | 69 +++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 67 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 2f77bf4..bf1f2dc 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,68 @@ -# python-webserver-template +# Kite Watch -Python3 website template including git actions \ No newline at end of file +Kite Watch is a web application that helps kite enthusiasts find and share great places to fly kites. Users can submit locations with ratings and notes about wind conditions, accessibility, and other relevant information. + +## Features + +- Submit kite flying locations with a name, notes, and a 1-5 star rating +- Browse locations added by other users +- Input validation and profanity filtering to maintain quality content +- Mobile-friendly responsive design + +## Technologies Used + +- **Backend**: Python, Flask +- **Frontend**: HTML, CSS, JavaScript +- **Database**: Simple JSON file storage +- **Deployment**: Docker support + +## Setup + +### Local Development + +1. Clone the repository: + ``` + git clone https://github.com/username/kite-watch.git + cd kite-watch + ``` + +2. Create a virtual environment and install dependencies: + ``` + python -m venv .venv + source .venv/bin/activate # On Windows use: .venv\Scripts\activate + pip install -r requirements.txt + ``` + +3. Run the application: + ``` + python main.py + ``` + The application will be available at http://localhost:5000 + +### Using Docker + +1. Build and run using Docker: + ``` + docker build -t kite-watch . + docker run -p 5000:5000 -v $(pwd)/data:/data kite-watch + ``` + +2. Use pre-built Docker image: + ``` + docker pull git.woodburn.au/nathanwoodburn/kite-watch:latest + ``` + + Then run it with: + ``` + docker run -p 5000:5000 git.woodburn.au/nathanwoodburn/kite-watch:latest + ``` + +## Configuration + +The application can be configured with environment variables: +- `WORKERS`: Number of Gunicorn workers (default: 1) +- `THREADS`: Number of threads per worker (default: 2) + +## License + +This project is licensed under the GNU Affero General Public License v3.0 - see the LICENSE file for details. \ No newline at end of file