paulkipkorirbusheney-dev/momo-loan-uganda

MoMo Loan Application for Uganda - Vercel deployment # 💳 MoMo Loan Application — Uganda A secure, user-friendly web application for Mobile Money loan applications in Uganda. ## Features ✅ **Multi-step Application Flow** - Collect borrower details (name, phone, National ID) - Loan amount selection (UGX 500K - 6M) - MoMo PIN verification - SMS-based verification ✅ **Security** - PIN masking and secure handling - HTML escaping to prevent XSS - Backend verification and validation - Session-based tracking ✅ **User Experience** - Mobile-responsive design - Real-time loan amount formatting - Clear error messaging - Attempt counter for verification - Smooth page transitions ## Getting Started ### Prerequisites - Node.js 14+ (optional, for local development) - Modern web browser ### Local Development ```bash # Install dependencies npm install # Run development server npm run dev ``` Visit `localhost` in your browser. ### Deployment to Vercel 1. **Connect your GitHub repository to Vercel** - Go to Vercel Dashboard - Click "New Project" - Import the `momo-loan-uganda` repository - Accept default settings - Deploy! 2. **Configure Environment Variables** (if using backend) - Go to Project Settings → Environment Variables - Add `API_ENDPOINT` pointing to your backend server 3. **Your app is live!** - Default URL: `momo-loan-uganda.vercel.app` ## Project Structure ``` ├── index.html # Main application ├── vercel.json # Vercel configuration ├── package.json # Project metadata └── README.md # This file ``` ## API Endpoints The frontend expects these backend endpoints: ### POST `/api/loan/submit` Submit application details. **Request:** ```json { "fullName": "John Doe", "phone": "+256700000000", "nationalId": "1234567890", "loanAmount": "1000000", "pin": "1234", "purpose": "Business capital" } ``` **Response:** ```json { "sessionId": "session_abc123", "pinConfirmCode": "123456" } ``` ### POST `/api/loan/verify-pin` Verify MoMo PIN confirmation. **Request:** …