https://github.com/ser-arthur/cafe-connect-website

CafeConnect is a Flask-based open-source platform for discovering the best coffee spots with remote work-friendly amenities. Users can find nearby cafes and contribute by sharing their favorite spots, ideal for coffee enthusiasts and digital nomads seeking top workspaces on the go.
https://github.com/ser-arthur/cafe-connect-website

bootstrap cafes coffee flask python remote-work restful-api sqlalchemy web-application wifi

Last synced: about 1 month ago
JSON representation

Host: GitHub
URL: https://github.com/ser-arthur/cafe-connect-website
Owner: ser-arthur
License: agpl-3.0
Created: 2024-09-18T00:50:04.000Z (about 1 year ago)
Default Branch: main
Last Pushed: 2024-12-01T22:21:04.000Z (10 months ago)
Last Synced: 2025-03-25T11:11:21.918Z (6 months ago)
Topics: bootstrap, cafes, coffee, flask, python, remote-work, restful-api, sqlalchemy, web-application, wifi
Language: JavaScript
Homepage: https://cafe-connect.vercel.app
Size: 44.4 MB
Stars: 4
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: ReadMe.md
- License: LICENSE.txt

Awesome Lists containing this project

README

# CafeConnect

Welcome to **CafeConnect**! This project is a hub for coffee enthusiasts and remote workers, providing a platform where users can discover cafes with the best amenities for working on the go. Whether you're looking for strong WiFi, a cozy atmosphere, or a good cup of coffee, Cafe Connect is here to help you find the perfect spot.

## Features

- **User Authentication**: Secure login and registration.
- **Cafe Listings**: Browse a curated list of cafes with details on amenities, WiFi strength, and more.
- **Find Nearby Cafes**: Discover cafes in your vicinity for convenience and ease.
- **Add Cafes**: Allows users to add new cafes to the platform, contributing to a growing and diverse list of coffee spots.
- **Featured Top-Rated Cafes**: Highlights the best cafes based on user ratings and reviews.
- **API Access**: Access cafe data via a RESTful API for management and integration with other applications.

### Planned Features
Upcoming features in the future:

- **Community Reviews**: Users will be able to leave and read reviews of cafes to help others find the best spots.
- **Personalized Recommendations**: Cafe suggestions based on user preferences.
- **Interactive Map**: An interactive map to visualize cafe locations and see nearby options.
- **Cafe Gallery**: Each cafe will display a gallery of images to provide users with a visual overview of the ambiance, amenities, and more. Images will be contributed by admins and users, making the experience more community-driven.

Stay tuned!

## Tech Stack

- **Flask**: Backend framework.
- **Bootstrap & Javascript**: UI design and interactive front-end.
- **SQLAlchemy**: ORM for database management.
- **Flask-WTF**: Form handling and validation.
- **Flask-Login**: User session management.
- **SQLite**: Database for storing cafe and user data.
- **Flask-RESTful**: API creation and management.

## Getting Started

1. **Clone the Repository**
```bash
git clone https://github.com/ser-arthur/cafe-connect-website.git
cd cafe-connect-website
```

2. **Create a Virtual Environment**
```bash
python -m venv venv
source venv/bin/activate # Windows: `venv\Scripts\activate`
```

3. **Install Requirements**
```bash
pip install -r requirements.txt
```

4. **Run the Application**
```bash
python run.py
```

The application will be accessible at:
```bash
http://localhost:5000/ # localhost address may differ depending on your system configuration
```

## Live Deployment

The application is also deployed and accessible online at [CafeConnect](https://cafe-connect.vercel.app).