🪐 CryptoLens

A clean, modern, and distraction-free cryptocurrency monitoring dashboard.

Built with beautiful UX in mind — track live prices, spot trending coins, analyze market sentiment, and view global metrics in one elegant interface.

---

✨ Live Demo

👉 https://cryptolens.link

---

📸 Preview

preview.mp4

---

✨ Features

• Live Price Cards — Real-time prices with sparklines (PAXG, BNB, AVAX, etc.)
• Trending Coins & Top Gainers — Discover hot movers with leaderboards
• Global Market Cap — Total cap + 24h volume with interactive historical charts (7d/30d/1y)
• Fear & Greed Index — Visual gauge showing market sentiment
• Bitcoin Analysis — Depth chart, sentiment, and dominance breakdown
• Comprehensive Market Table — Sortable top assets with price, volume, cap, and 7d change
• Global Search — Instantly find any cryptocurrency
• Mobile Navigation — Responsive sidebar + drawer for mobile
• Premium Dark UI — Clean, distraction-free design

---

🛠 Tech Stack

Technology	Purpose
React 19	Frontend UI Framework
Vite	Development build tool
Tailwind CSS v4	Styling
Recharts	Charting library
Lucide React	Icon system
Binance / CoinGecko API	Real-time market data
ESLint	Code linting

---

🚀 Quick Start

Clone the project and run locally.

# Clone the repository
git clone https://github.com/zedxihan/cryptolens.git
cd cryptolens

# Switch to the active development branch
git checkout development

# Install dependencies
npm install

# Start the development server
npm run dev

Open: http://localhost:5173

---

📁 Project Structure

src/
├── components/
│   ├── layout/      # Header, Sidebar, Mobile Drawer
│   ├── cards/       # Price cards, stat cards
│   ├── charts/      # Recharts components
│   └── ui/          # Reusable UI elements
├── pages/           # Dashboard pages
├── hooks/           # Custom React hooks
├── utils/           # Helper functions
├── App.jsx
└── main.jsx

---

🗺 Roadmap

✅ Completed

• Core dashboard UI + responsive layout
• CoinGecko API integration
• Global market charts
• Fear & Greed gauge
• BTC dominance & sentiment
• Trending / Top Gainers
• Global search
• Mobile navigation

🔄 Planned

• Portfolio tracker & watchlist
• Individual coin pages
• Price alerts & notifications
• Light mode toggle
• PWA support
• Performance optimizations

---

🤝 Contributing

Contributions are welcome!

1. Fork the repository
2. Create your branch
3. Commit changes
4. Push to GitHub
5. Open a Pull Request

---

📜 License

Distributed under the MIT License.

---

💖 Support

If you like this project:

• ⭐ Star the repo
• Share it
• Support via Patreon

---

Made with ❤️ by zedxihan