So funktioniert's
Architektur
Ein TypeScript-Monorepo mit protokollneutralem Kern. Einfach zu betreiben, leicht zu lesen.
Prinzipien
Protokollneutraler Kern
Die Domäne kennt Beiträge und Menschen, keine Protokolle.
Privatsphäre zuerst
Sichtbarkeit ist eine Eigenschaft jedes Objekts, geprüft an einer Stelle.
Leicht zu hosten
Node, PostgreSQL, Redis. Ein kleiner VPS reicht.
Portabilität
Export, Import und Kontoumzug.
Moderation vom ersten Tag an
Meldungen, Blockierungen, Rate-Limits, Audit-Log.
Durchgängig typisiert
Server und Web-App teilen Typen und Schemas.
Der Stack
Server
- Node.js 22 LTS
- Fastify + Zod
- Drizzle ORM + PostgreSQL 16+
- Redis + BullMQ
- Fedify (ActivityPub)
- Unsere eigene diaspora*-Bibliothek
Web
- React 19 + Vite
- TanStack Router & Query
- Tailwind CSS v4
- i18next (en, it, es)
- PWA + Web Push
- Mastodon-kompatible API für Apps
Qualität
- TypeScript strict
- Vitest: 450+ Tests
- diaspora*-Fixtures aus dem offiziellen Gem
- Biome
- Turborepo
- Continuous Integration
Das Monorepo
apps/server REST API, inbox/outbox, WebSocket
apps/worker BullMQ jobs: federated delivery
apps/web React single-page app
packages/core domain: posts, people, canView()
packages/db Drizzle schema and migrations
packages/activitypub ActivityPub adapter (Fedify)
packages/diaspora diaspora* protocol and bridge
packages/diaspora-import in-place pod migration
packages/shared shared types and Zod schemas
packages/config typed configurationJedes föderierbare Objekt hat sowohl eine ActivityPub-URI als auch eine diaspora*-GUID. Designentscheidungen sind in docs/decisions.md festgehalten.
Schichten
Web & Apps
Die React-App und Mastodon-Apps sprechen mit derselben /api/v1.
API
Fastify-Routen validieren Eingaben mit Zod und rufen den Kern auf.
Kern
Soziale Regeln, Sichtbarkeit und Events, ohne Protokoll darin.
Adapter
ActivityPub und diaspora* übersetzen Events in Nachrichten und zurück.
