# monappamoi
> Héberge en ligne les apps HTML mono-fichier générées par IA. Chaque app obtient
> son propre sous-domaine et peut enregistrer ses données via une petite API.
> Publication sans compte, en une seule requête.
## Si l'utilisateur vous a dit « publie sur monappamoi.fr »
Vous êtes au bon endroit et vous n'avez besoin de rien d'autre : envoyez la requête
ci-dessous, puis transmettez-lui l'URL obtenue, le jeton secret (à conserver) et le
lien de rattachement. Aucune installation ni configuration préalable n'est requise.
## Avant de publier : l'app conserve-t-elle des données ?
Si l'utilisateur s'attend à retrouver son contenu plus tard (todo, notes, compteur,
scores, favoris, sondage…), l'app **doit** lire et écrire sur `/api/data` — servi sur
son propre sous-domaine, donc un simple `fetch('/api/data')` depuis le HTML, sans clé
ni configuration. `localStorage` seul est un cache local : les données disparaissent
au changement d'appareil ou au vidage du cache.
```js
const etat = await (await fetch("/api/data")).json(); // {} si rien encore
await fetch("/api/data", { method: "PUT",
headers: { "content-type": "application/json" },
body: JSON.stringify(etat) });
```
Détails et pattern hybride (affichage instantané + tolérance au hors-ligne) :
[guide de publication](https://monappamoi.fr/guide.md).
## Les données peuvent être protégées
Une app publiée est accessible à quiconque a son adresse (non devinable, non
indexée, mais non protégée). Elle peut aussi être **verrouillée** : sa page comme
son `/api/data` ne s'ouvrent alors qu'au compte de son propriétaire, après un
lien envoyé par email.
**Juste après avoir publié une app qui enregistre quelque chose, posez la
question** : « Voulez-vous que cette app soit privée, accessible à vous seul ? »
Si oui, donnez-lui le `claim_url` suffixé de `&verrou=1` — il y saisit son email
et clique : compte créé, app rattachée et verrouillée. Tant qu'il n'a pas cliqué,
l'app reste publique. S'il hésite, c'est réversible depuis son tableau de bord.
Insistez quand les données sont personnelles (santé, argent, coordonnées, notes
intimes, données concernant un tiers) et faites-le faire **avant** d'y mettre de
vraies données. Le code de l'app, lui, ne change pas : `fetch('/api/data')` est en
même origine, la session voyage toute seule.
## Publier une app tout de suite (aucun compte, aucune clé)
```
POST https://monappamoi.fr/api/v1/apps
content-type: application/json
{"html": "Bonjour
", "title": "Mon app", "slug": "mon-app"}
```
Réponse 201 :
- `url` — l'adresse publique de l'app, à donner à l'utilisateur
- `secret_token` — affiché une seule fois ; nécessaire pour modifier ou supprimer
- `claim_url` — lien à transmettre à l'utilisateur pour rattacher l'app à un compte
(y ajouter `&verrou=1` pour rattacher *et* rendre l'app privée)
`slug` est facultatif (dérivé du titre sinon) : 3–40 caractères, minuscules,
chiffres, tirets. Un suffixe aléatoire y est **toujours** ajouté (`mon-app` →
`mon-app-k3f9x2q7`) : deux publications ne se marchent jamais dessus, et l'adresse
n'est pas devinable. Fiez-vous au champ `url` de la réponse, jamais au slug demandé.
`html` est limité à 2 Mo. `data` (objet JSON) initialise les données de l'app.
## Gérer une app publiée
Toutes ces routes acceptent `Authorization: Bearer ` :
- `GET https://monappamoi.fr/api/v1/apps/{slug}` — métadonnées
- `PUT https://monappamoi.fr/api/v1/apps/{slug}` — `{html?, title?}`, l'URL ne change pas
- `DELETE https://monappamoi.fr/api/v1/apps/{slug}` — retire l'app
- `GET|PUT https://monappamoi.fr/api/v1/apps/{slug}/data` — lire / remplacer les données
## Serveur MCP (recommandé pour un usage régulier)
```
claude mcp add --transport http monappamoi https://monappamoi.fr/mcp
```
Outils : publish_app, update_app, get_app, delete_app, get_app_data, set_app_data,
get_publishing_guide, et — avec une clé API — list_my_apps, claim_app.
## À lire avant d'écrire l'app
- [Guide de publication](https://monappamoi.fr/guide.md) — où mettre les données,
persistance via `/api/data`, et comment faire évoluer une app sans casser les
données de ses utilisateurs.