💎 NexWallet — Hybrid Crypto & Fiat Wallet

India's most powerful Hybrid Crypto & Fiat Wallet
UPI · Cards · Net Banking · Crypto Trading · DeFi · NFT · Staking · Cross-chain Bridge

---

✨ Features

Feature	Description
🔐 Registration & KYC	Full onboarding with PAN, Aadhaar, PIN setup
💸 UPI Payments	Send/receive via UPI with daily limit tracking
💳 Card Payments	Debit & Credit card transactions with OTP simulation
🏦 Net Banking	NEFT / RTGS / IMPS transfers
📥 Deposit	UPI, Bank Transfer, Card top-up
📤 Withdraw	UPI, Bank Transfer, Crypto withdrawal
🪙 Crypto Trading	Buy/sell 100+ tokens with live price simulation
🌾 DeFi	Lending, LP, Farming (Aave, Uniswap, Curve, Compound)
🥩 Staking	ETH, SOL, ATOM, DOT staking with rewards
🖼️ NFT Gallery	View, list, transfer, buy NFTs
🌉 Cross-chain Bridge	LayerZero + Wormhole bridging across 8 chains
🌍 8 Indian Languages	English, Hindi, Bengali, Telugu, Tamil, Marathi, Gujarati, Kannada
📊 Portfolio Charts	Line chart + Donut chart with period filters
🔔 Notifications	Price alerts, DeFi yield, security alerts
🛡️ Security Center	Biometric, PIN, multi-sig, anti-phishing
🌙 Dark Theme	Full dark UI with glassmorphism design

---

🚀 Quick Start (3 Steps)

Prerequisites

• Node.js v18 or higher
• npm v9 or higher

1. Clone the Repository

git clone https://github.com/digital-coder-jack/Wallet.git
cd Wallet

2. Install Dependencies

npm install

3. Run Locally

npm run dev

---

📦 All Available Scripts

Command	Description
npm run dev	Start local development server (Vite + HMR)
npm run build	Build for production (outputs to dist/)
npm run preview	Preview production build locally via Wrangler
npm run deploy	Build + deploy to Cloudflare Pages

---

☁️ Deploy to Cloudflare Pages (Free)

Step 1 — Install Wrangler CLI

npm install -g wrangler

Step 2 — Login to Cloudflare

wrangler login

Step 3 — Deploy

npm run deploy

---

🗂️ Project Structure

Wallet/
├── src/
│   └── index.tsx          # 🔵 Hono backend + full HTML/CSS UI
├── public/
│   └── static/
│       ├── app.js         # 🟡 Full client-side engine (2700+ lines)
│       └── styles.css     # 🎨 Additional styles
├── dist/                  # 📦 Build output (auto-generated)
├── wrangler.jsonc         # ☁️  Cloudflare Pages config
├── vite.config.ts         # ⚡  Vite build config
├── tsconfig.json          # 🔷  TypeScript config
├── ecosystem.config.cjs   # 🟢  PM2 process config
├── package.json           # 📋  Dependencies & scripts
└── README.md              # 📖  This file

---

🖥️ Tech Stack

Layer	Technology
Backend	Hono on Cloudflare Workers
Frontend	Vanilla JS + Tailwind CSS (CDN)
Charts	Chart.js
Icons	Font Awesome 6
Build	Vite
Deploy	Cloudflare Pages
Storage	Browser localStorage (no backend DB needed)

---

📱 App Screens

🔐 Onboarding Flow

1. Welcome Screen — App intro with feature badges
2. Personal Details — Name, Email, Phone, DOB, Avatar
3. KYC Documents — PAN Card, Aadhaar, UPI ID
4. Set PIN — 6-digit PIN with confirmation
5. All Set! — Summary + ₹100 welcome bonus

📲 Main App Pages

• Dashboard — Portfolio overview, quick actions, recent transactions
• Portfolio — Asset breakdown, charts, filter by type
• Pay — UPI, Cards, Net Banking, Bill payments
• Markets — Live prices, search, buy/sell tokens
• DeFi — Positions, Lending, Liquidity, Farming, Staking
• More — NFTs, Bridge, Activity, Notifications, Settings, Security

---

🔒 Demo / Test Data

When you first open the app, you'll go through the registration flow. Use these test values:

Field	Example Value
Name	Arjun Kumar
Email	arjun@example.com
Phone	9876543210
DOB	1995-03-14
PAN	ABCDE1234F
Aadhaar	1234 5678 9012
PIN	Any 6 digits (e.g. 123456)

Note: All data is stored locally in your browser's localStorage. No data is sent to any server.

---

🌐 API Endpoints

The Hono backend exposes these REST endpoints:

Method	Endpoint	Description
GET	/api/portfolio	Get portfolio totals
POST	/api/send	Send crypto transaction
POST	/api/upi/pay	Process UPI payment
POST	/api/bridge	Cross-chain bridge

---

⚙️ Configuration

wrangler.jsonc

{
  "name": "nexwallet",
  "compatibility_date": "2024-09-23",
  "compatibility_flags": ["nodejs_compat"],
  "pages_build_output_dir": "./dist"
}

Environment Variables (optional)

Copy .env.example to .dev.vars for local secrets:

cp .env.example .dev.vars

---

🤝 Contributing

1. Fork the repository
2. Create your feature branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'feat: Add amazing feature'
4. Push to the branch: git push origin feature/amazing-feature
5. Open a Pull Request

---

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

---

🙏 Acknowledgements

• Hono — Ultra-fast web framework
• Cloudflare Pages — Free global edge hosting
• Tailwind CSS — Utility-first CSS framework
• Chart.js — Beautiful charts
• Font Awesome — Icon library

---

Built with ❤️ for India's crypto community
_{⭐ Star this repo if you find it useful!}