Pantheon Content Cloud Next.js Starter

Getting Started

To get started with the Next Pantheon Content Cloud Starter, use our pcc (command-line interface tool we have created). Full documentation for this npm package based on npm init can be found here on our docs site.

Deploy your own

For a quick start on your local machine, follow the instructions below:

1. In your terminal, run the following commands:

npm install @pantheon-systems/pcc-cli --global
pcc init ./my-new-site --template=nextjs

2. Follow the prompts in your terminal to complete the setup.

Pantheon's @pantheon-systems/pcc-react-sdk

Pantheon's @pantheon-systems/pcc-react-sdk is included as a dependency in this project.

Tests

Tests are written with vitest. All new functionality should have unit tests or snapshot tests where applicable. Snapshot tests are using @testing-library/react.

Commands

This section assumes the package manager in use is npm. If you are not using npm, replace npm with the name of your package manager.

To run the tests:

npm test

To run the tests in watch mode:

npm run test:watch

Updating Snapshots

Snapshots should be updated when presentational changes are made. If a new page route is added, create a new snapshot test for it, and include any data needed to run that test successfully. Please commit the updated snapshots along with your changes.

To update a snapshot:

Run the following helper command:

npm run update-snapshots

Or, run the test for a single profile in watch mode (see above), then in the terminal press the u key. This will update the snapshot for the running profile Be sure to update the snapshot for both profiles.