What is "Town Square"? Town Square aims to capture value for small businesses by bridging the gap between clients and producers. Our web application empowers local businesses, non-profits or foundations to source products from local farms and producers while sustainably supporting the local economy.
- Frontend: React 19/Vite, Leaflet
- Backend: Python 3.11, Flask
- Infrastructure: Docker & Docker Compose
- CI/CD: GitHub Actions
- Evan Bowness
- Graeme Bradford
- Patrick Rinn
- Patrik Balazsy
- Amber Hawker
To get a local copy up and running, follow these steps.
You will need Docker installed on your machine.
- Clone the repository
git clone https://github.com/evanbones/GIT-2026.git
cd GIT-2026- Start the development environment Run the following command from the root directory to build and spin up both the Flask backend and React frontend:
docker-compose up --build- View the application
- Frontend (Vite/React): Open
http://localhost:5173in your browser. - Backend (Flask API): Available at
http://localhost:8000. - Docs (Swagger): Available at
http://localhost:8000/docs.
- (Optional) Install pre-commit hooks for automatic linting/formatting
- Once installed, pre-commit will automatically run before every git commit.
pre-commit install
To check code for formatting/linting:
# In the backend/ directory:
# Check for linting issues
ruff check .
# Auto-fix what can be fixed automatically
ruff check . --fix
# Format all code
ruff format .
# Verify everything passes
ruff check .
ruff format --check .