Comment ça marche
Architecture
Un monorepo TypeScript avec un cœur neutre vis-à-vis des protocoles. Simple à faire tourner, facile à lire.
Principes
Cœur neutre
Le domaine connaît les publications et les personnes, pas les protocoles.
La vie privée d'abord
La visibilité est une donnée de chaque objet, vérifiée en un seul endroit.
Facile à héberger
Node, PostgreSQL, Redis. Un petit VPS suffit.
Portabilité
Export, import et déménagement de compte.
Modération dès le premier jour
Signalements, blocages, limites de débit, journal d'audit.
Typé de bout en bout
Le serveur et l'appli web partagent types et schémas.
La stack
Serveur
- Node.js 22 LTS
- Fastify + Zod
- Drizzle ORM + PostgreSQL 16+
- Redis + BullMQ
- Fedify (ActivityPub)
- Notre propre bibliothèque diaspora*
Web
- React 19 + Vite
- TanStack Router & Query
- Tailwind CSS v4
- i18next (en, it, es)
- PWA + Web Push
- API compatible Mastodon pour les applis
Qualité
- TypeScript strict
- Vitest: 450+ tests
- fixtures diaspora* issues de la gem officielle
- Biome
- Turborepo
- Intégration continue
Le 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 configurationChaque objet fédérable a à la fois une URI ActivityPub et un GUID diaspora*. Les choix de conception sont consignés dans docs/decisions.md.
Couches
Web et applis
L'appli React et les applis Mastodon parlent à la même /api/v1.
API
Les routes Fastify valident les entrées avec Zod et appellent le cœur.
Cœur
Règles sociales, visibilité et événements, sans aucun protocole à l'intérieur.
Adaptateurs
ActivityPub et diaspora* traduisent les événements en messages, et inversement.
