Documentation

Welcome to the Jotai v2 documentation! Jotai's atomic approach to global React state management scales from a simple useState replacement to an enterprise application with complex requirements.

Features

• Minimal core API (2kb)
• Many utilities and extensions
• TypeScript oriented
• Works with Next.js, Waku, Remix, and React Native

Core

Jotai has a very minimal API, exposing only a few exports from the main jotai bundle. They are split into four categories below.

Utilities

Jotai also includes a jotai/utils bundle with a variety of extra utility functions. One example is atomWithStorage, which includes localStorage persistence and cross browser tab synchronization.

Extensions

Jotai has many officially maintained extensions including atomWithQuery for React Query and atomWithMachine for XState, among many others.

Third-party

Beyond the official extensions, there are many third-party community packages as well.

Tools

Use SWC and Babel compiler plugins for React Fast Refresh support and debugging labels. This creates the best developer experience when using a React framework such as Next.js or Waku.

Basics

Learn the basic concepts of the library, discover how it compares with others, and see usage examples.

Guides

Guides can help with use common cases such as TypeScript, React frameworks, and basic patterns.

Recipes

Recipes can help with more advanced patterns.