Malla est un monorepo Turborepo composé de six Workers Cloudflare et d'un ensemble de packages partagés. Tout tourne sur Cloudflare : Workers, Durable Objects, R2, KV, Queues, Workflows et Hyperdrive devant Neon Postgres.
text
┌── Cloudflare for SaaS (customer domains + SSL)
visitor ──► sites Worker ──── KV (host → site, publish id)
│ R2 (snapshots, compiled CSS, assets)
│ Cache API (rendered pages)
└─ /api/*, /_auth/* ──► runner Worker ── SiteDatabase DO (tables, visitors)
editor ──► web Worker (Nuxt) ──► api Worker (Hono) ── Hyperdrive ──► Neon Postgres
│ ├─ R2 (uploads) ├─ AI Gateway
├─► canvas frames (sandboxed) └─► sites (publish), runner (test runs)
└─► realtime Worker: Durable Object per page (Yjs + presence)
Les Workers
webL'éditeur Nuxt et les pages marketing. Relaie /api/** vers l'api via une liaison de service (service binding).
apiAPI REST Hono : authentification, sites, pages, CMS, formulaires, intégrations, facturation, domaines, IA.
realtimeUn Durable Object par page : synchronisation Yjs, présence, points de sauvegarde dans Postgres.
sitesPublie les instantanés et sert chaque site publié, chaque formulaire et chaque requête client.
runnerWorkflows serveur, crons, exécutions durables, tables natives et authentification des visiteurs.
mcpLe serveur MCP pour les agents, authentifié avec les clés d'API de l'espace de travail.
Six principes
- Un seul format de document partout. Les pages, les composants et la zone de brouillon du canevas partagent la forme
PageDoc. - Un seul moteur de rendu. Le canevas et le site publié exécutent le même
@malla/renderer: ce que vous voyez est ce qui est mis en ligne. - Un seul moteur de workflows. Les workflows client et serveur partagent un format JSON et
@malla/engine, avec des adaptateurs différents. - Les fonctions intégrées sont des plugins. REST, GraphQL et le CMS utilisent le même SDK de plugins que tous les autres connecteurs maison.
- Jamais d'
evalsur une saisie utilisateur. Les expressions sont interprétées à partir d'un AST ; le code personnalisé tourne dans des isolats. - Les secrets n'atteignent jamais le navigateur. Les appels authentifiés aux intégrations passent par un proxy côté serveur.
D'un geste à la base de données
GesteUn glisser-déposer, la modification d'un champ, un appel d'outil par l'IA.
OpsDes opérations typées et validées.
YjsAppliquées au Y.Doc, annulables.
SalleSynchronisées via le Durable Object de la page.
PostgresSauvegardées sous forme de JSON + état Yjs.
Voir Le document de page et Temps réel.
Où vivent les données
| Données | Stockage |
|---|---|
| Utilisateurs, espaces de travail, sites, pages, CMS, formulaires, intégrations, workflows, facturation | Neon Postgres (Drizzle, via Hyperdrive) |
| Documents de page en direct et journaux de modifications | SQLite du Durable Object de chaque page, sauvegardé dans Postgres |
| Tables natives, visiteurs, sessions, soumissions de formulaires | Durable Object SiteDatabase par site |
| Ressources téléversées, instantanés publiés, pages rendues | R2 |
| Routage des hôtes, workflows serveur publiés, cache des droits d'utilisation | KV |
| Consommation et statistiques | Analytics Engine |
Packages partagés
| Package | Rôle |
|---|---|
@malla/schema | Types et schémas Zod : PageDoc, ops, styles, données, workflows, CMS, tables, forfaits |
@malla/expr | Analyseur et interpréteur d'expressions, fonctions intégrées et métadonnées d'autocomplétion |
@malla/engine | Moteur de workflows et registre d'actions pour le navigateur et le serveur |
@malla/renderer | Document → HTML/CSS, runtime des cadres du canevas, interactions |
@malla/runtime | Le runtime d'îlots que chargent les sites publiés pour les liaisons, les formulaires et les workflows |
@malla/publish | Publication des instantanés et rendu à la demande |
@malla/ydoc | Correspondance Yjs des documents |
@malla/plugin-sdk, @malla/plugins | Définitions de plugins et plugins maison : REST, GraphQL, CMS, Postgres, Supabase, Airtable, Google Sheets, Resend, Anthropic et OpenAI |
@malla/bundle | Lots de site (bundles) pour les modèles, les sections et la copie entre sites |
@malla/ai-tools | Schémas des outils IA et MCP, compilés en ops |
@malla/db, @malla/auth-token | Schéma Drizzle et migrations ; jetons signés entre Workers |