Want to quickly get started building your own project with Prismic and Next.js? This project includes basic configurations and nothing else. The project includes one Rich Text Slice, a homepage, and a dynamic page.
- Demo: Open live demo
- Learn more about Prismic and Next.js: Prismic Next.js Documentation
To start a new project using this starter, run the following commands in your terminal:
npx degit prismicio-community/nextjs-starter-prismic-minimal your-project-name
cd your-project-name
npx @slicemachine/init@latest
The commands will do the following:
- Start a new Next.js project using this starter.
- Ask you to log in to Prismic or create an account.
- Create a new Prismic content repository with sample content.
When you're ready to start your project, run the following command:
npm run dev
To edit the content of this project, go to prismic.io/dashboard, click on the repository for this website, and start editing.
To create a page, click on the green pencil icon, then select Page.
Pages are made of Slices. You can add and rearrange Slices to your pages.
Your new page will be accessible by its URL, but it won't appear on the website automatically. To let users discover it, add it to the navigation.
If you chose this starter when you created a new repository from the Prismic Dashboard, then your repository is preconfigured with previews on localhost. To change the preview configuration or add previews to your production or staging environments, see Preview Drafts in Next.js in the Prismic documentation.
This website is preconfigured with Prismic. It has three Prismic packages installed:
@prismicio/client
provides helpers for fetching content from Prismic@prismicio/react
provides React components for rendering content from Prismic@prismicio/next
provides a wrapper component to configure Prismic previews
These packages are already integrated and employed in this app. Take a look at the code to see how they're used.
There are two steps to rendering content from Prismic in your Next.js project:
- Fetch content from the Prismic API using
@prismicio/client
. - Template the content using components from
@prismicio/react
.
Here are some of the files in your project that you can edit:
prismicio.js
- This file includes configuration for@prismicio/client
and exports useful API helpers.app/layout.js
- This is your layout component, which includes configuration for@prismicio/react
and@prismicio/next
.app/page.js
- This is the app homepage. It queries and renders a page document with the UID (unique identifier) "home" from the Prismic API.app/[uid]/page.js
- This is the page component, which queries and renders a page document from your Prismic repository based on the UID.slices/*/index.js
- Each Slice in your project has an index.js file that renders the Slice component. Edit this file to customize your Slices.
These are important files that you should leave as-is:
app/api/exit-preview/route.js
- Do not edit or delete this file. This is the API endpoint to close a Prismic preview session.app/api/preview/route.js
- Do not edit or delete this file. This is the API endpoint to launch a Prismic preview session.app/slice-simulator/page.js
- Do not edit or delete this file. This file simulates your Slice components in development.slices/
- This directory contains Slice components, which are generated programmatically by Slice Machine. To customize a Slice template, you can edit the Slice's index.js file. To add Slices, delete Slices, or edit Slice models, use Slice Machine (more info below).
Learn more about how to edit your components with Fetch Data in Next.js and Template Content in Next.js.
To put your project online, see Deploy your Next.js App.
This project includes an application called Slice Machine, which generates models for your Custom Types and Slices. Slice Machine stores the models locally in your codebase, so you can save and version them. It also syncs your models to Prismic. To learn how to use Slice Machine, read Model Content in Next.js.
If you change or add to your Custom Types, you'll need to update your route handling to match. To learn how to do that, read Define Paths in Next.js.
For the official Prismic documentation, see Prismic's guide for Next.js or the technical references for the installed Prismic packages.
Copyright 2013-2022 Prismic <[email protected]> (https://prismic.io)
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.