The Court Connect is a full-stack Flask web application that connects basketball enthusiasts with basketball courts around the world. Users can register, log in, and search for basketball courts via the Google Maps API. They can then save their favorite courts to their profile and rate them.
Google Maps Javascript API: https://developers.google.com/maps/documentation/javascript
Google Maps Places API (New): https://developers.google.com/maps/documentation/places/web-service/text-search
Google Maps Geocoding API: https://developers.google.com/maps/documentation/javascript/geocoding
- User Authentication & Profile Management
- Basketball Court Search & Mapping
- Save, Manage, & Rate Favorite Courts
- Clone the Repository & Setup Virtual Environment
git clone https://github.com/yourusername/the-court-connect.git
cd the-court-connect
- Create and Activate a Virtual Environment
python -m venv venv
source venv/bin/activate # On Windows use: venv\Scripts\activate
- Install Dependencies
pip install -r requirements.txt
- Configure Environment Variables
- Create a .env file in the project root with the following variables
SECRET_KEY=your_secret_key
GOOGLE_MAPS_API_KEY=your_google_maps_api_key
- Set Up the Database
- Ensure that you have PostgreSQL installed and create the development database
createdb basketball_court_finder_db
- Start the Flask development server
flask run
- Visit http://localhost:5000 to access the application.
Back-End Tests
- Run the Pytest suite to verify back-end functionality
pytest -v
Front-End Tests
- Open the
SpecRunner.htmlfile in your browser to run the Jasmine tests for front-end JavaScript functions.
The Court Connect is deployed on Render using the free tier, which spins down after 15 minutes of inactivity. To keep the app responsive, UptimeRobot is set up to ping the site every 14 minutes to prevent cold starts. The PostgreSQL database is hosted on Neon, providing a serverless, always-on backend for persistent data storage.
- 🌍 Render: Cloud application hosting platform
- 🗄️ Neon – Serverless PostgreSQL database
- 🔄 UptimeRobot: Keep-Alive Service (pings every 14 min)
This project is licensed under the MIT License.
