MallaDocs
AccueilDémarrage rapideOuvrir Malla

Concepts clés

Espaces de travail, sites, pages, nœuds, classes, jetons, points de rupture et environnements sur une seule page.

Guide utilisateur

Malla a un vocabulaire restreint. Chaque guide utilise ces mots avec le même sens.

Du haut vers le bas
Espace de travailVotre équipe, ses membres, son forfait et ses clés d’API.
SitePages, composants, classes, jetons, CMS, tables.
PageUn document : un arbre de nœuds, des variables, des interactions.
NœudUn élément : type, props, styles, enfants.

Espaces de travail et sites

Un espace de travail représente votre équipe. Il possède les membres, un forfait d’espace de travail (sièges et consommation d’IA) et des clés d’API pour les agents. Un espace de travail contient autant de sites que vous voulez. Chaque site a son propre forfait, ses pages, son design system, son contenu, ses données et ses domaines.

Pages, nœuds et documents

Une page est un document unique : une table plate de nœuds, plus des variables de page et des interactions. Un nœud est un élément du canevas, comme une section, un cadre, un texte, un lien, une image, une liste de collection, un formulaire, un champ de saisie ou une instance de composant. Chaque nœud a un type, des props (son contenu et ses réglages) et des styles.

Les pages ont un chemin comme /pricing. Une page modèle a un chemin dynamique comme /blog/:slug et s’affiche une fois par élément du CMS.

Classes, jetons et composants

  • Les jetons de design sont des variables CSS à l’échelle du site pour les couleurs, les polices et les espacements. Modifiez un jeton, et toutes ses utilisations suivent.
  • Les classes sont des règles de style réutilisables. Une classe combinée s’appuie sur une classe parente, comme btn + btn-ghost.
  • Les styles locaux s’appliquent à un seul nœud et l’emportent sur ses classes.
  • Les composants sont des blocs de mise en page réutilisables avec des variantes. Chaque copie sur une page est une instance et peut remplacer les textes, les images, les styles et la visibilité.

Points de rupture et états

Malla est desktop-first. Vous concevez la base (desktop, 1440 px) et remplacez des valeurs sur tablette (991 px et moins) et mobile (767 px et moins). Chaque point de rupture peut aussi styliser les états hover, focus et active.

Données et logique

  • Les liaisons remplacent une valeur littérale par une expression, comme item.title ou vars.count > 0.
  • Les variables contiennent l’état de la page ou du site.
  • Les intégrations connectent un site à REST, GraphQL ou au CMS ; les requêtes récupèrent des données à travers elles.
  • Les workflows sont des listes d’étapes lancées par un déclencheur. Les workflows client s’exécutent dans le navigateur ; les workflows serveur s’exécutent sur l’edge.
  • Les tables natives sont la base de données SQL propre au site pour les données applicatives, protégée par des règles de ligne.

Environnements

Chaque site a deux environnements. La préproduction (staging) vit sur un sous-domaine Malla et n’est jamais indexée par les moteurs de recherche. La production est ce que voient vos visiteurs, sur votre propre domaine. Les formulaires, les soumissions et les workflows serveur sont séparés par environnement.

Personnes

Les utilisateurs de l’éditeur construisent les sites : propriétaires, administrateurs, éditeurs, lecteurs et éditeurs de contenu. Les visiteurs utilisent le site publié et peuvent avoir leurs propres comptes. Les deux ne se mélangent jamais : tables, sessions et clés séparées. Voir Équipe et rôles et Comptes visiteurs.