Skip to content

KirobotDev/Heatmap-Dashboard

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Crypto Heatmap Dashboard

🔥 Crypto Heatmap Dashboard 🔥

Real-time cryptocurrency market performance visualization with an interactive heatmap

FeaturesDemoInstallationUsageScreenshotsLicense


✨ Features

🎯 Core Features

  • 📊 Visual Heatmap - Display cryptocurrencies as blocks proportional to their market cap
  • 🎨 Dynamic Coloring - Green/Red based on 24h performance, intensity based on % change
  • 🔍 Real-time Search - Filter coins by name or symbol instantly
  • 📈 TradingView Charts - Click any coin to view its advanced chart
  • ⚡ Real-time Data - CoinGecko API for the most recent market data

🎛️ Controls

Function Description
Top 10/50/100 Toggle between top cryptos by market cap
🔎 Search Search by name (Bitcoin) or symbol (BTC)
🔄 Refresh Manually refresh the data
💡 Hover Hover to see market cap, volume, 24h high/low
🖱️ Click Open the modal with TradingView chart

🌟 Extras

  • 🌙 Dark Mode by default (pro trading design)
  • 📱 Responsive - Desktop, tablet, mobile
  • 💾 LocalStorage - Save your preferences (top 10/50/100)
  • 🎬 Animations - Smooth transitions on hover and load
  • 🖥️ Console Style - Styled welcome message in the console
  • 🚀 Zero Framework - 100% Vanilla JS, no dependencies

🎮 Demo

🌐 Live Demo : https://kirobotdev.github.io/Heatmap-Dashboard

🔧 Local Development

# Clone the repo
git clone https://github.com/KirobotDev/Heatmap-Dashboard.git

# Navigate to folder
cd crypto-heatmap

# Open with Live Server (VS Code) or open index.html directly
code .
# Then right-click → "Open with Live Server"

Note on CORS: CoinGecko API may block requests from localhost after a certain number of requests. If you see CORS errors:

  1. Wait a few minutes (rate limit)
  2. Use a CORS Unblock extension temporarily
  3. Deploy to Netlify/Vercel for a real domain

📸 Screenshots

🖥️ Desktop View

Dashboard Desktop Main view with top 50 cryptos heatmap

📱 Mobile View

*Responsive design adapted for mobile*

🔍 Search & Filters

Search Feature Real-time search and Top 10/50/100 filters

📈 TradingView Modal

TradingView Modal Advanced chart opens on coin click

✨ Hover Effects

Hover Effects Additional details on hover


🛠️ Technologies

🎨 Frontend

  • HTML5 - Semantic structure
  • CSS3 - Grid, Flexbox, CSS Variables, Animations
  • Vanilla JavaScript - ES6+, Fetch API, DOM Manipulation

🔌 APIs

🎁 Resources


📁 Project Structure

crypto-heatmap/
├── index.html          # Complete application (HTML + CSS + JS)
├── README.md           # Documentation
├── LICENSE             # MIT License
└── screenshots/        # Screenshots (to add)
    ├── dashboard.png
    ├── phone-dashboard.png
    ├── search-feature.png
    ├── tradingview-modal.png
    └── hover-effects.png

💡 Note: The entire application is contained in a single index.html file for easy deployment.


🚀 Deployment

🌟 Netlify (Recommended)

  1. Go to netlify.com
  2. Drag & drop your crypto-heatmap folder
  3. Your site is live! 🎉

▲ Vercel

npm i -g vercel
vercel

📦 GitHub Pages

  1. Push to GitHub
  2. Settings → Pages → Source: Deploy from a branch → main / root
  3. Your site will be at https://kirobotdev.github.io/Heatmap-Dashboard

⚙️ Configuration

🔧 Configuration Variables

In index.html, modify the CONFIG section:

const CONFIG = {
    API_URL: 'https://api.coingecko.com/api/v3',
    DEFAULT_LIMIT: 50,        // Number of coins displayed by default (10, 50, 100)
    REFRESH_INTERVAL: 60000,  // Auto-refresh interval in ms (1 min = 60000)
    STORAGE_KEY: 'cryptoHeatmapPrefs'
};

🎨 Color Customization

Modify the CSS :root variables:

:root {
    --bg-primary: #0a0e1a;     /* Main background */
    --bg-secondary: #111827;  /* Header, cards */
    --accent-green: #10b981;  /* Gains/positive */
    --accent-red: #ef4444;    /* Losses/negative */
    --accent-blue: #3b82f6;   /* Buttons, links */
}

📝 API Reference

Used Endpoints

Endpoint Description
GET /coins/markets Coin data (prices, market cap, 24h change)
GET /global Global stats (total market cap, BTC dominance)

CoinGecko Parameters

vs_currency=usd          # Currency
order=market_cap_desc    # Sort by market cap
per_page=50              # Limit (10, 50, or 100)
page=1                   # First page
price_change_percentage=24h  # 24h change

🤝 Contributing

Contributions are welcome! 🙌

🐛 Reporting a Bug

  1. Open an Issue
  2. Describe the bug with steps to reproduce
  3. Add screenshots if possible

💡 Proposing an Improvement

  1. Fork the project
  2. Create a branch (git checkout -b feature/my-feature)
  3. Commit (git commit -m 'Add my feature')
  4. Push (git push origin feature/my-feature)
  5. Open a Pull Request

🎯 Roadmap

  • Light mode
  • Personal watchlist
  • Price alerts
  • More timeframes (7d, 30d, 1y)
  • Multi-currency (EUR, GBP, JPY)

👨‍💻 Author

xql.dev


🙏 Acknowledgments


📜 License

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

MIT License

Copyright (c) 2026 xql.dev

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

⭐ Star this repo if you like it! ⭐

Made with xql.dev & the Community for crypto traders

About

🔥 Interactive crypto heatmap dashboard with real-time CoinGecko data. Visual market cap blocks with 24h performance coloring. Click for TradingView charts. 100% vanilla JS, zero dependencies.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages