Modern Market Sentiment Tracker

A sleek, user-friendly market sentiment analysis tool featuring an EV-style cluster instrument dashboard and real-time market insights.

🚀 Features

🎛️ EV-Style Sentiment Cluster

• Intuitive gauge design inspired by electric vehicle dashboards
• Real-time needle animation showing market sentiment (Fear ↔ Greed)
• Color-coded zones: Red (Fear), Yellow (Neutral), Green (Greed)
• Time period switching: 1D, 5D, 1M views with smooth transitions

📊 Smart Data Architecture

• Static-first approach: Pre-processed data for lightning-fast loading
• GitHub Actions automation: Daily data fetching and analysis
• Fallback resilience: Graceful handling of API failures
• Modular TypeScript: Clean, maintainable component architecture

🎨 Modern UX Design

• User-friendly messaging: "Investors are bullish" instead of technical jargon
• Clean numerical display: "68" instead of "67.69439490405992"
• Responsive design: Perfect on mobile and desktop
• Smooth animations: Engaging micro-interactions

📈 Market Indicators

• S&P 500, Nasdaq 100, Russell 2000: Price and sentiment analysis
• VIX Volatility: Market fear gauge with clear interpretations
• Options Sentiment: Put/call ratios translated to human language
• Confidence scoring: Data quality and recency indicators

🏗️ Architecture

Data Pipeline

GitHub Actions (Daily 6 AM EST)
├── Fetch API data (CNN, Alpha Vantage, FRED, Yahoo)
├── Process & analyze sentiment
├── Generate static JSON files
└── Auto-commit → Deploy to GitHub Pages

Frontend Stack

• Vite + TypeScript: Modern build tooling
• Vanilla Components: No framework overhead
• CSS Animations: Smooth, performant transitions

🚦 Quick Start

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

🎯 Design Philosophy

User-Centric Language

❌ "SPY Put/Call Ratio: 0.7334523"
✅ "Options traders are bullish on S&P 500"

❌ "VIX: 23.4567"  
✅ "Market volatility is elevated"

❌ "Fear & Greed: 67.69439490405992"
✅ "Sentiment: 68 (Greedy)"

Performance First

• < 200ms load time: No API calls during page load
• < 50KB bundle: Minimal JavaScript footprint
• 99.9% uptime: No dependency on external APIs for serving

📊 Data Sources

• CNN Fear & Greed Index: Market sentiment baseline
• Alpha Vantage: Stock prices and volumes
• FRED: VIX volatility and economic indicators
• Yahoo Finance: Options volume data

🔄 Update Frequency

• Data Refresh: Daily at 6 AM EST via GitHub Actions
• Fallback Data: High-quality mock data when APIs fail
• Cache Strategy: 5-minute client-side caching for performance

🤝 Contributing

1. Fork the repository
2. Create feature branch: git checkout -b feature/amazing-feature
3. Test locally: npm run dev
4. Build: npm run build
5. Commit changes with Claude Code signature

📄 License

MIT License - feel free to use this for your own projects!