Skip to main content


👻 Primitive and flexible state management for React
Go to Latest
---title: Introductiondescription: Table of contentsnav: 0---
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, Gatsby, Remix, Waku, 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.
<TOC section="core" />## 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.
<TOC section="utilities" />## Extensions
Jotai has separate bundles for many official extensions including `atomWithQuery` for React Query and `atomWithMachine` for XState, among many others.
<TOC section="extensions" />## Tools
There are also SWC and Babel compiler plugins for React Fast Refresh support and debugging labels. This creates the best developer experience when using Jotai with a React framework such as Next.js or Gatsby.
<TOC section="tools" />## Basics
Learn the basic concepts and primitives of the library, discover how it compares with other solutions, and see examples of it in use.
<TOC section="basics" />## Guides
These guides can help with use common cases such as TypeScript, React frameworks, and basic patterns.
<TOC section="guides" />## Recipes
These recipes can help with more advanced patterns.
<TOC section="recipes" />