Signor1/ngx-intel

Nigeria's most complete stock education platform, Live NGX market data, AI-powered analysis — all in one place. # NGX Intel **Nigerian Stock Market Intelligence Platform** NGX Intel is a comprehensive platform for understanding and tracking the Nigerian Exchange (NGX). It combines live market data, AI-powered analysis, and educational content — built for everyone from first-time investors to active retail traders. ## Features - **Market Dashboard** — Real-time ASI, sector heatmap, top movers, upcoming dividends - **Stock Screener** — Filter and sort 150+ NGX-listed companies by sector, price, P/E, yield - **Stock Detail Pages** — Price charts, 52-week range, dividend history, key stats - **Dividend Tracker** — All dividends, calendar view, and dividend champions ranking - **Sector Analysis** — Deep dive into all 11 NGX sectors with drivers and risks - **Knowledge Hub** — 40+ glossary terms explaining stock market concepts in plain English with Nigerian examples - **Year-by-Year History** — Visual narrative of NGX performance from 2010 to present - **AI Chat** — Claude-powered assistant focused exclusively on Nigerian stocks (BYOK) - **Personal Watchlist** — Track favourite stocks with notes, persisted to localStorage - **Analysis Articles** — Long-form editorial analysis in MDX ## Tech Stack | Layer | Technology | |-------|-----------| | Framework | Next.js 15 (App Router, RSC) | | Language | TypeScript | | Styling | Tailwind CSS v4 + shadcn/ui | | Auth | NextAuth v5 (Google OAuth) | | Data | EODHD API (free tier) + seed JSON | | Charts | Recharts | | State | Zustand (chat, watchlist) | | Client Data | TanStack Query v5 | | Content | MDX (next-mdx-remote + gray-matter) | | AI | Anthropic Claude API (client-side, BYOK) | | Deployment | Vercel | ## Getting Started ### Prerequisites - Node.js 18+ - Google OAuth credentials (from Google Cloud Console) - EODHD API key (free at eodhistoricaldata.com) ### Setup ```bash # Clone and install cd ngx-intel npm install # Configure environment cp .env.local.example .env.local # Fill in AUTH_SECRET, AUTH_GOOGLE_ID, AUTH_GOOGLE_S …