Skip to main content
Komamy est une plateforme auto-hébergée de lecture de webcomics/scans façon mangadex.org, doublée d’un espace d’annonces éditoriales et d’un espace communautaire (messagerie privée, commentaires, blog communautaire, tickets de signalement). Écrite entièrement en TypeScript, elle tourne sur Bun avec une base de données PostgreSQL. Cette documentation couvre trois publics : les lecteurs qui utilisent le site au quotidien, les teams qui publient des webcomics, et les développeurs/opérateurs qui font tourner et font évoluer l’instance.

Démarrage rapide

Déployez une instance Komamy en quelques minutes avec Docker.

Guide lecteur

Créer un compte, lire, commenter, suivre vos équipes préférées.

Guide équipe

Publier des projets, des chapitres, des articles, gérer une équipe.

Documentation développeur

Architecture, base de données, API, contribution et déploiement.

​
Fonctionnalités principales

Projets organisés en chapitres (pages images, uploadées individuellement ou en .zip, ou importées depuis MangaDex), tags, favoris, notes 1-5 étoiles, historique/suivi de lecture, téléchargement CBZ, compteur de vues par chapitre.
Fiches publiques d’auteurs et d’équipes de scan (« teams »), avec membres et rôles, fil d’actualité façon réseau social, agenda de sorties, succès et statistiques d’équipe.
Articles Markdown éditoriaux (réservés au staff) avec tags et statut brouillon/publié, et un blog communautaire ouvert à tout utilisateur connecté (catégories, tags libres, réactions).
Commentaires par projet/chapitre/article, messagerie privée, tickets de signalement, mentions (@utilisateur, @œuvre…), notifications par type.
Projets, auteurs, équipes, utilisateurs et tags dans une seule requête, plus autocomplétion en temps réel.
Gestion des utilisateurs, articles, webcomics, auteurs, équipes, tickets, tags et paramètres du site, avec accès restreint par rôle — voir Rôles & permissions.
Fusion/découpe de planches, redimensionnement, vidage de bulles, conversion, filigrane, contrôle qualité, sur-échantillonnage IA — réservés aux membres d’équipe et au staff.
Manifest + service worker, icônes dédiées, coquille applicative disponible hors-ligne et cache des images de chapitres déjà consultées.

​
Stack technique

Vous administrez déjà une instance ? Passez directement au guide équipe pour publier votre premier projet, ou à la documentation développeur pour comprendre le code.