A fintech web application that helps users receive stablecoins and currency($), to automatically protect and prevent their savings from inflation erosion. Built with Next.js, blockchain smart contracts, and designed for African remittance users - particularly Nigerians.
# NairaFlow - Smart Savings & Remittance App
A modern fintech web application that helps users receive stablecoins, automatically protect their savings, and prevent inflation erosion. Built with Next.js, blockchain smart contracts, and designed for African remittance users.
## Features
- **Auto-Save by Default**: Automatically split incoming USDC/USDT into spendable Naira and protected savings
- **Inflation Protection**: Keep savings in stablecoins (USDC/USDT) to protect against Naira devaluation
- **Flex Mode**: Optional feature to skip savings on one transfer with a 7-day cooldown
- **Smart Split Engine**: Configurable savings percentage (minimum 10%)
- **Real-time Dashboard**: View Naira balance, USD savings, and transaction history
- **Insights Analytics**: Track total saved, growth charts, and savings comparisons
- **Blockchain-Backed**: Secure smart contracts on EVM-compatible blockchains (Monad)
## Tech Stack
### Frontend
- **Framework**: Next.js 16 (App Router)
- **Language**: TypeScript
- **Styling**: TailwindCSS + Shadcn UI
- **State Management**: Zustand
- **Charts**: Recharts
- **Icons**: Lucide React
- **Notifications**: Sonner
### Backend
- **Runtime**: Node.js (Next.js API Routes)
- **Storage**: MongoDB
- **Authentication**: JWT + Cookies
- **API**: RESTful endpoints
### Blockchain
- **Smart Contracts**: Solidity 0.8.19
- **Framework**: Foundry
- **Network**: Monad EVM Testnet
- **Token**: MockUSDC (ERC20)
## Project Structure
```
/vercel/share/v0-project/
├── app/
│ ├── layout.tsx # Root layout with metadata
│ ├── page.tsx # Landing page
│ ├── globals.css # Global styles + design tokens
│ ├── (auth)/ # Auth routes (no sidebar)
│ │ ├── layout.tsx
│ │ ├── login/page.tsx
│ │ └── register/page.tsx
│ ├── (app)/ # Protected routes (with sidebar)
│ │ ├── layout.tsx # App layout with navigation
│ │ ├── dashboard/page.tsx …