Vision
Où va VLLNT UI : UI générative avec json-render et l'AI SDK, voix, 3D, AR et interfaces holographiques, verre par défaut, et ce qui est disponible aujourd'hui.
VLLNT UI est la couche UI sur laquelle reposent tous les produits vllnt : le web aujourd'hui, React Native en canary, le desktop et le spatial ensuite. L'objectif est d'être le moyen le plus rapide, pour les personnes comme pour les agents IA, de construire des interfaces. La marque vllnt est le thème par défaut, et chaque composant respecte le WCAG 2.2 AA.
Les interfaces changent sur cinq axes : génératives, vocales, 3D, AR et spatiales, holographiques. VLLNT UI est conçu pour être la base des cinq.
Plateformes
VLLNT UI vise tous les types d'interfaces. Voici où en est chaque cible aujourd'hui.
- Web (React DOM, Next.js) : disponible.
@vllnt/uiest publié sur npm, avec des versions stables et une version canary à chaque changement. - Mobile, React Native (iOS, Android, Expo) : en canary.
@vllnt/ui-nativene publie que des versions canary ; il n'existe pas encore de version stable. Chaque canary est installée dans une app Expo vierge et exportée pour iOS et Android avant d'être retenue. Voir Native. - Desktop, Electron et Tauri : sur la feuille de route. Rien de spécifique au desktop n'existe encore : ni tests, ni packaging, ni guide.
- Desktop, apps macOS natives : sur la feuille de route. Il n'existe pas de moteur de rendu SwiftUI ou AppKit.
- 3D, scènes dans la page : sur la feuille de route. Seules des briques en pseudo-3D sont disponibles aujourd'hui :
Globe3D(une projection SVG) etTiltCard(3D en CSS). Il n'existe pas encore de couche de scène WebGL. - Réalité augmentée et spatial, visionOS et WebXR : proposition. Les fondations spatiales font l'objet d'une RFC ouverte (vllnt/ui#631). Il n'existe pas de moteur de rendu spatial.
- Interfaces holographiques interactives : sur la feuille de route. Certaines briques sont disponibles sur le web : des surfaces façon verre (
GlassPanel,GlassCard,LiquidGlass), une jauge circulaire (ThresholdRing), des contrôles de HUD (ZoomHUD) et des docks. Elles utilisent des valeurs de flou locales ; les tokens de verre viendront avec vllnt/ui#684. Les composants holographiques eux-mêmes n'existent pas encore. - UI générée par l'IA et diffusée en continu : en partie disponible. Les descripteurs, le serveur MCP, les thèmes sous forme de données et les composants de flux continu existent ; les adaptateurs json-render et AI SDK, non (vllnt/ui#672).
- UI pensée pour la voix : sur la feuille de route. Aucun composant vocal n'est encore disponible : ni transcription, ni état d'écoute, ni forme d'onde, ni sortie vocale. Le texte diffusé en continu est déjà annoncé par une région live dans
AIStreamingText.
Un socle, un moteur de rendu par plateforme
La règle qui rend cela possible : le socle reste indépendant de toute plateforme, et chaque plateforme est un moteur de rendu posé dessus.
- Le socle contient ce que toutes les plateformes partagent : les tokens de design, les contrats de composants (les noms des options et des props), les règles de plateforme et, plus tard, les schémas de props derrière chaque descripteur. Il n'a aucune dépendance à l'exécution et n'importe aucun moteur de rendu.
- Un moteur de rendu transforme le socle en composants réels pour une plateforme :
@vllnt/uipour le web et@vllnt/ui-nativepour React Native aujourd'hui, puis des moteurs de rendu desktop, macOS, visionOS ou WebXR. - Les dépendances vont dans un seul sens. Les moteurs de rendu dépendent du socle, jamais l'inverse, et aucun moteur de rendu n'en importe un autre. Une décision partagée par deux plateformes entre d'abord dans le socle.
Aujourd'hui, le paquet natif lit ses tokens et ses contrats depuis @vllnt/ui-core, et le paquet web reçoit les mêmes tokens sous forme de CSS générée. Déplacer les schémas de props dans le socle est sur la feuille de route.
1. Les interfaces 3D, spatiales et holographiques
Les appareils de réalité augmentée et spatiaux placent l'interface dans la pièce autour de vous, et non plus sur un écran plat ; les scènes 3D lui donnent de la profondeur sur n'importe quel écran. Les briques restent les mêmes : boutons, listes, dialogues, texte. Ce qui change, c'est la profondeur, la façon de désigner (main, regard, voix) et la taille qu'une cible doit avoir.
Les interfaces holographiques interactives vont plus loin : des panneaux translucides superposés en profondeur, des HUD denses en données, des menus radiaux et orbitaux, une saisie par le geste, le regard et la voix, et des panneaux diffusés en direct ou générés par un agent. Nous voulons les construire avec les mêmes tokens et les mêmes composants, et les mêmes règles d'accessibilité.
Le but : que les mêmes composants et les mêmes tokens s'affichent sur un téléphone, sur un ordinateur et dans l'espace, sans kit séparé pour chacun.
2. L'UI dynamique, composée par l'IA
De plus en plus, une interface ne sera plus conçue une fois puis livrée à tous à l'identique. Un modèle ou un serveur la composera à l'exécution à partir de briques connues, l'enverra à l'écran au fil de sa génération, l'adaptera à la personne qui l'utilise et la mettra à jour sans attendre une nouvelle version de l'application.
Pour cela, les briques doivent être :
- Descriptibles : un agent peut trouver un composant, lire ce qu'il fait et les props qu'il accepte, et l'utiliser correctement.
- Pilotées par les données : un composant est entièrement défini par ses props, et un thème est une donnée, donc les deux peuvent circuler sur le réseau.
- Sûres en flux continu : un écran garde sa mise en page pendant que le contenu arrive encore.
- Sûres à mettre à jour : une nouvelle version ne casse pas les écrans déjà construits sur l'ancienne.
- Accessibles par défaut : un écran généré respecte le WCAG 2.2 AA comme un écran fait à la main.
3. Les interfaces pensées pour la voix
Les interfaces de nouvelle génération seront générées, et beaucoup seront pensées d'abord pour la voix. L'interface suit la voix : une personne parle, l'interface montre qu'elle écoute et ce qu'elle a compris, répond à voix haute et à l'écran, et peut diffuser en continu une UI générée en réponse.
Pour cela, VLLNT UI doit proposer :
- Des surfaces conversationnelles qui réunissent la transcription, la réponse et l'UI générée au même endroit.
- Une transcription en direct et des états d'écoute : le texte provisoire et définitif, et des états clairs : repos, réveil, écoute, réflexion, parole, micro coupé et erreur.
- Le push-to-talk et les états de réveil, utilisables aussi au clavier et par contacteur.
- Des formes d'onde et des indicateurs de niveau qui ne portent jamais de sens par le seul mouvement, et restent immobiles quand le mouvement est réduit.
- Un retour vocal doublé d'un équivalent texte : chaque réponse parlée est aussi un texte visible et sélectionnable.
- Une UI diffusée en continu, pilotée par la voix : un tour de parole alimente l'AI SDK ou une spec json-render, et l'écran se met à jour à mesure que la réponse arrive.
Rien de ceci n'est encore disponible. Le suivi se fait dans vllnt/ui#683.
Le verre par défaut
Le verre doit devenir l'apparence par défaut de VLLNT UI partout, y compris le cadre des pages et ce site. Dessous, la base ne change pas : noir et blanc, Inter et JetBrains Mono.
- La lisibilité d'abord. Les panneaux qui portent du texte ont assez de flou et de teinte, ou d'opacité, pour respecter le contraste WCAG 2.2 AA.
- Opaque quand il le faut. Une surface opaque remplace automatiquement le verre quand l'utilisateur demande moins de transparence ou plus de contraste, sur les appareils peu puissants et sur les plateformes natives sans flou. Chaque composant en verre propose aussi une variante opaque.
- Dans un budget. Le flou coûte du temps de rendu : le nombre de couches floutées et leur rayon ont un budget de performance.
C'est décidé mais pas encore construit : aujourd'hui, le thème par défaut est opaque. Le passage au verre est suivi dans vllnt/ui#684.
Travailler avec la pile IA de Vercel
Nous voulons que VLLNT UI fonctionne nativement avec deux outils open source de Vercel :
- json-render : vous définissez un catalogue de composants, chacun avec un schéma de props zod et une description. Le modèle produit une spec JSON (diffusée sous forme de patchs JSON) et un moteur de rendu la transforme en React. Un catalogue VLLNT UI permettrait aux modèles de construire des écrans avec les composants VLLNT UI.
- L'UI générative de l'AI SDK : un appel d'outil arrive dans
useChatsous la forme d'une partie de message de typetool-<name>, avec un état (input-streaming,input-available,output-available,output-error) qui correspond aux vues de chargement, de résultat et d'erreur. L'AI SDK propose aussistreamUIpour les React Server Components, que sa documentation présente comme expérimental.
Aujourd'hui, aucun adaptateur n'est disponible. Les composants VLLNT UI sont de simples composants React : vous pouvez déjà afficher les parties de message de l'AI SDK avec la famille IA (AIStreamingText, Reasoning, AIToolCallDisplay, AISourceCitation, ApprovalRequest et d'autres) dans votre propre code. Ensuite viendront un catalogue json-render, des schémas de props zod pour chaque composant, et des helpers qui relient les parties d'outil de l'AI SDK aux composants, avec leurs états de chargement et d'erreur : vllnt/ui#672.
Principes
VLLNT UI repose sur des principes simples qui guident chaque décision de conception et chaque choix d'implémentation. Tous les composants suivent ces principes. Utiliser VLLNT UI, ce n'est pas seulement ajouter des composants : c'est adopter une philosophie de design propre, rapide et intentionnel.
Design minimaliste
Moins, mais mieux. Chaque composant vise la simplicité. Un bon design doit devenir invisible : il fonctionne sans attirer inutilement l'attention. Nos composants sont :
- Clairs et sans surcharge
- Centrés sur les fonctionnalités essentielles
- Sans décoration gratuite
- Intentionnels dans chaque détail
Dark mode d'abord
Le mode sombre n'est pas un ajout tardif : c'est la direction principale. Chaque composant est conçu pour les fonds sombres, avec une lisibilité et un confort visuel solides. Le mode clair existe, mais VLLNT UI brille surtout en sombre.
- Conçu pour les environnements peu lumineux
- Fatigue visuelle réduite
- Esthétique moderne
- Apparence professionnelle
Pas de style emoji
Nous gardons une approche professionnelle, basée sur le texte. Les emojis et les icônes décoratives restent rares, pour que les composants restent durables et universels.
- Communication textuelle
- Ton professionnel
- Compatibilité universelle
- Typographie propre
Excellence technique
Au-delà de l'apparence, VLLNT UI privilégie :
- Sûreté du typage : TypeScript pour la fiabilité
- Personnalisation : extension et modification faciles
- Standards modernes : construit sur les technologies web actuelles
Ce qui est disponible aujourd'hui
- Composants descriptibles. Chaque composant a un descripteur JSON à
/r/<name>.json, indexé dans/r/registry.json. Les agents peuvent aussi utiliser/llms.txt,/llms-full.txtet le serveur MCP à/mcp(search_components,get_component,list_categories). Chaque descripteur indique sa version et sa stabilité ; les définitions de props et les exemples d'usage n'existent encore que pour quelques composants. Voir Agents. - Tokens et thèmes sous forme de données. Une seule source de tokens génère les variables CSS, les thèmes produits (changés à l'exécution avec
data-theme), les tokens React Native et les bibliothèques Penpot. Voir Theming. - Briques prêtes pour le flux continu.
Skeletonpour les états de chargement ;AIStreamingText,Reasoning,ThinkingBlocketAgentActivitypour un contenu qui arrive par morceaux. Voir les composants IA. Les composants fonctionnent avec les React Server Components, et les composants client sont marqués"use client". - Mises à jour sûres. Versionnage sémantique, une version canary à chaque changement sur
main, des versions stables publiées uniquement depuis des tags relus, un taglatestqui ne recule jamais, et des notes de mise à niveau pour chaque version. Voir Changelog. - Contrôle d'accessibilité. Chaque story est testée avec axe selon le WCAG 2.0 à 2.2, niveaux A et AA, en thème clair et sombre. Toute violation fait échouer le build.
- Un socle commun à plusieurs moteurs de rendu.
@vllnt/ui(web) et@vllnt/ui-native(React Native) sont générés à partir des mêmes tokens et des mêmes contrats de composants ; le paquet natif les lit depuis@vllnt/ui-core. Chaque composant natif interactif partage une même primitive d'affordance pour ses états pressé, survolé, focus et désactivé. Voir Native.
Sur la feuille de route
Rien de ceci n'est encore disponible. Ce sont les prochaines étapes vers la vision.
- Fondations spatiales (proposées pour la 0.5.0) : tokens de profondeur, un seul contrat d'affordance pour le pointeur, le tactile et le regard, des tailles de cible qui s'adaptent à l'entrée (24 px au pointeur, 44 pt au tactile, 60 pt en spatial), et des tokens de mouvement. La proposition est une RFC ouverte : vllnt/ui#631.
- Moteurs de rendu spatiaux comme visionOS ou WebXR, construits sur le même socle.
Interfaces 3D, AR et holographiques
Chacun de ces chantiers est ouvert et suivi dans son propre ticket. Rien de ceci n'est encore disponible.
- Une couche de scène 3D : des adaptateurs React Three Fiber et WebXR, en dépendances peer facultatives et jamais dans le socle (vllnt/ui#678).
- Des tokens de profondeur et d'élévation, partagés par la 3D, le spatial et le verre superposé, issus de la RFC spatiale (vllnt/ui#631).
- La saisie spatiale : le geste et la voix, par-dessus le contrat pointeur, tactile et regard, chaque action restant accessible au clavier (vllnt/ui#680).
- Des composants holographiques : menus radiaux et orbitaux, anneau de données, panneau holographique et un modèle documenté de superposition du verre, construits sur les composants de verre et de HUD existants (vllnt/ui#679).
- L'accessibilité des interfaces spatiales et translucides : mouvement réduit, transparence réduite, contraste sur le verre et tailles de cible spatiales, en plus du WCAG 2.2 AA (vllnt/ui#681).
- Des schémas pour que les agents puissent les diffuser : des entrées de catalogue json-render et des schémas d'outils AI SDK pour ces composants (vllnt/ui#672).
Interfaces pensées pour la voix
- Des composants vocaux : une surface conversationnelle, une transcription en direct, un indicateur d'écoute, le push-to-talk, des formes d'onde et des indicateurs de niveau, et un retour vocal doublé d'un équivalent texte (vllnt/ui#683).
- Une UI diffusée en continu, pilotée par la voix, avec les fonctions de synthèse et de transcription vocales de l'AI SDK (certaines encore marquées expérimentales) et avec json-render (vllnt/ui#672).
Le verre par défaut
- Les tokens de verre et le passage par défaut : des tokens de flou, de teinte et d'opacité, le verre comme thème par défaut, des replis opaques automatiques, des tests de contraste sur le verre et un budget de performance pour
backdrop-filter(vllnt/ui#684). - Un schéma de props complet pour chaque composant, pour qu'un modèle produise un arbre d'UI valide et qu'un moteur de rendu le vérifie avant de l'afficher.
- Un contrat de props partielles, pour que tout composant puisse s'afficher à partir de données incomplètes, reçues en flux continu.
- Des thèmes par utilisateur résolus à l'exécution, dans les limites accessibles des tokens.
- Des codemods et une période de dépréciation écrite, pour que les mises à jour puissent s'appliquer automatiquement.
- Des contrôles d'accessibilité sur les arbres d'UI générés, exécutés avant d'afficher un écran généré.
- Un catalogue json-render et des helpers AI SDK pour VLLNT UI (vllnt/ui#672).