WilliamMajanja/ShambaMatic-DreamHub

Find your Piece Of Kenya # ShambaMatic DreamHub 🌾 **Find your Piece of Kenya** — An AI-powered land intelligence and property discovery platform for the Kenyan market. Built with React, TypeScript, Vite, and Google Gemini AI. Designed for deployment on GitHub Pages. ## ✨ Features - 🗺️ **Interactive Map** — Explore land parcels across Kenya with MapLibre GL - 🤖 **AI Analysis** — Google Gemini-powered property insights and recommendations - 📊 **Data Visualization** — Charts and metrics for market trends - 🔐 **Secure Auth** — Supabase authentication integration - 📱 **Responsive Design** — Mobile-first with Tailwind CSS - ⚡ **Fast Performance** — Vite + React 18 optimized builds ## 🛠 Tech Stack | Layer | Technology | |-------|------------| | Frontend | React 18, TypeScript, Vite | | Styling | Tailwind CSS, Shadcn/UI | | Maps | MapLibre GL JS | | AI | Google Gemini API (`@google/genai`) | | Backend | Supabase (Postgres, Auth, Realtime) | | Deployment | GitHub Pages | | AI Assistant | GitHub Copilot | ## 🚀 Quick Start ### Prerequisites - Node.js 18+ - npm or yarn - Google Gemini API key (Get one free) - Supabase project (Create free) ### Installation ```bash # Clone the repository git clone github.com cd ShambaMatic-DreamHub # Install dependencies npm install # Configure environment cp .env.example .env.local # Edit .env.local with your API keys: # VITE_GEMINI_API_KEY=your_gemini_key # VITE_SUPABASE_URL=your_supabase_url # VITE_SUPABASE_ANON_KEY=your_supabase_anon_key # Start development server npm run dev ``` Open localhost in your browser. ### Build for Production ```bash npm run build # Output in ./dist — deploy to GitHub Pages, Vercel, Netlify, etc. ``` ## 📁 Project Structure ``` src/ ├── components/ # Reusable UI components ├── pages/ # Page components ├── hooks/ # Custom React hooks ├── services/ # API services (Gemini, Supabase) ├── utils/ # Utility functions ├── types/ …