Divineitu/ProxiLink

ProxiLink – A Proximity-Based Digital Ecosystem for Youth and MSMEs in Africa # ProxiLink - Connect to Opportunities Around You ProxiLink is a proximity-based digital ecosystem empowering African youth and MSMEs through location-based connections. Find nearby services, connect with vendors, and access opportunities in your community. **Repository**: github.com --- ## 📋 Table of Contents - Features - Tech Stack - Prerequisites - Installation & Setup - Environment Variables - Database Setup - Running the Project - Building for Production - Deployment - Project Structure - Contributing --- ## ✨ Features - 🗺️ **Location-based service discovery** with interactive maps - 👤 **Multi-role authentication** (User, Vendor, Admin) - 💬 **Real-time messaging** between users and vendors - ⭐ **Reviews and ratings** system - 📱 **Push notifications** support - 🔍 **Advanced filtering** by distance, category, and price - 📊 **Vendor analytics dashboard** - 🌙 **Dark mode** support - 📱 **Fully responsive** mobile-first design --- ## 🛠️ Tech Stack - **Frontend**: React 18.3.1 + TypeScript - **Build Tool**: Vite 5.4.19 - **Styling**: Tailwind CSS + shadcn/ui - **Backend**: Supabase (PostgreSQL) - **Authentication**: Supabase Auth - **Maps**: Leaflet + OpenStreetMap / Google Maps API (backend) - **State Management**: TanStack Query (React Query) - **Routing**: React Router v6 - **Icons**: Lucide React - **Deployment**: Vercel --- ## 📦 Prerequisites Before you begin, ensure you have the following installed: - **Node.js** (v18 or higher) - Download - **npm** (v9 or higher) - comes with Node.js - **Git** - Download - **Supabase Account** - Sign up - **Google Maps API Key** (optional, for maps) - Get API Key --- ## 🚀 Installation & Setup ### Step 1: Clone the Repository ```bash git clone github.com cd ProxiLink ``` ### Step 2: Install Dependencies ```bash npm install ``` ### Step 3: Set Up Environment Variables Create a `.env` file in the root directory: ```bash # Copy the example envir …