Discophery

Ein werbefreier, persönlicher News-Feed als Ersatz für Google Discover.
Modernisiertes Setup mit Vite, TypeScript und PWA-Unterstützung.

---

🚀 Was ist Discophery?

Diese App aggregiert RSS-Feeds deiner Lieblingsseiten und präsentiert sie in einem übersichtlichen Card-Design. Inspiriert von Google Discover, aber mit Fokus auf Datenschutz und Kontrolle.

• Keine Werbung — Rein redaktionelle Inhalte ohne Tracking.
• Privacy First — Alle Einstellungen, Filter und Interaktionen bleiben lokal im Browser (localStorage).
• Paywall-Erkennung — Automatische Markierung von Inhalten hinter Bezahlschranken.
• Offline-Ready — Dank Service-Worker auch ohne aktive Internetverbindung nutzbar.
• Voll anpassbar — Integrierter Feed-Manager für Katalog- und benutzerdefinierte Feeds.

---

🛠 Technischer Stack

• Framework: Kein Framework (Vanilla UI-Logik) für maximale Performance.
• Build-Tool: Vite für schnelles Development und optimierte Bundles.
• Sprache: TypeScript für Typsicherheit und Wartbarkeit.
• Styling: CSS Custom Properties (Variables) mit Support für Dark/Light Mode.
• Datenquelle: Hybrid-Modell:
  • A: Pre-fetched — Über eine GitHub Action werden Standard-Feeds in data/feeds.json zwischengespeichert.
  • B: Proxy-Fallback — Benutzerdefinierte Feeds werden via CORS-Proxy geladen.

---

🏃 Schnellstart

1. Repository klonen & Abhängigkeiten installieren

git clone https://github.com/mazer666/discophery.git
cd discophery
npm install

2. Entwicklungsserver starten

npm run dev

Die App ist nun unter http://localhost:5173 erreichbar.

3. Build für Produktion

npm run build

Das fertige Projekt liegt im Ordner docs/ (optimiert für GitHub Pages).

---

📂 Projektstruktur

discophery/
├── src/                ← TypeScript Quellcode
│   ├── main.ts         ← Einstiegspunkt
│   ├── config.ts       ← Zentrale Konfiguration (Feeds, Timeouts)
│   ├── feed.ts         ← Feed-Loader & Parser
│   ├── ui.ts           ← UI-Logik & Event-Handling
│   └── ...
├── data/               ← Cache für pre-fetched Feeds (feeds.json)
├── scripts/            ← Python-Skripte für GitHub Actions
├── public/             ← Statische Assets (Icons, Manifest)
├── archive/            ← Veraltete Dokumentation und Code-Relikte
├── index.html          ← HTML-Grundgerüst
└── vite.config.ts      ← Vite Konfiguration

---

📜 Lizenz

MIT — Frei für private und kommerzielle Nutzung.