zaxeefix/akara

# AkaraConnect v1.0 Beta AkaraConnect is an open-source local food marketplace under ZaxeeFix Enterprise. It connects customers with Akara, Pap/Ogi/Akamu, and other local food vendors across Nigeria. This repository contains the v1.0 beta frontend and backend foundation. AkaraConnect is currently in beta; some features may be improved as pilot vendors are onboarded. ## Stack - Frontend: Next.js, React, TypeScript, Tailwind CSS - Backend: Node.js, Express.js, TypeScript - Database: PostgreSQL on Neon - ORM: Prisma - Auth: JWT access tokens, refresh tokens, bcrypt password hashing - Payments: Paystack-ready structure first - Storage: Cloudinary-ready structure - Hosting target: Render ## Quick Start ```bash npm install npm run test:static npx prisma generate npm run build npm run dev ``` Create a local `.env` from `.env.example` before running the server. Do not commit `.env`. ## Health Check ```http GET /api/health ``` ## Main API Areas - `/api/auth` - `/api/customers` - `/api/vendors` - `/api/categories` - `/api/orders` - `/api/payments` - `/api/reviews` - `/api/notifications` - `/api/admin` - `/api/search` ## Documentation - API - User Roles - Vendor Onboarding - Payments - Future Features - Environment - Security - Render Deployment - Frontend - Localization - PWA - SEO - Vercel Deployment - Deployment - Backend - Database - Testing - Integration - Maintenance - Roadmap - Production Launch Checklist - Production Readiness Audit - Backup and Recovery - Monitoring - Release Notes - Mobile App Roadmap - AI Features - WhatsApp Ordering - USSD Roadmap - Rider Module - Vendor POS and Inventory - Business Loans and Insurance - Analytics Growth - Scalability Expansion - Localization Expansion - Privacy and Ethics - Community - Beta Release - Pilot Vendor Onboarding - Support Operations - Trust and Safety - Known Limitations - Observability - Incident Response ## Security Do not commit `.env`, `.env.local`, private keys, database URLs, payment secrets, Googl …