akamara2002/cafia-africa

# CAFIA Africa - Financial Inclusion Platform Center for Africa Financial Inclusion and Advancement (CAFIA) - An integrated solutions platform for financial inclusion and economic resilience across Africa. ## 📁 Project Structure This project is organized into separate frontend and backend directories: ``` cafia-africa/ ├── frontend/ # Next.js application ├── backend/ # Python scripts & data import └── RUN_PROJECT.md # Complete setup and run instructions ``` ## 🚀 Quick Start ### Frontend (Next.js) ```bash cd frontend npm install # First time only npm run dev # Start development server ``` Access at: localhost ### Backend (Excel to PostgreSQL) ```bash cd backend ./scripts/run_import.sh # Import Excel data to PostgreSQL ``` **📚 For detailed instructions, see RUN_PROJECT.md** --- ## Quick Start - Local Development (Legacy Instructions) ### Prerequisites - Node.js 18+ (Download: nodejs.org) - npm or yarn package manager - Python 3.9+ (for backend) - PostgreSQL (for data import) ### Installation Steps 1. **Download the Project** - Click the "Download ZIP" button in v0 or clone from GitHub - Extract the ZIP file to your preferred location 2. **Frontend Setup** \`\`\`bash cd frontend npm install npm run dev \`\`\` 3. **Backend Setup (Optional - for data import)** \`\`\`bash cd backend ./scripts/run_import.sh \`\`\` 4. **Open in Browser** - Navigate to localhost - The site will auto-reload when you make changes ### Build for Production \`\`\`bash # Test production build locally npm run build npm start # Access at localhost \`\`\` **Build checks:** - ✓ No TypeScript errors - ✓ All images optimized - ✓ Routes generated correctly - ✓ API routes functional ## Deployment Guide ### Method 1: Deploy from v0 Directly to Vercel (Fastest) 1. **Publish from v0** - Click the "Publish" button in the top right corner of v0 - v0 will automatically create a Vercel deployment - …