Smart KYC Assistant

AI-powered eSewa Smart KYC platform — a production-ready frontend for identity verification onboarding.

Tech Stack

• Vite + React 19
• Tailwind CSS v4
• React Router DOM v7
• Framer Motion — animations
• Lucide React — icons
• React Hook Form + Zod — forms & validation
• Axios — API client (interceptors, token handling)
• Zustand — state management

Getting Started

npm install
npm run dev

Open http://localhost:5173

Demo Login

• Phone: 9841234567 (or any valid Nepali mobile)
• Password: demo123 (min 6 chars)

Features

• Authenticated dashboard with sidebar + mobile bottom nav
• Full KYC flow: Upload → OCR → Smart Form → Review → Submit
• KYC status tracker with timeline
• Rejection / action required UX
• AI Assistant chat with quick prompts
• Notifications feed with filters
• Settings (profile, security, preferences)
• Forgot password + OTP verification

Project Structure

src/
├── components/     # Reusable UI (Button, Card, UploadZone, etc.)
├── pages/          # Route pages
├── layouts/        # Auth & Dashboard layouts
├── routes/         # Router + protected routes
├── services/       # API services (auth, kyc, chat, notifications)
├── store/          # Zustand stores
├── hooks/          # Custom hooks
├── forms/          # Zod schemas
├── constants/      # Routes, mock data, colors
├── animations/     # Framer Motion variants
└── utils/          # Helpers

Backend Integration

Copy .env.example to .env and set your FastAPI backend URL:

VITE_API_URL=http://localhost:8000/api

Services in src/services/ are ready to swap mock delays for real API calls.

Scripts

Command	Description
npm run dev	Start dev server
npm run build	Production build
npm run preview	Preview production build

Design

eSewa-inspired fintech UI:

• Primary Green: #60BB46
• Background: #F7F9FB
• Inter font family
• Mobile-first responsive layout