Blog Releases Introduction

Getting Started

Installation Usages Concepts Using Mutative with React Performance

Advanced Guides

Auto Freeze Currying Marking data structure Patches Strict Mode TypeScript Pitfalls Performance tips Migration from Immer to Mutative Migration from Mutative v1 to v2

create()apply()makeCreator()current()original()rawReturn()unsafe()isDraftable()isDraft()markSimpleObject()Type casts

Comparison with Immer FAQ Contributing Mutative Ecosystem Who Uses Mutative Shared References Production error codes

Getting Started

5 minutes to learn the most important Mutative concepts.

Installation

Install Mutative from npm or load it from a CDN, and check the environments it supports.

Usages

Common immutable updates of objects, arrays, Maps and Sets with create().

Concepts

Drafts, finalization with structural sharing, patches and marks, the ideas behind Mutative.

Using Mutative with React

Update React state with create(), or with the use-mutative hooks.

Performance

Benchmark results against Immer and hand-written reducers across 97 workloads, and how to run the benchmarks.

Last updated on October 8, 2026 by Michael Lin

Introduction

Mutative is a JavaScript library for efficient immutable updates. Change a draft with ordinary JavaScript, and get the next immutable state.

Installation

Install Mutative from npm or load it from a CDN, and check the environments it supports.