🟨 CYBER 2077 EXCHANGE

A slick, cyberpunk‑inspired currency & crypto converter built with Next.js App Router, TypeScript, and Tailwind — with PKR‑first shortcuts and quick region groupings.

🌐 Live Demo: cyber2077exchange.vercel.app

---

🚀 Features

• 🌍 100+ currencies — major fiat + popular crypto (BTC, ETH, SOL, LTC, XRP, …)
• 🇵🇰 PKR featured — fast access for Pakistan‑focused pairs
• 🗺️ Region groups — browse by Asia / Americas / Europe / Africa / Oceania
• 🔁 Two‑way converter — amount in FROM → instant TO result
• 🧾 Recent history — reuse previous conversions
• ⚡ Fast UI — responsive, keyboard friendly
• 🟨 Cyberpunk theme — neon accents + bold typography

---

📸 Preview

---

🛠 Tech Stack

• Framework: Next.js App Router (TypeScript)
• Styling: Tailwind CSS
• UI: shadcn/ui + lucide-react (repo contains components.json)
• State: React hooks / Context
• Data: Exchange‑rate API service (or local seed)
• Deploy: Vercel

---

📂 Project Structure (from repo)

├── app/                  # Next.js App Router routes & layouts
├── components/           # Reusable UI (Select, AmountInput, PairCard, History)
├── hooks/                # Custom hooks (rates, pairs, keyboard, theme)
├── lib/                  # helpers, formatters, rate service
├── public/               # static assets (icons, screenshots)
├── styles/               # globals, Tailwind layers
├── components.json       # shadcn/ui registry
├── next.config.mjs       # Next.js config
├── tailwind.config.ts    # Tailwind config
├── tsconfig.json         # TypeScript config
├── package.json
└── README.md

---

⚙️ Setup & Scripts (Next.js)

# 1) Install deps
npm install

# 2) Dev server
npm run dev 

# 3) Production build
npm run build
npm start 

---

🧭 Usage

1. Choose FROM and TO currencies (fiat/crypto)
2. Enter the Amount
3. Click Convert for instant results
4. Open History to reuse past conversions

Popular pairs: USD ↔ PKR, EUR ↔ USD, BTC ↔ USD, ETH ↔ PKR, GBP ↔ EUR

---

🔐 Data Accuracy

• Live rates vary by provider and update interval
• Cache responses to reduce API limits; show last updated timestamp
• Provide a fallback when the API is unavailable

---

🧪 Testing Ideas

• Unit tests: parsing, rounding, symbol formatting, math
• UI tests: selects, keyboard navigation, mobile breakpoints
• Snapshot: theme components (cards, inputs)

---

🧾 Roadmap

• 📈 Mini chart / sparkline for pair movement
• ⭐ Favorites / pinned pairs
• 🧮 Fee & spread estimator
• 📤 Shareable result links
• 🌐 i18n (multi‑language)
• 🔒 Offline cache for last‑known rates

---

🙌 Contributing

1. Fork the repo
2. Create a feature branch: feat/your-idea
3. Add tests & screenshots for UI work
4. Open a PR with a clear description

---

👤 Author

Built by Arslan Javed — GitHub

Live demo: cyber2077exchange.vercel.app

---

📜 License

MIT — see LICENSE for details.