Get Started with React

This guide will teach you how to make a web app with React and Prismic.

If you’re looking for information on using Prismic with a React framework, see our Next.js or Gatsby documentation:

• Set up a Project with Prismic and Next.js

  Learn how to use Prismic with Next.js

• Set up a Project with Prismic and Gatsby

  Learn how to use Prismic with Gatsby

If you want to jump right in, proceed to the Install step:

• Install Prismic

  By the end of this page, you will have a React project set up with basic utilities from Prismic.

Curious about pricing? Prismic has an unlimited free tier for projects with one user. To learn more, see our pricing page:

• Prismic Pricing

  Find the right plan for any size of project.

What technical skills do I need?

If you’re a developer building a project with Prismic and React, we recommend that you already have a basic knowledge of JavaScript, CSS, React, and API querying.

If a developer is setting up Prismic for you, you won’t need any technical knowledge. Prismic is designed to be used by anyone.

Why should I use Prismic with React?

Every great website starts with content.

React is an amazing tool for building interactive web apps, and it has a fantastic ecosystem of add-ons to manage every part of your website. How should you manage your content in React? The most important part of your website (the reason you have a website) deserves a tool.

Prismic is the tool for your content. What’s more, Prismic is designed to integrate smoothly with React, with a logical content architecture that maps directly to React components.

Plus, Prismic adds some super-powers to your website, like image optimization, content versioning, scheduling, and user permissions.

Does Prismic have a React integration?

Yes, Prismic provides a React integration to fetch and display your content. This guide will teach you how to use Prismic’s React package.

If you would like to contribute or provide feedback for the integration, see the integration’s GitHub page for more details.

What package version does this guide use?

This guide uses @prismicio/react v2. If you have used Prismic with React previously, you may have used prismic-reactjs. For information on the differences between the two versions and how to upgrade from the old package to the new one, see the migration guide.

For information on how to use prismic-reactjs, see the README on npm.

Have questions or comments?

If you have ideas for how to improve this documentation, we’d love to hear from you on the Prismic Community Forum.

Five steps to get started

This guide will walk you through five steps to deploying your website and creating content.

Here’s what we’ll go over:

• 1. Install Prismic

  In this step, you'll add the Prismic integration to your React project. By the end of the page, you'll have a collection of Prismic utilities available in your project.

• 2. Fetch Data

  Next, you'll learn how to use your new Prismic utilities to retrieve data from your Prismic repo. By the end of this step, you will know how to query the Prismic API.

• 3. Template Content

  Once you have Prismic data in your project, you can display it on the page. By the end of this step, you will know how to template every type of content from the Prismic API.

• 4. Deploy an App

  In this step, you'll learn how to deploy your site with Netlify or Vercel. By the end of this step, you will have a live website online.

• 5. Preview Drafts

  With your site online, you'll need a way to preview draft changes and unpublished documents. By the end of this step, you will have one-click previewing set up.