Monexa

Nigeria's fastest crypto-to-naira conversion, money transfers & bill payments platform.

Built with React (frontend) + Node.js/Express (backend).

---

🚀 Quick Start in VS Code

1. Install dependencies

Open the project folder in VS Code, then open two terminals:

Terminal 1 — Server:

cd server
npm install
npm run dev

Terminal 2 — Client:

cd client
npm install
npm start

The app opens automatically at http://localhost:3000 The API runs at http://localhost:5000

---

📁 Project Structure

monexa/
├── client/               # React frontend
│   ├── public/
│   └── src/
│       ├── components/   # Layout, Navbar
│       ├── pages/        # Home, Convert, Transfer, Bills, Rates, About
│       ├── App.js
│       └── index.css     # Global styles & brand tokens
├── server/               # Node.js + Express API
│   ├── index.js          # All API routes
│   └── .env              # Environment config
├── package.json          # Root scripts
└── README.md

---

🌟 Features

Feature	Description
Crypto Converter	Convert BTC, USDT, ETH, SOL, BNB, USDC, TRX → ₦
Money Transfer	Send to any Nigerian bank (mock)
Bill Payments	Airtime, Data, Electricity, Cable TV, Gift Cards
Live Rates	Auto-refreshing exchange rates table
Dashboard	Overview with quick actions and rate snapshot

---

🎨 Brand

• Name: Monexa
• Theme: Deep emerald green + amber gold on dark background
• Typography: Syne (headings) + DM Sans (body)

---

🔧 API Endpoints

Method	Endpoint	Description
GET	/api/rates	Get current crypto/naira rates
POST	/api/convert	Calculate conversion payout
POST	/api/transfer	Initiate money transfer
GET	/api/bills	Get available bill services
POST	/api/bills/pay	Process bill payment

Note: All financial transactions are mock/demo only. Connect a real payment processor (Flutterwave, Paystack, or blockchain APIs) for production.

---

🔌 Going to Production

1. Replace mock rates in server/index.js with a live crypto API (e.g. CoinGecko, Binance)
2. Integrate Flutterwave or Paystack for actual bank transfers and bill payments
3. Add user authentication (JWT / Firebase Auth)
4. Deploy client to Vercel/Netlify, server to Railway/Render

---

© 2026 Monexa Technologies Limited