📰 News Web App (React + Python/FastAPI)

A modern news aggregator for Windows IT environments — fetching tech & gaming news (XDA, Polygon) with a sleek glassmorphic UI.

📁 Project Structure

news_python_react_app/
├── main.py                # FastAPI backend
├── requirements.txt       # Python deps
├── frontend/              # React + TS + Tailwind
│   ├── package.json
│   ├── src/
│   └── ...
└── README.md

🐍 Backend Setup (Python)

1. Open CMD or PowerShell

2. Navigate to project root:

   cd C:\Users\User\Documents\news_python_react_app

3. Create & activate virtual environment (recommended):

   python -m venv .venv
   .venv\Scripts\activate

   ✅ You should see (.venv) in your prompt.

4. Install Python dependencies:

   pip install -r requirements.txt

5. Run backend:

   python main.py

   ✅ API runs at: http://127.0.0.1:8000/api/news
   📚 Auto docs: http://127.0.0.1:8000/docs

⚛️ Frontend Setup (React + Vite)

1. Open a new CMD/PowerShell tab (keep backend running)

2. Navigate to frontend:

   cd C:\Users\User\Documents\news_python_react_app\frontend

3. Install Node.js dependencies:

   npm install

4. Start dev server:

   npm run dev

   ✅ App opens at: http://127.0.0.1:3000

🧪 Full Workflow (Local Dev)

Step	Command	Purpose
1	cd .../news_python_react_app	Go to backend
2	python -m venv .venv && .venv\Scripts\activate	Isolate Python env
3	pip install -r requirements.txt	Install deps
4	python main.py	Launch API
5	(new tab) cd frontend && npm install	Install React
6	npm run dev	Launch UI

💡 Tip: To deactivate .venv, just type deactivate.

✅ Features

• 🖥 Glassmorphism UI (backdrop-blur-sm, semi-transparent cards)
• 📡 FastAPI backend with RSS parsing (XDA + Polygon)
• 🔍 Auto tech-tagging ([TECH_PRIORITY] for Windows/dev/chip/GPU keywords)
• 🧠 TypeScript type safety
• 📱 Fully responsive grid

▶️ Next Steps (Optional Enhancements)

• Add Windows .bat launcher for 1-click start
• Implement localStorage "read/unread" tracking
• Add category filter (Gaming vs Dev)
• Sync with Windows system theme (Dark/Light)

Let me know if you'd like any of these!