README.md

---
title: Q-Simplified
emoji: 📈
colorFrom: blue
colorTo: red
sdk: docker
pinned: false
license: mit
short_description: The Financial Architect — Live market data & blogs
---

# Q-Simplified — The Financial Architect

A full-stack financial education platform with:
- **Live market data** — Sensex, Nifty 50, USD/INR, Crude Oil, Repo Rate, CPI (refreshed every 60s)
- **Trending blogs** — Deep-dive financial analysis simplified for modern investors
- **Live news** — RSS-scraped headlines from ET, Moneycontrol, LiveMint
- **Study Zone** — Financial courses for every level
- **Auth system** — Register, login, JWT sessions

## Environment Variables (optional — app works in demo mode without these)

Set these in your Space's **Settings → Repository secrets**:

| Variable | Description |
|---|---|
| `SUPABASE_URL` | Your Supabase project URL |
| `SUPABASE_SERVICE_KEY` | Supabase service role key (Settings → API) |
| `JWT_SECRET` | Any random 32+ character string |

Without Supabase, the app runs in **demo mode** with static blog data and a temporary in-memory user store.

## Tech Stack
- **Backend**: FastAPI (Python) — single process, all microservices combined
- **Frontend**: Vanilla HTML/CSS/JS — no build step needed
- **Data**: Live RSS scraping + Yahoo Finance API (free, no key needed)
- **Database**: Supabase (optional) / in-memory demo mode
- **Fonts**: Manrope + Work Sans (Google Fonts)

## Pages
- `/` — Homepage with indicators, featured blog, live insights
- `/trends` — Full market data with interactive Chart.js charts
- `/study-zone` — Course catalog with category filters
- `/login` — Auth with register + forgot password
- `/api/docs` — FastAPI Swagger UI

## Local Development
```bash
git clone https://huggingface.co/spaces/YOUR_USERNAME/q-simplified
cd q-simplified
pip install -r requirements.txt
python app.py
# Open http://localhost:7860
```