tamagui-best-practices

Standardizes Tamagui v4 configs, compiler optimization, and compound-component patterns for teams.

Updated Jan 28, 2026

Search Tags:#theming #patterns #compound-components #tamagui #config-v4 #compiler-optimization

Ready to run

npx skills add https://github.com/apostolos-geyer/StoliStack --skill tamagui-best-practices-apostolos-geyer

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: tamagui-best-practices
Source: https://github.com/apostolos-geyer/StoliStack/tree/main/.agents/skills/tamagui-best-practices
Command: npx skills add https://github.com/apostolos-geyer/StoliStack --skill tamagui-best-practices-apostolos-geyer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Patterns for Tamagui v1.x that go beyond fundamentals, focusing on Config v4, compiler optimization, compound components, and common mistakes.

Core Features & Use Cases

Config v4 setup, createThemes, and design-token usage across apps.
Compiler optimization patterns to improve build-time and runtime performance.
Compound component patterns with documented best practices for scalable UI.

Quick Start

Use this quick start to initialize a Tamagui v4 config with default settings and extend the Tamagui types for your project.

Frequently Asked Questions about tamagui-best-practices

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I configure Tamagui v4 for a scalable project?▼

Configuring Tamagui v4 involves using defaultConfig and createTamagui to initialize your setup, while type augmentation extends project types for consistent design tokens across your application.

What is the best way to optimize the Tamagui compiler for better performance?▼

Tamagui compiler optimization relies on applying specific compile-time patterns to reduce build-time overhead and improve runtime performance across your v4 project components.

How do compound components work in Tamagui?▼

Compound components in Tamagui work by utilizing a shared context to manage state and props across related UI elements, ensuring a scalable and consistent component architecture.

Does this Tamagui setup support consistent theming across multiple apps?▼

Yes, the setup supports consistent theming across multiple applications by using createThemes to define design tokens and standardize configurations throughout your v4 project.

Why do I need type augmentation when setting up Tamagui config v4?▼

You need type augmentation during Tamagui config v4 setup to extend base types with your custom design tokens, ensuring type safety across your compound components and themes.