pageta/README.md

Pageta

Lese-App des Vereins mana: Links speichern, sauber lesen, in vier Farben markieren — ohne Algorithmus, ohne Werbung, ohne Tracking.

• App: app.pageta.com
• Website: pageta.com · zum Ausprobieren ohne Konto: pageta.com/probelesen
• Lizenz: AGPL-3.0-or-later — siehe COPYRIGHT
• Apps: iOS/macOS · Android — ebenfalls offen

Pageta ist das erste Produkt von mana, dessen Quellcode offen liegt. Der Anlass ist Pocket: ein Lese-Werkzeug, das Millionen Menschen benutzt haben und das mit einer Firmenentscheidung verschwand. Unter der AGPL kann niemand diesen Code nachträglich schliessen — auch der Verein nicht.

Was hier liegt

apps/
  web/        SvelteKit-App (app.pageta.com) — Lese-Liste, Reader, Markierungen
  api/        Hono + Bun — Textextraktion, Zusammenfassung, Import-Aufträge
  landing/    Astro — pageta.com
  extension/  Browser-Erweiterung (Chromium/Firefox, noch nicht in den Stores)
packages/
  pageta-domain/  reine TypeScript-Typen und -Logik
infrastructure/   Compose-Dateien; Geheimnisse nur SOPS/age-verschlüsselt
docs/             Architektur, Deploy, Entscheidungen

Die Lese-Liste ist local-first und event-sourced: Artikel, Markierungen und Tags liegen als Ereignisse auf dem Gerät und werden verschlüsselt synchronisiert. Der Server holt nur Text aus Webseiten und rechnet, was ein Browser nicht kann. Die Invarianten stehen in CLAUDE.md, der Stand in STATUS.md.

Bauen — und die ehrliche Grenze

pnpm install
pnpm docker:up                      # lokales Postgres :5443
pnpm --filter @pageta/api db:push
pnpm dev                            # api :3099, web :3100

⚠️ Heute gelingt das nur mit Zugang zum mana-Paketserver. Pageta bezieht rund zwanzig @mana/*-Pakete (Anmeldung, Synchronisation, Oberflächen- Bausteine) aus pkg.mana.how, der noch nicht öffentlich ist, und braucht zur Laufzeit die mana-Plattform (Anmeldung, Sync). Den Code lesen und prüfen kannst du vollständig; ihn ohne Weiteres selbst betreiben noch nicht. Diese Lücke zu schliessen ist der nächste Schritt, nicht erledigt.

Für Mitlesende

Dieses Repo gehört zum Ökosystem von mana und liegt offen, damit andere es lesen, einordnen und als Grundlage nutzen können — das spart Arbeit, egal ob ein Mensch oder ein Modell davorsitzt.

Was du erwarten darfst: den Code so, wie er tatsächlich in Gebrauch ist, unter AGPL-3.0-or-later. Keine Attrappe, kein zurechtgeschnittener Auszug — samt seiner Geschichte.

Was du nicht erwarten darfst: Support, Antwortzeiten, Zusagen zur Abwärtskompatibilität oder die Übernahme von Änderungswünschen. Dieses Repo folgt dem, was die App braucht. Fehlermeldungen sind willkommen (am schnellsten über den Feedback-Knopf in der App oder auf pageta.com), eine Antwort ist nicht zugesagt.

Fork ist ausdrücklich erlaubt und oft der schnellere Weg als zu warten. Wer Pageta verändert und als Dienst anbietet, legt seine Änderungen offen — das verlangt die AGPL (§13), und genau darum steht sie hier.