11e132d3a1
README, llms.txt und der Blog-Beitrag nennen jetzt alle drei offenen Repos unter git.mana.how/offen. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
72 lines
3.2 KiB
Markdown
72 lines
3.2 KiB
Markdown
# Pageta
|
|
|
|
Lese-App des Vereins [mana](https://mana.how): Links speichern, sauber lesen,
|
|
in vier Farben markieren — ohne Algorithmus, ohne Werbung, ohne Tracking.
|
|
|
|
- App: [app.pageta.com](https://app.pageta.com)
|
|
- Website: [pageta.com](https://pageta.com) · zum Ausprobieren ohne Konto:
|
|
[pageta.com/probelesen](https://pageta.com/probelesen)
|
|
- Lizenz: [AGPL-3.0-or-later](LICENSE) — siehe [`COPYRIGHT`](COPYRIGHT)
|
|
- Apps: [iOS/macOS](https://git.mana.how/offen/pageta-native) ·
|
|
[Android](https://git.mana.how/offen/pageta-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`](CLAUDE.md), der
|
|
Stand in [`STATUS.md`](STATUS.md).
|
|
|
|
## Bauen — und die ehrliche Grenze
|
|
|
|
```bash
|
|
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](https://mana.how) 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.
|