generated from nathanwoodburn/python-webserver-template
This commit is contained in:
69
README.md
69
README.md
@@ -1,3 +1,68 @@
|
|||||||
# python-webserver-template
|
# Kite Watch
|
||||||
|
|
||||||
Python3 website template including git actions
|
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.
|
||||||
Reference in New Issue
Block a user