BitCalculator

Bitcoin ROI Calculator 🚀

A comprehensive Bitcoin savings and market analysis platform with real-time data, advanced visualizations, and multi-currency support.

✨ Features

📊 Advanced Calculator

• Historical Analysis: Calculate what past Bitcoin investments would be worth today
• Future Projections: Forecast potential returns with customizable growth rates
• Multi-Currency Support: 18+ currencies including USD, EUR, GBP, JPY, KES, NGN, and more
• Year Range Analysis: Analyze performance across multiple years

📈 Real-Time Market Data

• Live Price Updates: WebSocket integration for real-time Bitcoin prices
• Professional Charts: Candlestick charts with TradingView integration
• Market Analysis: Volatility metrics, drawdown analysis, and trading insights
• Multiple Timeframes: 1h, 4h, 1d, 1w chart intervals

🎯 Advanced Visualizations

• Interactive Charts: Line, bar, pie, and candlestick charts using Recharts
• Volatility Analysis: Real-time volatility calculations with market insights
• Price History: Historical price trends and performance metrics
• Market Timing: Automated signals for market entry/exit points

🛠️ Technology Stack

Backend

• Node.js + Express: RESTful API with modular architecture
• WebSocket Server: Real-time price broadcasting
• Multi-API Integration: CoinGecko + ExchangeRate APIs
• Advanced Caching: Intelligent cache strategies with NodeCache
• Comprehensive Validation: Input validation with custom error handling

Frontend

• React + Vite: Modern development setup with fast HMR
• TailwindCSS: Custom Bitcoin-themed styling
• Recharts + Lightweight Charts: Professional trading visualizations
• Custom Hooks: Reusable WebSocket and API management
• Responsive Design: Mobile-first approach
• Interactive Charts: Visual representation of investment growth
• Multi-Currency Support: KES, USD, EUR, and BTC inputs
• ROI Calculations: Detailed return on investment percentages and multipliers

🚀 Quick Start

1. Install dependencies:

   npm run install-all
   

2. Start the development servers:

   npm run dev
   

3. Open http://localhost:5173 for the frontend
4. Backend API runs on http://localhost:3001

📁 Project Structure

bitcoin-roi-calculator/
├── client/          # React frontend
├── server/          # Node.js backend
├── package.json     # Root package.json
└── README.md

🛠 Tech Stack

• Frontend: React, Vite, TailwindCSS, Recharts
• Backend: Node.js, Express, Axios
• APIs: CoinGecko, CryptoCompare
• Styling: TailwindCSS with responsive design

💡 Usage Examples

• “If I invested $500 in 2016, what would it be worth today?”
• “If I invest 0.05 BTC today, how much could it be worth in 2030?”
• “Show me ROI for KES 10,000 invested in 2020”

🔧 Development

• Frontend: React with Vite for fast development
• Backend: Express server with CORS enabled
• Real-time Bitcoin price updates
• Historical data from multiple sources
• Compound growth calculations for forecasts