# 🎯 Project Spec: Ad-Free News Brief

## Overview
A minimalist news aggregator that delivers clean, ad-free news summaries from RSS feeds. No popups, no tracking, no clutter — just the news.

**Target Users**: Students, busy professionals who hate news site clutter
**Impact Goal**: 1,000+ daily active users
**Time to Build**: 2-3 weeks MVP, ongoing iteration

---

## Impact First — Why This Matters

### The Problem
- News sites are cluttered with ads, popups, paywalls, and tracking
- Students want to stay informed but find mainstream news overwhelming
- Existing news aggregators are either cluttered (Google News) or require accounts

### The Impact
- **Daily Users**: 1,000+ students/pros reading news without distraction
- **Time Saved**: Estimated 15-30 min/day not dealing with ads/clutter
- **Privacy**: No tracking, no data sold (local storage only in MVP)

### Leadership Angle
- Content curation is a SKILL — shows you understand what matters
- Could evolve into a newsletter (content creation)
- Community-driven feed selection involves others

---

## Technical Stack

### MVP (Weeks 1-2)
| Component | Technology | Cost |
|-----------|------------|------|
| Frontend | Vanilla HTML/CSS/JS | $0 |
| RSS Fetching | RSS to JSON API (rss2json.com free tier) | $0 |
| Deployment | Vercel or Netlify | $0 |
| Feed Source | Pre-curated list of 20-30 news RSS feeds | $0 |

### Full Version (Weeks 3-4)
| Component | Technology | Cost |
|-----------|------------|------|
| Backend | Cloudflare Workers (free tier) | $0 |
| Database | Cloudflare KV or SQLite | $0 |
| Analytics | Simple page view counter | $0 |
| User Accounts | Firebase Auth (free tier) | $0 |

---

## Core Features (MVP)

### Must Have
1. **Feed Display**: List of news headlines from curated sources
2. **Clean Reading View**: Click headline → opens clean reading mode
3. **Category Filter**: Tech, World, Science, Business tabs
4. **Dark Mode**: Because students study at night
5. **Share**: Copy link or share to Twitter/WhatsApp
6. **Offline Support**: Service worker for cache

### Nice to Have (Version 2)
1. **Personalized Feed**: Select which sources to follow
2. **Newsletter**: Email digest option
3. **Bookmarks**: Save articles to read later
4. **Reading Time**: Estimate per article
5. **API Access**: For other developers

---

## User Flow

```
1. User lands on homepage
2. Sees "Today" headlines from all categories
3. Clicks category (Tech, World, etc.)
4. Clicks article → Clean reading view (no ads, no clutter)
5. Can bookmark, share, or go back
6. Optional: Subscribe to newsletter (email)
```

---

## Data Sources (Free RSS Feeds)

### Tech News
- Hacker News (RSS): https://news.ycombinator.com/rss
- TechCrunch: https://techcrunch.com/feed/
- Ars Technica: https://feeds.arstechnica.com/arstechnica/index
- The Verge: https://www.theverge.com/rss/index.xml

### World News
- BBC: https://feeds.bbci.co.uk/news/world/rss.xml
- Reuters: https://www.reutersagency.com/feed/?best-topics=tech
- NPR: https://feeds.npr.org/1001/rss.xml

### Science
- NASA: https://www.nasa.gov/rss/dyn/breaking_news.rss
- Science Daily: https://www.sciencedaily.com/rss/all.xml

---

## Implementation Plan

### Week 1: Setup & Basic Display
- [ ] Set up Vercel/Netlify project
- [ ] Create basic HTML/CSS layout
- [ ] Fetch from 5 RSS feeds using rss2json
- [ ] Display headlines in card format
- [ ] Deploy and test

### Week 2: Polish & Add Features
- [ ] Add category filtering
- [ ] Implement dark mode
- [ ] Add clean reading view
- [ ] Add share functionality
- [ ] Test on mobile

### Week 3: User Accounts (Optional)
- [ ] Add Firebase Auth
- [ ] Allow saving feeds
- [ ] Add bookmarks

### Week 4: Analytics & Launch
- [ ] Add simple view counter
- [ ] Collect feedback
- [ ] Launch to Product Hunt / Reddit
- [ ] Track daily active users

---

## Metrics to Track

| Metric | Target | How to Measure |
|--------|--------|---------------|
| Daily Active Users | 1,000 | Vercel analytics or simple counter |
| Daily Articles Read | 5,000 | Page view counter |
| Newsletter Subscribers | 100 | Firebase or email list |
| Return Users | 40% | Cookies/localStorage |

---

## How to Demo (For College Apps)

### The Video (2-3 min)
1. Show the problem (cluttered news site)
2. Show your solution (clean, fast)
3. Show the code (few key files)
4. Show the metrics (users, growth)
5. Show what's next

### The Personal Statement Angle
- "I noticed my peers were stressed by news but couldn't escape it"
- "I asked 10 friends what they wanted — they said 'just the facts'"
- "In 3 weeks, 500 students used it. In 3 months, 1,000+"
- "The best part: no data collection, no tracking — just information"

---

## Extension Ideas

1. **Browser Extension**: One-click access to clean news
2. **API for Students**: Other devs can build on your feed
3. **Multilingual**: Support other languages
4. **Podcast Summaries**: Text-to-speech news briefs
5. **School Filters**: Local news relevant to student location

---

## Resources

- RSS2JSON: https://rss2json.com
- Vercel: https://vercel.com (free)
- Netlify: https://netlify.com (free)
- Hosting static sites: https://pages.dev (Cloudflare, free)

---

*Spec completed: 2026-04-28*

*Generated by Hermes Babu*