# Capibara for Developers

> Construisez des apps pour Capibara sans accès à son code source :
> manifeste déclaratif, permissions consenties par le tenant, API publique,
> authentification OAuth, publication et partage de revenu.

## Démarrer
- [Démarrer : votre première app, de zéro à la publication](https://capibara.fr/dev/docs/raw/demarrer): Tutoriel complet : compte développeur, un widget météo sans une ligne de code (manifeste seul), l'installation de test, la publication sur le marketplace — puis la même app avec la CLI, puis avec du code hébergé.
- [La CLI capibara](https://capibara.fr/dev/docs/raw/cli): Installer la commande capibara, lier un dossier au projet du portail par une clé de projet, développer en deploy-on-save sur votre organisation de test, lire le journal, créer et publier une version — sans tunnel ni émulateur.
- [Utiliser cette doc avec votre IA](https://capibara.fr/dev/docs/raw/llm): Les URLs llms.txt, llms-full.txt, le Markdown brut par page et l'archive ZIP — pour construire une app Capibara avec l'aide d'un assistant IA.

## Référence
- [Référence du manifeste add-on.json](https://capibara.fr/dev/docs/raw/manifeste): Chaque champ du manifeste add-on.json : type, contrainte exacte, règles de tarification croisées, erreurs de validation typiques et 3 manifestes complets.
- [Capabilities, bornes et erreurs](https://capibara.fr/dev/docs/raw/capabilities): Chaque capability du manifeste, ce qu'elle autorise, quand la demander — et, en un seul endroit, les bornes réelles de l'exécution (temps, tailles, appels, concurrence, disjoncteur) et les erreurs que votre code peut rencontrer.
- [Le Kit — l'UI déclarative des apps](https://capibara.fr/dev/docs/raw/kit): Votre app ne produit jamais d'HTML : elle renvoie un arbre JSON de composants (le Kit) que Capibara rend avec ses propres composants, à sa charte — page d'app, panneau sur une fiche, widget, page du site public, formulaire.
- [Le runtime — defineApp](https://capibara.fr/dev/docs/raw/runtime): Comment votre code hébergé s'exécute : `defineApp({ pages, widgets, panels, forms, actions, events, schedules, http })`, le contexte `ctx`, le protocole d'interaction (rendu → Kit, action → effets), les limites et le journal.
- [Widgets déclaratifs](https://capibara.fr/dev/docs/raw/widgets-declaratifs): Des widgets d'accueil sans page ni code : un template, des champs de config saisis par l'utilisateur, une source de données allowlistée — la plateforme collecte et rend à la charte Capibara.
- [Scopes et consentement de l'organisation](https://capibara.fr/dev/docs/raw/permissions): Le catalogue fermé des scopes qu'une app peut demander (ressources feuilles, jamais un module entier), la phrase que voit l'administrateur, le compte de service sous lequel l'app agit, et « utiliser l'app ».
- [Les façades — l'API des modules](https://capibara.fr/dev/docs/raw/facades): Ce que votre app peut lire et écrire dans le CRM, la facturation, la boutique, les projets, le planning, les membres du site et la formation — depuis le code hébergé (`ctx.capibara`) ou depuis votre backend (REST), sous les scopes accordés.
- [Données : collections, fichiers, réglages](https://capibara.fr/dev/docs/raw/donnees): Où vivent les données de votre app (chez l’organisation), comment les déclarer, les lire et les écrire, et ce qu’il en advient à la désinstallation.
- [Moteurs : e-mail, notifications, calendrier, recherche, validations](https://capibara.fr/dev/docs/raw/moteurs): Ce que votre app peut envoyer, notifier, projeter, indexer ou faire valider chez l’organisation — par les moteurs de Capibara, avec leurs garde-fous et leurs quotas.
- [SDK @capibara-dev/sdk](https://capibara.fr/dev/docs/raw/sdk): Le SDK TypeScript officiel : types du Kit, du manifeste, des scopes et des façades générés depuis les schémas de la plateforme, defineApp + ui, harnais de test local, client API, OAuth PKCE et webhooks — zéro dépendance.
- [Backend externe : servir une app depuis votre serveur](https://capibara.fr/dev/docs/raw/backend-externe): Héberger la logique de votre app chez vous : manifeste, secret et signature des requêtes, createBackend, ce qui reste réservé au code hébergé, paiements, tests, review.

## API & intégration
- [Sign in with Capibara (OAuth)](https://capibara.fr/dev/docs/raw/oauth): Les deux grants OAuth réels de Capibara — client_credentials serveur-à-serveur et authorization_code + PKCE avec écran de consentement — séquences curl complètes.
- [API publique](https://capibara.fr/dev/docs/raw/api-publique): Authentification Bearer (clé API, jeton OAuth ou clé de projet), /me, embed-context, les façades par installation, l'API de projet (clé cpk_… de la CLI), les quotas et les conventions d'erreur.
- [Webhooks sortants](https://capibara.fr/dev/docs/raw/webhooks): Recevez les événements métier (commande, facture, contact…) des organisations qui utilisent votre app : configuration, signature HMAC, retries, idempotence.

## Distribution
- [Publication et review](https://capibara.fr/dev/docs/raw/publication): Soumettre en review (portail ou capibara deploy), ce que le build automatisé et la review vérifient, la validation automatique, les motifs de refus, publier, mettre à jour, le kill switch, le retrait de fiche et la fiche marketplace.
- [Revenus et rev-share](https://capibara.fr/dev/docs/raw/revenus): Le modèle de prix du manifeste, l'inscription Stripe Connect Express, les 3 paliers de partage chiffrés en euros, les relevés mensuels, les remboursements et la responsabilité fiscale du développeur.

## Autres formats
- [Documentation complète en un seul fichier](https://capibara.fr/llms-full.txt): toutes les pages concaténées, pour être collées telles quelles dans le contexte d'un agent.
- [Archive .zip](https://capibara.fr/dev/docs/download): un fichier Markdown par page.
- [Portail développeur](https://capibara.fr/dev/docs): version mise en page, avec sommaire et recherche.