till/managarten
1
0
Fork 0
mirror of https://github.com/Memo-2023/mana-monorepo.git synced 2026-05-16 20:19:39 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
managarten/apps/news/CLAUDE.md
Till JS 4d390be5af feat(news): migrate from archive to local-first + Hono architecture 
- Move from apps-archived/ to apps/
- Delete NestJS API, Docker files, old docs, browser extension
- Create Hono/Bun server with content extraction (Mozilla Readability)
  and AI feed API reading from mana-sync's sync_changes
- Create local-first store (articles, categories) with guest seed data
- Rewrite web app: Feed page, Saved articles with URL extraction,
  auth pages using shared-auth-ui, AuthGate with guest mode
- Add news to shared-branding (app icon, mana-apps registry)
- Add CLAUDE.md, dev scripts, root CLAUDE.md entry
- 0 type errors on both server and web

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-29 19:28:11 +02:00

2 KiB
Raw Blame History

News Hub — AI News Reader & Personal Library

Architecture

Local-first for saved articles, Hono/Bun server for content extraction and AI feed.

Browser → IndexedDB (Saved Articles, Categories)
              ↕ sync
         mana-sync → PostgreSQL

Browser → Hono Server → Content Extraction (Mozilla Readability)
                      → AI Feed (from sync_changes)

Project Structure

apps/news/
├── apps/
│   ├── web/        # SvelteKit web app (local-first)
│   ├── server/     # Hono/Bun (extraction, feed API)
│   └── landing/    # Astro marketing page
└── package.json

Tech Stack

Layer Technology
Web SvelteKit 2, Svelte 5 (runes), Tailwind CSS 4
Server Hono + Bun, Mozilla Readability, JSDOM
Data Local-first (Dexie.js + mana-sync)
Auth mana-core-auth (Better Auth + EdDSA JWT)

Commands

pnpm dev:news:web       # SvelteKit dev server
pnpm dev:news:server    # Hono/Bun server (port 3071)
pnpm dev:news:local     # Web + Sync + Server (no auth)
pnpm dev:news:full      # Everything incl. auth

Hono Server Routes

Route Auth Description
GET /health No Health check
GET /api/v1/feed No AI article feed (type, categoryId, limit, offset)
GET /api/v1/feed/:id No Single article
POST /api/v1/extract/preview No Preview URL content extraction
POST /api/v1/extract/save JWT Extract + return article data

Local-First Collections

Collection Purpose
articles Saved articles (user_saved) + AI feed cache
categories Article categories

Key Patterns

  • Content Extraction: Mozilla Readability + JSDOM for robust HTML parsing
  • Saved Articles: Local-first via IndexedDB, sync to server
  • AI Feed: Loaded from Hono server, not local-first (server-generated)
  • Auth: Guest mode allowed, sync starts on login