Open source

lomi. suit un modèle hébergé d’abord. Les marchands s’intègrent via notre API cloud, le tableau de bord et le checkout. Nous ne proposons pas l’auto-hébergement du traitement des paiements à ce stade.

Notre direction à long terme est d’ouvrir progressivement le monorepo, davantage d’apps, davantage de code source, et à terme un chemin supporté pour les opérateurs qui s’auto-hébergent avec leurs propres accords prestataires et leur conformité. Ce n’est pas disponible aujourd’hui ; voir la feuille de route pour ce qui est public maintenant.

Nous publions tout de même du code source pour la transparence et les outils d’intégration (SDK, CLI, plugins, docs). Dans cette logique, nous appliquons une double licence.

Le projet est principalement sous GNU Affero General Public License (AGPL) : la communauté peut utiliser, modifier et redistribuer le logiciel librement. L’AGPL impose toutefois que toute utilisation en service (SaaS notamment) publie également le code source. Si vous souhaitez utiliser lomi. sans publier vos modifications (intégration à un produit propriétaire) ou l’exploiter commercialement pour des offres similaires, une licence commerciale est requise.

Certains composants relèvent exclusivement de notre licence commerciale, pour les entreprises ayant besoin de fonctionnalités additionnelles ou d’une plus grande flexibilité. Ce double modèle nous permet de servir à la fois la communauté open source et les partenaires enterprise.

Voir le fichier LICENSE du monorepo pour les textes complets des deux licences.

Qu’est-ce qui est open source aujourd’hui ?

Domaine	Disponibilité
Plateforme hébergée (API, tableau de bord, checkout, MoR)	✅ Production, créer un compte
API et webhooks	✅ Hébergé uniquement
SDK, CLI, MCP, plugins	✅ Outils d’intégration (code + packages)
Site de documentation	✅ Open source (`apps/docs`)
Tableau de bord marchand, checkout, storefront	🔒 Produit hébergé (ouverture progressive du code)
Admin	🔒 Propriétaire

Pas d’auto-hébergement aujourd’hui. Le traitement des paiements repose sur l’infrastructure hébergée de lomi., Merchant of Record, accords prestataires, conformité et stack opérationnelle. Un clone local sert au développement et à la contribution, pas à exploiter votre propre processeur de paiement.

Plateforme hébergée

Pour les paiements en production, utilisez la plateforme sur lomi.africa : canaux de paiement intégrés, couverture Merchant of Record, mises à jour automatiques et support dédié.

Comparaison rapide

Fonctionnalité	Outils open source	Plateforme hébergée
API et webhooks	Intégration sur l’API hébergée	✅
Canaux de paiement intégrés	-	✅
Tableau de bord et checkout	-	✅
SDK, CLI, MCP, plugins	✅ Outils d’intégration (code + packages)	✅
Auto-hébergement du stack paiement	À la feuille de route	-
Mises à jour automatiques	-	✅
Support dédié	Communauté	✅

Options de support

La plateforme hébergée inclut notamment :

support technique 24/7
traitement prioritaire des incidents
aide à la mise en œuvre

Ressources

Feuille de route

Nous ouvrons progressivement le monorepo. L’auto-hébergement du stack paiement complet est un objectif à long terme, pas une offre supportée en production aujourd’hui. La trajectoire : publier plus de code → documenter les prérequis opérateur (prestataires, MoR, conformité) → proposer une option auto-hébergée supportée quand le stack sera complet et sûr sans les services hébergés de lomi.

Ce qui est ouvert aujourd’hui :

Déjà en open source :
- Site de documentation : apps/docs (ce site)
- CLI (apps/cli), outil d’intégration ; s’appuyer sur l’API hébergée, pas sur l’exploitation plateforme
- Service API : apps/api
- SDK : apps/sdks
- Plugins e-commerce : dépôts séparés sous apps/plugins/, woo, magento, prestashop, shopify, bubble
- Serveur MCP (apps/mcp), outil d’intégration ; API marchande dans l’IDE, pas l’exploitation plateforme
- Boilerplate événements (dépôt séparé) : lomiafrica/events
Bientôt :
- Tableau de bord marchand : apps/dashboard
Propriétaire :
- Tableau de bord admin : apps/admin
Produit hébergé (code pas entièrement public) :
- Checkout : apps/checkout
- Storefront : apps/storefront
- Portail client : apps/customers
- Site marketing : apps/website

De nombreux fichiers, surtout les migrations et la logique paiement cœur, portent la mention /* @proprietary license */ même dans des apps sous AGPL.

Organisation du monorepo

└── lomi./
    ├── README.md
    ├── CONTRIBUTING.md
    ├── LICENSE
    ├── pnpm-workspace.yaml
    ├── tooling/          # eslint, knip, tsconfig, postcss, scripts partagés (pas un package)
    ├── packages/
    │   ├── ui/           # @lomi./ui — primitives React partagés (interne workspace)
    │   ├── shared/       # @lomi./shared — formatage, json-value, types Database générés
    │   ├── queries/      # @lomi./queries — wrappers RPC injectés
    │   ├── pay/          # @lomi./pay — chrome formulaire checkout/storefront (React 19)
    │   └── receipt-pdf/  # @lomi./receipt-pdf — PDF de reçu (workspace + npm)
    └── apps/
        ├── admin/        # Admin interne (propriétaire)
        ├── api/          # API paiement NestJS (open source)
        ├── checkout/     # Checkout hébergé (produit hébergé)
        ├── cli/          # CLI Rust (outil intégrateur ; open source)
        ├── customers/    # Portail client (produit hébergé)
        ├── dashboard/    # Tableau de bord marchand (ouverture prochaine)
        ├── design/       # Assets design partagés
        ├── docs/         # Documentation développeur (open source, cette app)
        ├── jumbo/        # Application marchande MPOS (terminal mobile)
        ├── mcp/          # Serveur MCP (outil intégrateur ; open source)
        ├── plugins/      # WooCommerce, Magento, PrestaShop, Shopify, Bubble, références
        ├── sdks/         # SDK TypeScript, Python, PHP, Go (open source)
        ├── storefront/   # Storefront marchand (produit hébergé)
        └── website/      # Site marketing (produit hébergé)

`@lomi./ui` vs lomi-ui (docs)

Ce ne sont pas la même chose. Ne pas les fusionner.

	`@lomi./ui` (`packages/ui`)	lomi-ui (`apps/docs/components/lomi-ui/`)
Public	Apps produit lomi. (dashboard, admin, checkout, storefront, website, customers) et chrome docs	Marchands qui construisent leur propre checkout React
Distribution	Package workspace privé (jamais npm)	Copier-coller public via `lomi ui add` / registre docs
Contenu	Primitives partagées + interior.dev	Sélecteur de prestataire, formulaire client, carte mobile money, etc.

Le chrome docs (layout, previews, scripts) peut importer @lomi./ui et @lomi./shared via file:. Le registre marchand lomi-ui sous apps/docs/components/lomi-ui/ reste autonome et ne doit pas importer ces packages privés.

Tableau de bord marchand (`apps/dashboard`)

Le tableau de bord est le back-office marchand (transactions, liens de paiement, paramètres, analytics). C’est un produit hébergé aujourd’hui ; le code s’ouvre progressivement.

Structure simplifiée :

└── apps/dashboard/
    ├── package.json
    ├── .env.example
    ├── src/              # Application React (Vite)
    ├── supabase/         # Migrations DB et edge functions (référence)
    │   └── migrations/
    └── public/           # Assets statiques

Les migrations sous supabase/migrations/ font foi pour le schéma plateforme. Ce n’est pas une recette pour exploiter votre propre stack paiement sans les services hébergés de lomi. et les accords prestataires.

Contribuer

Les contributions sur les zones open source et la documentation sont les bienvenues. Ouvrez une issue ou une pull request sur le monorepo lomi..

Avant de contribuer :

Lisez notre code de conduite
Consultez la politique de sécurité
N’altérez pas les fichiers marqués /* @proprietary license */

Voir Contribuer et CONTRIBUTING.md du monorepo.

Besoin d’aide pour choisir ?

Pour toute question sur l’open source et la plateforme hébergée : hello@lomi.africa.

Pour notre vision : blog ou outil de tarification.

Liens utiles

Discord : communauté Discord
X : @lomiafrica
GitHub : issues et pull requests
Email : hello@lomi.africa

Open source

Sur cette page