AlphaStrat

A personal finance web app for portfolio analysis, market research, and options analytics.

Built with Next.js 16, React 19, Supabase, and Tailwind CSS v4.

Access-controlled — signup requires an invite code.

Track tickers with real-time quotes, upcoming earnings, analyst ratings, and price targets. Click any row to open the detail panel.

Overview Analyst consensus gauge, next earnings date, EPS/revenue estimates, and market cap.	News AI-summarized news grouped into themes with source attribution (Groq + Llama 3).
Sentiment Analyst recommendation trend, Reddit & Twitter/X social buzz via Adanos, and AI trend explanation.	Thesis AI-generated investment thesis with key metrics, rating gauge, and expandable bull/bear/base cases (Gemini Flash Lite).
Earnings Next earnings date, EPS beat/miss history, and revenue & net income trend charts.	Options — AI Analysis AI narrative covering market positioning, expected move, volatility, notable flow, risks, and takeaway.

Expected move gauge with max pain, IV surface by moneyness, IV term structure, positioning by strike, and Greeks — all computed via Black-Scholes.

Upcoming earnings across your watchlist, grouped by date with EPS/revenue estimates and ranges.

Track positions with blended cost basis, P&L, and a performance chart benchmarked against SPY. Risk metrics include beta, Sharpe ratio, and max drawdown.

Cross-market news across Fed policy, geopolitics, commodities, jobs, and government. AI-synthesized outlook with sentiment badge and driver chips. Market mood bar and sector sentiment from social data.

• No Python, no heavy SDKs — all data fetching via direct fetch() calls to REST APIs
• Generic cache utility — getOrFetch<T>() with composite upsert, user-scoped or shared cache modes
• Pure financial calculations — unit-tested functions for P&L, risk metrics, Black-Scholes, allocation
• Design token system — CSS custom properties for consistent theming across all pages
• Server Actions for mutations, API Routes for data fetching
• Proxy-based auth (Next.js 16 proxy.ts) for session refresh and route protection

• Node.js 18+
• A Supabase project
• API keys for: Groq, Gemini, Adanos (optional)

git clone https://github.com/MarcusLeongHK/alphastrat.git
cd alphastrat
npm install

Create a .env file:

NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key
GROQ_API_KEY=your_groq_key
GEMINI_API_KEY=your_gemini_key
ADANOS_API_KEY=your_adanos_key

Apply database migrations in order via the Supabase SQL editor or CLI (supabase/migrations/).

app/
  watchlist/                  # Watchlist + ticker detail panel
    tabs/                     # Overview, News, Sentiment, Thesis, Earnings, Options
  portfolio/                  # Portfolio dashboard
  macro/                      # Macro news dashboard
  guide/options/              # Options analytics guide
  components/                 # Shared UI (Header, MobileNav, Card, Badge, etc.)
  api/                        # API routes (market data, analysis, watchlist, macro)
lib/
  finance/                    # P&L, risk, allocation, Black-Scholes
  market/                     # Yahoo Finance, Adanos, RSS fetchers
  ai/                         # Thesis, news summary, options analysis, macro summary
  cache/                      # Generic cache utility
supabase/
  migrations/                 # SQL migration files

Private project. All rights reserved.