Aller au contenu

Kirexo

Kirexo est une plateforme de diffusion d'articles multi-canaux : web, RSS, ActivityPub (fédivers Mastodon/Pixelfed), API. Chaque utilisateur rédige ses propres articles dans une interface inspirée de WriteFreely ; l'interface d'admin gère les comptes mais jamais le contenu. L'ajout de nouvelles destinations (Telegram, LinkedIn, Discord…) passe par un système de plugins extensible.

Cette documentation suit le framework Diátaxis : chaque page appartient à un et un seul des quatre quadrants ci-dessous.

Installer Kirexo chez soi

Vous voulez votre propre instance de Kirexo, sur un serveur que vous administrez : suivez Installer Kirexo chez soi. Quatre étapes, avec Docker seul.

Développer Kirexo

Un seul parcours d'entrée. Tout l'environnement de développement tient dans des conteneurs Docker pilotés par Castor depuis votre hôte : il n'y a ni PHP, ni Composer, ni Node à installer sur votre machine.

Ensuite, on travaille par worktree : un ticket, un checkout git, une stack Docker isolée avec ses trois URLs, montée par castor wt:up <ticket>. C'est ce qui permet de garder plusieurs branches ouvertes en parallèle, et c'est aussi ce qui rend défendable de laisser Claude Code tourner en bypassPermissions : le conteneur n'a aucune route vers Internet en dehors d'un proxy à allowlist, et pas de socket Docker.

Par où commencer

  • Tutoriels — apprendre en faisant. Installer sa propre instance, puis, côté développement, démarrer l'environnement et écrire un plugin.
  • Guides — résoudre un problème précis, recettes pas-à-pas.
  • Référence — consulter la vérité. Commandes Castor, variables d'environnement.
  • Explications — comprendre le « pourquoi » des choix techniques.

Pour aller plus loin

Le cadrage fonctionnel et technique complet vit dans projet.md à la racine du dépôt. Les règles de développement (patterns d'architecture, qualité, tests) sont dans CLAUDE.md. L'historique des évolutions est consultable dans le Changelog.