"A high-performance stock screening and analysis platform for Indian investors, built with Next.js 14, TypeScript, and TradingView's Lightweight Charts."
This project represents a full architectural evolution—transitioning from a monolithic script to a highly-organized, Modular ES6 Architecture. By dismantling the legacy structure, we’ve achieved a clean Separation of Concerns across three core pillars:
src/lib/api.ts(The Data Layer): Centralized Yahoo Finance fetching logic with automated CORS proxying and resilience handling.src/lib/search.ts(The Screener Logic): A dedicated client-side utility and search index for high-speed stock identification and filtering.- The UI Layer (
src/components/,src/app/): A component-driven frontend leveraging React 18, Radix UI, and Tailwind CSS for a professional terminal experience.
This modularity ensures that business logic remains decoupled from presentation, allowing for sub-millisecond data updates and seamless feature expansion.
We’ve built a custom terminal parser that allows users to run complex mathematical queries. Logic like ROE > 20 AND PE < 15 is parsed instantly against our local index, allowing for professional-grade stock discovery within the dashboard.
To solve API rate-limiting and availability issues, the terminal features a proprietary Synthetic Data Fallback algorithm. If the Yahoo Finance proxy is unreachable, the system automatically reconstructs OHLC (Open, High, Low, Close) candles based on historical volatility and current price vectors, ensuring the analyzer is always functional.
We have painstakingly recreated the high-density data environment of top-tier Indian terminals:
- 3x3 Data Ratio Grid: Sharp, flat grid layout providing immediate visibility into ROCE, PE, Book Value, and Dividend Yield.
- Sector-Aware Peer Comparison: Dynamic discovery system that identifies and ranks industry rivals in real-time.
- TradingView Integration: Low-latency candlestick charts with volume histograms for technical deep-dives.
The terminal features 0ms View-Switching. By leveraging local React state management and TanStack Query caching, transitions between the global Dashboard and deep-dive Analysis views happen across the stack instantaneously, providing a premium desktop-software feel.
- Framework: Next.js 14 (App Router)
- Language: TypeScript
- Charts: TradingView Lightweight Charts v5
- State/Caching: TanStack Query v5
- Styling: Tailwind CSS v4
- UI Architecture: Shadcn/UI
This repository represents the high-performance modernization of the Indian-Stock-Screener project.