Where to Follow Releases
All versions and changelogs are published on GitHub: github.com/tamagui/tamagui/releases. As of early February 2026, the latest
tag is v2.0.0-rc.5 (Feb 6). You can install the latest RC via npm or your package manager (e.g.
npm install [email protected]).
The v1 line remains supported—the latest stable v1 release is v1.144.3 (Jan 20, 2026).
v2.0.0 Release Timeline
v2.0.0 brings a major upgrade with better cross-platform support, new packages, and many fixes. The release started with v2.0.0-rc.0 (Jan 29, 2026) and has been refined through several release candidates:
- v2.0.0-rc.0 — Initial v2 RC: cross-platform backgroundImage/textShadow, @tamagui/element, Strong/Em/Span, build and theme improvements, native menu and purchase flow updates.
- v2.0.0-rc.1 — Large set of bug fixes: CLI extraction and platform detection (.ios.tsx), compiler cache and tamagui.build.ts loading, sheet/portal/dialog fixes, gesture and input improvements, migration to Bun, docs and v1→v2 upgrade guide.
- v2.0.0-rc.2 — Border shorthand for native and web, kebab-case media query fixes, tooltip and switch theme tweaks, line-height adjustments.
- v2.0.0-rc.4 — Native menu (setup-zeego), sheet scroll handoff fix, group hover/kebab-case selector fixes, hitSlop crash fix on native.
- v2.0.0-rc.5 — Web parsing of boxShadow/backgroundImage/textShadow to RN object format (including DynamicColorIOS), toast using @tamagui/native/setup-burnt, native duplicate package state fix, create-menu defaults (allowFlip, stayInFrame), compiler plugin docs.
v2.0.0 in a Nutshell
v2 doubles down on write-once, run-everywhere: the same style API works on web and React Native with better parity and fewer platform-specific workarounds. New packages and compiler behavior make it easier to ship production apps with shared code and proper refs/types on both platforms.
Notable v2.0.0 Highlights
- Web & native: Cross-platform
backgroundImage(gradients and tokens),textShadow, and pointer events. - New package:
@tamagui/elementfor platform-specific refs (useWebRef,useNativeRef). - Text: New inline components
Strong,Em, andSpan. - Build:
--swap-exportsflag for publishing with src types; compiler and static loading improvements (e.g.tamagui.build.tsauto-loading). - Themes & config: Auto-generated theme vars in CSS, new shadows, highlight colors, and unstyled support to remove component themes.
- Native: Native menu support via
@tamagui/native/setup-zeego, toast viasetup-burnt, improved sheet scroll handoff and gesture handling (including Android pan gestures), and fixes for hitSlop and duplicate package state.
The unstyled API lets you strip a component's default theme so you can style it from scratch
while keeping Tamagui's layout and behavior. Pointer events work consistently across web and
native for hover, press, and focus. The Popper component (e.g. for tooltips and popovers) now
supports animatePosition (renamed
from
enableAnimationForPositionChange) and Arrow can animate position changes as well.
v1 Line: Still Maintained
If you're not ready to move to v2, the v1 branch is still actively maintained. v1.144.3 (Jan 20, 2026) includes fixes for dynamic iOS colors in theme styles, sheet drag behavior (minimum drag distance), next-theme peer dependency alignment, and nested Text style inheritance on web. Earlier v1.144.x releases addressed compiler output, input regressions, and baseline-browser-mapping warnings. Stay on v1 and watch the releases page for backports and security updates.
Upgrading from v1 to v2
The maintainers have added a v1 to v2 upgrade guide in the repository and documentation. Key
areas to plan for: the new tamagui.build.ts
auto-loading
and compiler plugin setup, media query naming (v5 kebab-case), refs and types (using @tamagui/element where
needed), and any usage of sheet, portal, or dialog (behavior and z-index have been refined). The docs also
standardize around the compiler plugin and defaultTheme guidance for
installation. Run through the upgrade guide and the release notes for each RC you land on to avoid surprises.
Ecosystem and Docs
Beyond the core library, the Tamagui ecosystem includes Tamagui Takeout (production-ready stack with Supabase, tRPC, auth, and universal forms), the Studio (theme export and tooling), and Pro offerings with additional components and support. The website and docs have been updated for v2: checkout and pricing flows, OAuth and session handling, theme builder improvements, and parity pricing with geo detection. For the latest install instructions, migration steps, and design-system guidance, use the official Tamagui documentation and the GitHub releases as the source of truth.
Bottom Line
February 2026 is a busy month for Tamagui: v2.0.0 is in release-candidate phase with five RCs already out, bringing better cross-platform parity, new packages, compiler and build improvements, and a clear path from v1. Follow the releases page and the v1→v2 upgrade guide when you're ready to try or adopt v2; if you stay on v1, keep an eye on v1.144.x for fixes and compatibility updates.