The library for web and native user interfaces

Learn React

API Reference

React lets you build user interfaces out of individual pieces called components. Create your own React components like Thumbnail, LikeButton, and Video. Then combine them into entire screens, pages, and apps.

function Video({video}){
  return(
    <div>
      <Thumbnail video={video}/>
      <a href={video.url}>
        <h3>{video.title}</h3>
        <p>{video.description}</p>
      </a>
      <LikeButton video={video}/>
    </div>
  );
}

Whether you work on your own or with thousands of other developers, using React feels the same. It is designed to let you seamlessly combine components written by independent people, teams, and organizations.

React components are JavaScript functions. Want to show some content conditionally? Use an if statement. Displaying a list? Try array.map(). Learning React is learning programming.

function VideoList({videos,emptyHeading}){
  const count = videos.length;
  let heading = emptyHeading;

  if (count > 0) {
    const noun = count > 1 ? 'Videos' : 'Video';
    heading = count + ' ' + noun;
  }

  return (
    <section>
      <h2>{heading}</h2>
      {videos.map(video =>
        <Video key={video.id} video={video}/>
      )}
    </section>
  );
}

This markup syntax is called JSX. It is a JavaScript syntax extension popularized by React. Putting JSX markup close to related rendering logic makes React components easy to create, maintain, and delete.

React components receive data and return what should appear on the screen. You can pass them new data in response to an interaction, like when the user types into an input. React will then update the screen to match the new data.

import { useState } from 'react';

function SearchableVideoList({ videos }) {
  const [searchText, setSearchText] = useState('');
  const foundVideos = filterVideos(videos, searchText);

  return (
    <>
      <SearchInput
        value={searchText}
        onChange={newText => setSearchText(newText)}
      />
      <VideoList
        videos={foundVideos}
        emptyHeading={`No matches for “${searchText}”`}
      />
    </>
  );
}

example.com/videos.html

A brief history of React

React: The Documentary
The origin story of React

Rethinking Best Practices
Pete Hunt (2013)

Introducing React Native
Tom Occhino (2015)

Introducing React Hooks
Sophie Alpert and Dan Abramov (2018)

Introducing Server Components
Dan Abramov and Lauren Tan (2020)

Add React to your existing HTML page, and render interactive React components anywhere on it.

React is a library. It lets you put components together, but it doesn’t prescribe how to do routing and data fetching. To build an entire app with React, we recommend a full-stack React framework like Next.js or Remix.

example.com/confs/[slug].js

import { db } from './database.js';
import { Suspense } from 'react';

async function ConferencePage({ slug }) {
  const conf = await db.Confs.find({ slug });
  return (
    <ConferenceLayout conf={conf}>
      <Suspense fallback={<TalksLoading />}>
        <Talks confId={conf.id} />
      </Suspense>
    </ConferenceLayout>
  );
}

async function Talks({ confId }) {
  const talks = await db.Talks.findAll({ confId });
  const videos = talks.map(talk => talk.video);
  return <SearchableVideoList videos={videos} />;
}

example.com/confs/react-conf-2021

React Conf
React 18 Keynote
The React Team

React Conf
React 18 for App Developers
Shruti Kapoor

React Conf
Streaming Server Rendering with Suspense
Shaundai Person

React Conf
The First React Working Group
Aakansha Doshi

React Conf
React Developer Tooling
Brian Vaughn

React Conf
React without memo
Xuan Huang (黄玄)

React Conf
React Docs Keynote
Rachel Nabors

React Conf
Things I Learnt from the New React Docs
Debbie O'Brien

React Conf
Learning in the Browser
Sarah Rainsberger

React Conf
The ROI of Designing with React
Linton Ye

React Conf
Interactive Playgrounds with React
Delba de Oliveira

React Conf
Re-introducing Relay
Robert Balicki

React Conf
React Native Desktop
Eric Rozell and Steven Moyes

React Conf
On-device Machine Learning for React Native
Roman Rädle

React Conf
React 18 for External Store Libraries
Daishi Kato

React Conf
Building Accessible Components with React 18
Diego Haz

React Conf
Accessible Japanese Form Components with React
Tafu Nakazaki

React Conf
UI Tools for Artists
Lyle Troxell

React Conf
Hydrogen + React 18
Helen Lin

Frameworks that implement it let you fetch data in asynchronous components that run on the server or even during the build. Read data from a file or a database, and pass it down to your interactive components.

People love web and native apps for different reasons. React lets you build both web apps and native apps using the same skills. It leans upon each platform’s unique strengths to let your interfaces feel just right on every platform.

People expect web app pages to load fast. On the server, React lets you start streaming HTML while you’re still fetching data, progressively filling in the remaining content before any JavaScript code loads. On the client, React can use standard web APIs to keep your UI responsive even in the middle of rendering.

3:26 PM

People expect native apps to look and feel like their platform.React Native and Expo let you build apps in React for Android, iOS, and more. They look and feel native because their UIs are truly native. It’s not a web view—your React components render real Android and iOS views provided by the platform.

With React, you can be a web and a native developer. Your team can ship to many platforms without sacrificing the user experience. Your organization can bridge the platform silos, and form teams that own entire features end-to-end.

React approaches changes with care. Every React commit is tested on business-critical surfaces with over a billion users. Over 100,000 React components at Meta help validate every migration strategy.

The React team is always researching how to improve React. Some research takes years to pay off. React has a high bar for taking a research idea into production. Only proven approaches become a part of React.

React 19
December 05, 2024

React Compiler Beta Release and Roadmap
October 21, 2024

React Conf 2024 Recap
May 22, 2024

React 19 RC
April 25, 2024

You’re not alone. Two million developers from all over the world visit the React docs every month. React is something that people and teams can agree on.

This is why React is more than a library, an architecture, or even an ecosystem. React is a community. It’s a place where you can ask for help, find opportunities, and meet new friends. You will meet both developers and designers, beginners and experts, researchers and artists, teachers and students. Our backgrounds may be very different, but React lets us all create user interfaces together.

Copyright © Meta Platforms, Inc
no uwu plzuwu? Logo by @sawaratsuki1004