Errors

Find an error number below to see its cause and the steps that resolve it.

Haven’t called createTamagui yet.

This often happens due to having duplicate Tamagui sub-dependencies.

Tamagui needs every @tamagui/* dependency to be on the exact same version. Starter kits include an upgrade script you can run with yarn upgrade:tamagui to align package versions.

You can also remove node_modules and run a fresh install after upgrading.

Using global config fallback. This may indicate duplicate tamagui instances (e.g., from Vite SSR bundling). This is handled automatically, but may cause issues due to duplicate tamagui modules if ignored.

Static evaluation failed

The compiler evaluates your Tamagui config and configured component modules in Node during the build. The error names the module that could not be evaluated, the importing file, and the original failure. Fix that failure so the compiler can read the same config and component metadata as the application.

If the module is only used at runtime and none of its exports create your Tamagui config or components, ignore that module explicitly in tamagui.build.ts:

export default {
  components: ['tamagui'],
  dangerouslyIgnoreStaticEvaluationModules: ['runtime-only-package'],
}
Copy

Ignored modules receive an empty object during static evaluation. Do not ignore a module whose exports contribute to createTamagui() or a configured component.

Flat value clause condition depth exceeded

A flat value clause supports at most 5 non-platform conditions (e.g. hover:sm:focus:dark:). Reduce the number of chained modifiers on a single clause.

Invalid variable name

createCSSVariable expected a string variable name.

Missing component in styled()

styled() was called without a target component. Pass a valid React component or host element tag.

createTamagui in zero-runtime graph

createTamagui was invoked in a zero-runtime graph. In zero-runtime mode, config parsing and CSS generation happen at build time. Remove client config references or mark the module as full-runtime.

Reserved token name collision

A token name collides with a reserved CSS-wide keyword (initial, inherit, unset, etc.). Rename the token to avoid collision with standard CSS identifiers.

Missing default font

settings.defaultFont points to a font family that was not defined in the fonts configuration.

createComponent in zero-runtime graph

A Tamagui component renderer survived compilation in a zero-runtime bundle. Move the component to a declared full-runtime island or ensure static compilation extracts it.

Missing animation driver

No animation driver was configured. Pass an animations driver to createTamagui().

Missing animated-number hooks in driver

The configured animation driver does not support animated numbers. For CSS animations, use @tamagui/animations-css/extras.

Invalid matchMedia implementation

matchMedia did not return a valid MediaQueryList object. Supply a compatible matchMedia polyfill on native platforms.

Missing parent theme for shallow render

<Theme shallow> requires a mounted parent <Theme> component to derive its scoped theme hierarchy.

You’re rendering a Tamagui component without nesting it inside a parent that is able to adapt.

Adapt must be a child of a Dialog, Popover or Select. If that parent uses a scope prop, the Adapt needs the matching adapt scope. See Adapt.