kigsCo/karibu

Services-discovery app for tourists, expats and newcomers to Kenya: verified businesses across 13 categories in five cities, reviews, editorial guides and a merchant dashboard. React + Vite frontend with a Supabase backend scaffold. # Karibu > A local guide, for newcomers. Karibu is a services-discovery app for tourists, expats, and newcomers to Kenya — built to answer the questions every visitor asks in their first week: *Where can I get my nails done? Which restaurant won't disappoint? Is this neighbourhood safe after dark? How does M-Pesa actually work?* This repository contains the React frontend prototype, editorial guide content, and the structure for the merchant dashboard. The production backend is now scaffolded in-repo under `supabase/` (Postgres schema, RLS, edge functions, seed data), with full build context for Claude Code in `CLAUDE.md` and `docs/`. The backend can alternatively be wired via Lovable — see `docs/LOVABLE_DEPLOYMENT.md`. ## What's in the app - **Service discovery** across 13 categories — salons, restaurants, rides, cafés, pharmacies, gyms, and more — in Nairobi, Mombasa, Naivasha, Kisumu, and Nakuru. - **Karibu Recommended** — a verified-businesses tier driven by reviews, not advertising spend. - **Review system** with star ratings, country-tagged reviewers, service tags, and a rating-distribution view. Low-rated businesses enter a 60-day improvement window before being unlisted. - **Ask Karibu AI** — a conversational assistant that only recommends verified businesses from the real directory. - **Editorial guides library** — long-form pieces on staying safe, choosing neighbourhoods, using M-Pesa, transport, culture, and health. - **Merchant dashboard** — rating trends, category rank, activity metrics, review theme extraction, and subscription status. ## Tech stack | Layer | Tech | |---|---| | Frontend | React 18, Vite, Tailwind CSS, React Router | | Icons | lucide-react | | Typography | Instrument Serif (display), Plus Jakarta Sans (body) | | Backend (planned) | Supabase — Postgres, Auth, Edge Functions | | AI | Anthropic Claude Sonnet 4.6, proxied via Supabase Edge Functions | | Deployment | Lovable (preview), Vercel or Netlify (production) | ## Getting star …