Dernière version de Tamagui février 2026 : actualités de la version v2.0.0

Où suivre les versions

Toutes les versions et tous les changelogs sont publiés sur GitHub : github.com/tamagui/tamagui/releases. Début février 2026, le dernier tag est v2.0.0-rc.5 (6 février). Vous pouvez installer la dernière RC via npm ou votre gestionnaire de paquets (par exemple npm install [email protected]). La ligne v1 reste prise en charge - la dernière version stable v1 est v1.144.3 (20 janvier 2026).

Calendrier de la version v2.0.0

v2.0.0 apporte une mise à niveau majeure avec une meilleure prise en charge multiplateforme, de nouveaux paquets et de nombreuses corrections. La version a commencé avec v2.0.0-rc.0 (29 janvier 2026) et a été affinée à travers plusieurs release candidates :

• v2.0.0-rc.0 - RC initiale de v2 : backgroundImage/textShadow multiplateformes, @tamagui/element, améliorations de Strong/Em/Span, de build et de thème, mises à jour du menu natif et du flux d'achat.
• v2.0.0-rc.1 - Grand ensemble de corrections de bugs : extraction du CLI et détection de plateforme (.ios.tsx), cache du compilateur et chargement de tamagui.build.ts, corrections de sheet/portal/dialog, améliorations des gestures et des inputs, migration vers Bun, docs et guide de mise à niveau v1→v2.
• v2.0.0-rc.2 - Syntaxe raccourcie des border pour le natif et le web, corrections des media queries en kebab-case, ajustements de tooltip et de switch theme, corrections de line-height.
• v2.0.0-rc.4 - Menu natif (setup-zeego), correction du transfert de défilement de sheet, corrections des sélecteurs group hover/kebab-case, correction d'un crash hitSlop sur le natif.
• v2.0.0-rc.5 - Analyse web de boxShadow/backgroundImage/textShadow au format objet RN (y compris DynamicColorIOS), toast utilisant @tamagui/native/setup-burnt, correction de l'état des paquets dupliqués sur le natif, valeurs par défaut de create-menu (allowFlip, stayInFrame), documentation du plugin du compilateur.

v2.0.0 en bref

v2 renforce le principe écrire une fois, exécuter partout : la même API de style fonctionne sur le web et sur React Native avec une meilleure parité et moins de contournements spécifiques à la plateforme. Les nouveaux paquets et le comportement du compilateur facilitent la livraison d'applications de production avec du code partagé et des refs/types corrects sur les deux plateformes.

Points forts notables de v2.0.0

• Web et natif : backgroundImage multiplateforme (dégradés et jetons), textShadow et événements de pointeur.
• Nouveau package : @tamagui/element pour les refs spécifiques à la plateforme (useWebRef, useNativeRef).
• Texte : nouveaux composants inline Strong, Em et Span.
• Build : option --swap-exports pour publier avec les types src ; améliorations du chargement du compilateur et du chargement statique (par exemple le chargement automatique de tamagui.build.ts).
• Themes et config : variables de thème générées automatiquement en CSS, nouveaux ombrages, couleurs de surbrillance et prise en charge unstyled pour supprimer les thèmes des composants.
• Natif : prise en charge du menu natif via @tamagui/native/setup-zeego, toast via setup-burnt, amélioration du handoff de défilement de sheet et de la gestion des gestures (y compris les gestures de pan sur Android), ainsi que des corrections pour hitSlop et l'état des paquets dupliqués.

L'API unstyled vous permet de retirer le thème par défaut d'un composant pour pouvoir le styliser depuis zéro tout en conservant la disposition et le comportement de Tamagui. Les pointer events fonctionnent de manière cohérente sur le web et le natif pour le hover, le press et le focus. Le composant Popper (par exemple pour les tooltips et popovers) prend maintenant en charge animatePosition (renommé depuis enableAnimationForPositionChange) et Arrow peut aussi animer les changements de position.

Ligne v1 : toujours maintenue

Si vous n'êtes pas prêt à passer à v2, la branche v1 est toujours activement maintenue. v1.144.3 (20 janvier 2026) inclut des corrections pour les couleurs iOS dynamiques dans les styles de thème, le comportement de glissement de sheet (distance minimale de glissement), l'alignement de la dépendance peer next-theme et l'héritage des styles Text imbriqués sur le web. Les versions antérieures v1.144.x ont corrigé la sortie du compilateur, des régressions sur les inputs et des avertissements de baseline-browser-mapping. Restez sur v1 et surveillez la page des versions pour les backports et les mises à jour de sécurité.

Passer de v1 à v2

Les mainteneurs ont ajouté un guide de migration de v1 vers v2 dans le dépôt et la documentation. Les points clés à prévoir : le chargement automatique de tamagui.build.ts et la configuration du plugin du compilateur, le nommage des media queries (kebab-case v5), les refs et types (en utilisant @tamagui/element si nécessaire), ainsi que l'usage de sheet, portal ou dialog (le comportement et le z-index ont été affinés). Les docs standardisent aussi le plugin du compilateur et les consignes defaultTheme pour l'installation. Suivez le guide de migration et les notes de version de chaque RC que vous adoptez pour éviter les surprises.

Écosystème et documentation

Au-delà de la bibliothèque principale, l'écosystème Tamagui comprend Tamagui Takeout (pile prête pour la production avec Supabase, tRPC, auth et formulaires universels), le Studio (export de thèmes et outils) et des offres Pro avec des composants et un support supplémentaires. Le site et la documentation ont été mis à jour pour v2 : flux de checkout et de tarification, OAuth et gestion des sessions, améliorations du theme builder et tarification par géolocalisation. Pour les dernières instructions d'installation, les étapes de migration et les consignes de design system, utilisez la documentation officielle de Tamagui et les versions GitHub comme source de vérité.

En résumé

Février 2026 est un mois chargé pour Tamagui : v2.0.0 est en phase de release candidate avec déjà cinq RC publiées, apportant une meilleure parité multiplateforme, de nouveaux paquets, des améliorations du compilateur et du build, ainsi qu'un chemin clair depuis v1. Suivez la page des versions et le guide de migration v1→v2 quand vous serez prêt à essayer ou adopter v2 ; si vous restez sur v1, gardez un œil sur v1.144.x pour les corrections et les mises à jour de compatibilité.