Example Projects

This article will walk you through the best way to using Prismic with React.js applications. The example projects provide a collection of pre-built sample content, Custom Types, source code, and more. It will guide you on how to build an application and explore various features and capabilities of Prismic.


Install the Prismic CLI

The first thing is to install the Prismic CLI (command line interface) if you haven't already. Launch the terminal (command prompt or similar on Windows) and run the following command.

  • npm
  • Yarn
Copy
npm install -g prismic-cli
Copy
yarn install -g prismic-cli

Sometimes it's possible that the above command doesn't work because of permission levels on your machine.

If that's the case for you, run the following the sudo command:

  • npm
  • Yarn
Copy
sudo npm install -g prismic-cli
Copy
sudo yarn global add prismic-cli

⚠️ Prismic CLI version

Make sure you're using the latest version of Prismic CLI. You can check your version by running prismic --version command in your terminal.


Choose a project

You can choose any of the available sample projects. You can also see a preview of the project to check how the application works.

Prismic theme command

To install a sample project, run the theme command. The theme command clones the project locally, installs all necessary dependencies and creates a Prismic repository with Custom Types and pre-built content. It will ask you to give the name of your Prismic repository and the local folder to initialize your project.

Blog website

This blog website is an excellent starting point to explore React.js and Prismic. Modify and adapt it to your liking.

Run the following Prismic theme command in the terminal to launch this project locally:

Copy
prismic theme --theme-url https://github.com/prismicio/reactjs-blog --conf src/prismic-configuration.js

Business website

A Business website with multiple pages and a dynamic menu. This project provides all the code you need for a website with a homepage, information pages, and navigation

Run the following Prismic theme command in the terminal to launch this project locally:

Copy
prismic theme --theme-url https://github.com/prismicio/reactjs-website --conf src/prismic-configuration.js

Verify repository name

Open  prismic-configuration.js file and verify the Prismic repo matches the URL of the Prismic repository created earlier in this article. To find this, go to your Prismic dashboard, then to your repository.

If the URL for your repository is https://my-awesome-repository.prismic.io, then you'll need to replace your-repo-name with my-awesome-repository


Run the website in development mode

Now, open your project folder in the terminal by cd name-of-your-project and run the following command to launch a local development server at http://localhost:3000.

Copy
npm start

Now you can customize the code and content however you want, and deploy your project when you're ready.


Related articles


Was this article helpful?
Not really
Yes, Thanks

Can't find what you're looking for? Get in touch with us on our Community Forum.