🏛️ Bazaar - Indian Stock Market Dashboard

A lightweight, cross-platform Electron desktop application for displaying real-time Indian stock market information with a classic light interface.

✨ Features

• 📊 Market Summary - Major indices (Nifty50, Bank Nifty, Sensex)
• 🔥 Top Gainers & Losers - Dynamic stock lists with time period filters
• 😰 Market Sentiment - India VIX and Fear/Greed meter
• 🏭 Sectoral Performance - Visual sector charts
• 🎨 Multiple Themes - Light classic and Dark terminal themes
• ⚡ Auto-Refresh - Updates every 60 seconds
• 🌐 Real NSE Data - Uses official NSE India API

🚀 Quick Start

Prerequisites

• Node.js v18+ (Download)
• npm v9+

Installation & Run

# Clone the repository
git clone <repository-url>
cd bazaar

# Install dependencies
npm install

# Run the application
npm start

Or use helper scripts:

Linux/macOS:

./scripts/setup.sh
npm start

Windows:

scripts\setup.bat
npm start

📦 Build Executables

# Build for current platform
npm run build

# Build for specific platform
npm run build:win     # Windows
npm run build:mac     # macOS
npm run build:linux   # Linux

Executables will be in the dist/ folder (~80-100 MB).

📚 Documentation

All documentation is in the docs/ folder:

• GETTING_STARTED.txt - Simple text guide
• QUICKSTART.md - Get running in 3 steps
• ELECTRONJS_IMPLEMENTATION_GUIDE.md - Complete implementation guide
• ELECTRON_MIGRATION.md - Migration from Python summary
• FEATURES.md - Detailed features
• PROJECT_STRUCTURE.md - Architecture
• INSTALLATION.md - Platform-specific setup
• BUILD_GUIDE.md - Building executables
• CHANGELOG.md - Version history

🛠️ Technology Stack

• Electron (v28+) - Desktop framework
• Node.js - JavaScript runtime
• stock-nse-india - NSE India API for real-time data
• HTML5/CSS3 - UI structure and Light theme
• Vanilla JavaScript - No frameworks for minimal size

🎯 Key Features

Dynamic Stock Lists

Stock lists are fetched dynamically from NSE India API - no hardcoding! This means the app automatically updates when index constituents change.

Optimized Bundle

• Only 1 production dependency (stock-nse-india)
• No React/Vue - pure JavaScript
• ASAR compression enabled
• ~80-100 MB final build size

Real-Time Data

All data fetched from official NSE India API:

• ✅ Free and open
• ✅ No API key required
• ✅ Real-time market data

🐛 Troubleshooting

Linux Sandbox Error

If you get sandbox errors on Linux, the app already includes --no-sandbox flag. If issues persist, check docs/INSTALLATION.md.

Data Not Loading

• Check internet connection
• NSE API might be temporarily down - wait and refresh
• Click the "🔄 Refresh Now" button

Application Won't Start

# Reinstall dependencies
rm -rf node_modules package-lock.json
npm install
npm start

📝 System Requirements

• OS: Windows 10+, macOS 10.12+, Ubuntu 18.04+
• RAM: 512 MB minimum
• Storage: 150 MB
• Internet: Required for real-time data

🤝 Contributing

Contributions welcome! See documentation for architecture details.

📄 License

MIT License - Free and open-source

⚠️ Disclaimer

For informational purposes only. Not financial advice. Always consult a qualified financial advisor before making investment decisions.

🙏 Acknowledgments

• NSE India - Official market data API
• Electron.js - Cross-platform framework
• Light - UI design inspiration

---

Happy Trading! 📈💰

For detailed documentation, see the docs/ folder.