Skip to content
Get packs

Recoil

A React state management library from Meta, now archived and no longer actively maintained.

GitHub Download 0.7.7
Stars
19.4k
Forks
1.2k
Licence
MIT
Language
JavaScript
Last update
1.8 years ago
Type
Library

This repository is archived and no longer maintained.

What it is

Recoil is a state management library for React apps, meaning it helps share and update data across components. The README describes it as providing capabilities that are hard to get with React alone while staying compatible with newer React features. The repository is archived, with its last push on 2025-01-01, so it receives no active development.

  • Share a piece of application state between several distant React components
  • Install the npm package recoil into an existing React project
  • Follow the official docs at recoiljs.org to learn the core concepts

Great for

  • React developers who want shared state beyond simple prop passing
  • Developers maintaining an existing app that already uses Recoil
  • People evaluating state libraries who want to read a working reference implementation

Not ideal for

  • New projects, because the repository is archived and no longer maintained (choose an actively maintained alternative)
  • Non-React projects, since the README only describes it as a library for React
  • Beginners with no React experience, because the README gives no beginner guidance

How to get it

  1. 1

    Install with a package manager

    You'll need: Node.js and npm or yarn · A React project

    Install with npm

    npm install recoil

    Install with yarn

    yarn add recoil
  2. 2

    Run it

    • Install the recoil package into a React project with npm install recoil
    • Wrap your app in RecoilRoot as described in the API reference
    • Create shared state and read it from components using the documented core concepts
  3. 3

    Get the most out of it

    • Read the core concepts guide at recoiljs.org/docs/introduction/core-concepts
    • Use the API reference for RecoilRoot and related hooks at recoiljs.org
    • Check the tutorials page at recoiljs.org/resources for worked examples

Downloads

Source code (.zip)main branch · straight from GitHubRelease 0.7.7Release notes and sourceOfficial website & docsrecoiljs.org/

Strengths

  • Built for React and described as compatible with its newer features
  • Published under the permissive MIT license
  • Widely starred open-source project with official documentation and tutorials

Trade-offs

  • Archived repository with no development since its last push on 2025-01-01
  • The README itself calls the project experimental
  • The README is truncated and gives little detail on the API, so you must rely on the external docs

How it compares

ProjectStarsTypeLevelUpdatedBest for
Recoil (this)19.4kLibraryintermediate1.8 years agoReact developers who want shared state beyond simple prop passing
redux61.4kLibraryintermediate16 days agoDevelopers building larger front-end apps where many components share the same data
zustand58.9kLibrarybeginner15 days agoReact developers who want simpler shared state than Redux
jotai21.3kLibrarybeginner14 days agoReact developers who want simple shared state without heavy setup

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.