diff --git a/source/content/guides/decoupled/drupal-backend-starters/01-introduction.md b/source/content/guides/decoupled/drupal-backend-starters/01-introduction.md index cc9fe2de57..3d6ebdf93b 100644 --- a/source/content/guides/decoupled/drupal-backend-starters/01-introduction.md +++ b/source/content/guides/decoupled/drupal-backend-starters/01-introduction.md @@ -16,6 +16,7 @@ audience: [development] product: [decoupled] integration: [--] --- + Front-End Sites on Pantheon allow you to use [decoupled architecture](/guides/decoupled/overview/#what-is-a-decoupled-site) to separate your frontend and backend into distinct entities. diff --git a/source/content/guides/decoupled/drupal-backend-starters/02-create.md b/source/content/guides/decoupled/drupal-backend-starters/02-create.md index 871f928aa7..fc8053c2dd 100644 --- a/source/content/guides/decoupled/drupal-backend-starters/02-create.md +++ b/source/content/guides/decoupled/drupal-backend-starters/02-create.md @@ -16,6 +16,8 @@ audience: [development] product: [decoupled] integration: [--] --- + + This section provides information on how to use the Drupal Backend Starter for Front-End Sites. diff --git a/source/content/guides/decoupled/drupal-backend-starters/03-caching.md b/source/content/guides/decoupled/drupal-backend-starters/03-caching.md index 30f4c39157..c9b9f8c823 100644 --- a/source/content/guides/decoupled/drupal-backend-starters/03-caching.md +++ b/source/content/guides/decoupled/drupal-backend-starters/03-caching.md @@ -16,6 +16,7 @@ audience: [development] product: [decoupled] integration: [--] --- + Cache settings are configured out-of-the-box for you, but there are circumstances in which you might need to make your own configurations, such as when your CMS is not on Pantheon but your frontend is on Pantheon. diff --git a/source/content/guides/decoupled/drupal-backend-starters/04-manage-settings.md b/source/content/guides/decoupled/drupal-backend-starters/04-manage-settings.md index 765fafc6d7..9f31c6bc6b 100644 --- a/source/content/guides/decoupled/drupal-backend-starters/04-manage-settings.md +++ b/source/content/guides/decoupled/drupal-backend-starters/04-manage-settings.md @@ -16,5 +16,6 @@ audience: [development] product: [decoupled] integration: [--] --- + \ No newline at end of file diff --git a/source/content/guides/decoupled/drupal-backend-starters/05-build-hooks.md b/source/content/guides/decoupled/drupal-backend-starters/05-build-hooks.md index 6e163dd884..4b07922fa4 100644 --- a/source/content/guides/decoupled/drupal-backend-starters/05-build-hooks.md +++ b/source/content/guides/decoupled/drupal-backend-starters/05-build-hooks.md @@ -16,6 +16,7 @@ audience: [development] product: [decoupled] integration: [--] --- + This section provides information on how to configure build hooks on your backend. diff --git a/source/content/guides/decoupled/drupal-nextjs-frontend-starters/01-introduction.md b/source/content/guides/decoupled/drupal-nextjs-frontend-starters/01-introduction.md index 73f9a2651d..dbc47c3c88 100644 --- a/source/content/guides/decoupled/drupal-nextjs-frontend-starters/01-introduction.md +++ b/source/content/guides/decoupled/drupal-nextjs-frontend-starters/01-introduction.md @@ -15,6 +15,7 @@ audience: [development] product: [decoupled] integration: [--] --- + Front-End Sites on Pantheon allow you to use [decoupled architecture](/guides/decoupled/overview/#what-is-a-decoupled-site) to separate your frontend and backend into distinct entities. diff --git a/source/content/guides/decoupled/drupal-nextjs-frontend-starters/02-create.md b/source/content/guides/decoupled/drupal-nextjs-frontend-starters/02-create.md index 1038256f9e..6f1974563c 100644 --- a/source/content/guides/decoupled/drupal-nextjs-frontend-starters/02-create.md +++ b/source/content/guides/decoupled/drupal-nextjs-frontend-starters/02-create.md @@ -15,6 +15,7 @@ audience: [development] product: [decoupled] integration: [--] --- + This section provides information on how to use the Drupal + Next.js frontend starter kit. diff --git a/source/content/guides/decoupled/drupal-nextjs-frontend-starters/03-build-details.md b/source/content/guides/decoupled/drupal-nextjs-frontend-starters/03-build-details.md index e36045bca9..989069e6df 100644 --- a/source/content/guides/decoupled/drupal-nextjs-frontend-starters/03-build-details.md +++ b/source/content/guides/decoupled/drupal-nextjs-frontend-starters/03-build-details.md @@ -16,5 +16,6 @@ audience: [development] product: [decoupled] integration: [--] --- + \ No newline at end of file diff --git a/source/content/guides/decoupled/drupal-nextjs-frontend-starters/03-caching.md b/source/content/guides/decoupled/drupal-nextjs-frontend-starters/03-caching.md index 3e29adb837..73918b897b 100644 --- a/source/content/guides/decoupled/drupal-nextjs-frontend-starters/03-caching.md +++ b/source/content/guides/decoupled/drupal-nextjs-frontend-starters/03-caching.md @@ -16,6 +16,7 @@ audience: [development] product: [decoupled] integration: [--] --- + Cache settings are configured out-of-the-box for you, but there are circumstances in which you might need to make your own configurations, such as when your CMS is not on Pantheon but your frontend is on Pantheon. diff --git a/source/content/guides/decoupled/drupal-nextjs-frontend-starters/04-manage-settings.md b/source/content/guides/decoupled/drupal-nextjs-frontend-starters/04-manage-settings.md index 55d69e990d..62ad4f2eaa 100644 --- a/source/content/guides/decoupled/drupal-nextjs-frontend-starters/04-manage-settings.md +++ b/source/content/guides/decoupled/drupal-nextjs-frontend-starters/04-manage-settings.md @@ -16,5 +16,6 @@ audience: [development] product: [decoupled] integration: [--] --- + \ No newline at end of file diff --git a/source/content/guides/decoupled/drupal-nextjs-frontend-starters/05-content-preview.md b/source/content/guides/decoupled/drupal-nextjs-frontend-starters/05-content-preview.md index 05090a0e6e..f9b993fde0 100644 --- a/source/content/guides/decoupled/drupal-nextjs-frontend-starters/05-content-preview.md +++ b/source/content/guides/decoupled/drupal-nextjs-frontend-starters/05-content-preview.md @@ -16,6 +16,7 @@ audience: [development] product: [decoupled] integration: [--] --- + This section provides information on how to configure decoupled content preview for your site. This allows you to preview your content changes in the Next.js app before publishing to your live site. diff --git a/source/content/guides/decoupled/drupal-nextjs-frontend-starters/06-robots-indexing.md b/source/content/guides/decoupled/drupal-nextjs-frontend-starters/06-robots-indexing.md index 39acd027b5..edaf95af29 100644 --- a/source/content/guides/decoupled/drupal-nextjs-frontend-starters/06-robots-indexing.md +++ b/source/content/guides/decoupled/drupal-nextjs-frontend-starters/06-robots-indexing.md @@ -16,6 +16,7 @@ audience: [development] product: [decoupled] integration: [--] --- + This section provides information on how to use a `robots.txt` file to manage indexing for Front-End Sites. diff --git a/source/content/guides/decoupled/no-starter-kit/01-introduction.md b/source/content/guides/decoupled/no-starter-kit/01-introduction.md index 3a80c2aad0..c536cc39c4 100644 --- a/source/content/guides/decoupled/no-starter-kit/01-introduction.md +++ b/source/content/guides/decoupled/no-starter-kit/01-introduction.md @@ -16,6 +16,7 @@ audience: [development] product: [decoupled] integration: [--] --- + Front-End Sites on Pantheon allow you to use [decoupled architecture](/guides/decoupled/overview/#what-is-a-decoupled-site) to separate your frontend and backend into distinct entities. diff --git a/source/content/guides/decoupled/no-starter-kit/02-create.md b/source/content/guides/decoupled/no-starter-kit/02-create.md index 21f078620d..afa8bbcb4d 100644 --- a/source/content/guides/decoupled/no-starter-kit/02-create.md +++ b/source/content/guides/decoupled/no-starter-kit/02-create.md @@ -16,6 +16,7 @@ audience: [development] product: [decoupled] integration: [--] --- + This section provides information on how to create a Front-End Site without a starter kit and/or CMS on Pantheon. diff --git a/source/content/guides/decoupled/no-starter-kit/03-import-repo.md b/source/content/guides/decoupled/no-starter-kit/03-import-repo.md index 2f71bb6d7e..16430fb5f0 100644 --- a/source/content/guides/decoupled/no-starter-kit/03-import-repo.md +++ b/source/content/guides/decoupled/no-starter-kit/03-import-repo.md @@ -16,6 +16,7 @@ audience: [development] product: [decoupled] integration: [--] --- + You can import your Git-provided repository to create your Front-End Site. diff --git a/source/content/guides/decoupled/no-starter-kit/04-any-framework.md b/source/content/guides/decoupled/no-starter-kit/04-any-framework.md index 461e428092..716b6bcc7c 100644 --- a/source/content/guides/decoupled/no-starter-kit/04-any-framework.md +++ b/source/content/guides/decoupled/no-starter-kit/04-any-framework.md @@ -16,6 +16,7 @@ audience: [development] product: [decoupled] integration: [--] --- + Pantheon Front-End Sites Early Access (EA) program currently supports Gatsby and Next.js as frontend frameworks. Additional frameworks will be added to our official support list over the coming months. diff --git a/source/content/guides/decoupled/no-starter-kit/05-build-details.md b/source/content/guides/decoupled/no-starter-kit/05-build-details.md index c53cdce982..4d108ee3e9 100644 --- a/source/content/guides/decoupled/no-starter-kit/05-build-details.md +++ b/source/content/guides/decoupled/no-starter-kit/05-build-details.md @@ -16,5 +16,7 @@ audience: [development] product: [decoupled] integration: [--] --- + + \ No newline at end of file diff --git a/source/content/guides/decoupled/no-starter-kit/06-manage-settings.md b/source/content/guides/decoupled/no-starter-kit/06-manage-settings.md index 400cf6d68d..e03d1e607e 100644 --- a/source/content/guides/decoupled/no-starter-kit/06-manage-settings.md +++ b/source/content/guides/decoupled/no-starter-kit/06-manage-settings.md @@ -16,5 +16,6 @@ audience: [development] product: [decoupled] integration: [--] --- + \ No newline at end of file diff --git a/source/content/guides/decoupled/overview/01-introduction.md b/source/content/guides/decoupled/overview/01-introduction.md index 0c755508e0..456533e555 100644 --- a/source/content/guides/decoupled/overview/01-introduction.md +++ b/source/content/guides/decoupled/overview/01-introduction.md @@ -7,7 +7,7 @@ contributors: [backlineint, cobypear, hckia, joan-ing] layout: guide showtoc: true permalink: docs/guides/decoupled/overview -reviewed: "2023-03-23" +reviewed: "2025-11-17" contenttype: [guide] innav: [true] categories: [create] @@ -17,13 +17,11 @@ product: [decoupled] integration: [--] --- -Front-End Sites on Pantheon allow you to use [decoupled architecture](/guides/decoupled/overview/#what-is-a-decoupled-site) to separate your frontend and backend into distinct entities. + - -Pantheon Front-End Sites are available for Early Access participants. Features for Pantheon Front-End Sites are in active development. Pantheon's development team is rolling out new functionality often while this product is in Early Access. Enrollment is open for our [ Front-End Sites Early Access program](https://pantheon.io/features/decoupled-cms). Please review Pantheon's [Software Evaluation Licensing Terms](https://legal.pantheon.io/#contract-hkqlbwpxo) for more information about access to our software. +Front-End Sites on Pantheon allow you to use [decoupled architecture](/guides/decoupled/overview/#what-is-a-decoupled-site) to separate your frontend and backend into distinct entities. - ## What is a Decoupled Site? diff --git a/source/content/guides/decoupled/overview/02-considerations.md b/source/content/guides/decoupled/overview/02-considerations.md index 827db028de..7881ecda16 100644 --- a/source/content/guides/decoupled/overview/02-considerations.md +++ b/source/content/guides/decoupled/overview/02-considerations.md @@ -7,7 +7,7 @@ contributors: [joan-ing, backlineint, cobypear, hckia] layout: guide showtoc: true permalink: docs/guides/decoupled/overview/considerations -reviewed: "2023-03-23" +reviewed: "2025-11-17" contenttype: [guide] innav: [false] categories: [create] @@ -17,6 +17,9 @@ product: [decoupled] integration: [--] --- + + + Review this section carefully to ensure your system has the correct components to deploy a Pantheon Front-End Site. ## General Requirements @@ -25,12 +28,6 @@ Review this section carefully to ensure your system has the correct components t - You are using [Visual Studio Code (VS Code)](https://code.visualstudio.com/) - Other IDEs can be used, but our project ships with suggested plugins and example settings for VSCode. - - -Check out the [Front-End Sites landing page](/guides/decoupled/) to access all documentation for Front-End Sites. - - - ## Backend Requirements The following components are required for your backend, especially if using the starter kits for Pantheon Front-End Sites: diff --git a/source/content/guides/decoupled/overview/03-site-options.md b/source/content/guides/decoupled/overview/03-site-options.md index 12028966f2..39a18147f3 100644 --- a/source/content/guides/decoupled/overview/03-site-options.md +++ b/source/content/guides/decoupled/overview/03-site-options.md @@ -7,7 +7,7 @@ contributors: [joan-ing, backlineint, cobypear, hckia] layout: guide showtoc: true permalink: docs/guides/decoupled/overview/site-options -reviewed: "2023-03-23" +reviewed: "2025-11-17" contenttype: [guide] innav: [false] categories: [create] @@ -17,6 +17,9 @@ product: [decoupled] integration: [--] --- + + + This section provides information on site options and starter kits to help you find a starting point to create your Front-End Site. You can build Front-End Sites on Pantheon using several methods. The Front-End Site option must be enabled before you can apply your own configuration or use a [compatible starter kit](https://decoupledkit.pantheon.io/docs/decoupled-kit-overview). diff --git a/source/content/guides/decoupled/overview/04-site.md b/source/content/guides/decoupled/overview/04-site.md index 797eea1fe0..8564bbb3e1 100644 --- a/source/content/guides/decoupled/overview/04-site.md +++ b/source/content/guides/decoupled/overview/04-site.md @@ -8,7 +8,7 @@ layout: guide showtoc: true permalink: docs/guides/decoupled/overview/site anchorid: site -reviewed: "2023-03-23" +reviewed: "2025-11-17" contenttype: [guide] innav: [false] categories: [create] @@ -18,6 +18,9 @@ product: [decoupled] integration: [--] --- + + + This section provides information to help you create your Front-End Site. ## Before You Begin diff --git a/source/content/guides/decoupled/overview/05-manage-settings.md b/source/content/guides/decoupled/overview/05-manage-settings.md index 536fafdfc6..75f13450af 100644 --- a/source/content/guides/decoupled/overview/05-manage-settings.md +++ b/source/content/guides/decoupled/overview/05-manage-settings.md @@ -16,6 +16,9 @@ audience: [development] product: [decoupled] integration: [--] --- + + + This section provides information on Settings. You can configure Front-End Site settings in the Pantheon dashboard, including: diff --git a/source/content/guides/decoupled/overview/06-fes-multidev.md b/source/content/guides/decoupled/overview/06-fes-multidev.md index eae6a4f414..82c80f305f 100644 --- a/source/content/guides/decoupled/overview/06-fes-multidev.md +++ b/source/content/guides/decoupled/overview/06-fes-multidev.md @@ -17,6 +17,9 @@ product: [decoupled] integration: [--] --- + + + This section provides information on the Front-End Sites Multidev workflow, configuration steps to connect your Front-End Site to a Multidev environment, and information on Multidev branch builds. ## Front-End Sites Multidev Development Workflow diff --git a/source/content/guides/decoupled/overview/07-support.md b/source/content/guides/decoupled/overview/07-support.md index 005991fb67..da6e24ef85 100644 --- a/source/content/guides/decoupled/overview/07-support.md +++ b/source/content/guides/decoupled/overview/07-support.md @@ -7,7 +7,7 @@ contributors: [joan-ing] layout: guide showtoc: true permalink: docs/guides/decoupled/overview/support -reviewed: "2024-09-10" +reviewed: "2025-11-17" contenttype: [guide] innav: [false] categories: [create] @@ -17,6 +17,9 @@ product: [decoupled] integration: [--] --- + + + Pantheon supports installation and configuration of Front-End Sites hosted on the platform. Support includes use of the documented workflows as defined in this guide. ## What is Included in the Scope of Support? diff --git a/source/content/guides/decoupled/overview/08-faq.md b/source/content/guides/decoupled/overview/08-faq.md index f28951102e..a544937613 100644 --- a/source/content/guides/decoupled/overview/08-faq.md +++ b/source/content/guides/decoupled/overview/08-faq.md @@ -7,7 +7,7 @@ contributors: [backlineint, cobypear, hckia, joan-ing] layout: guide showtoc: true permalink: docs/guides/decoupled/overview/faq -reviewed: "2023-03-23" +reviewed: "2025-11-17" contenttype: [guide] innav: [false] categories: [create] @@ -17,6 +17,9 @@ product: [decoupled] integration: [--] --- + + + This section provides answers to frequently asked Front-End Site questions. ### Can I use any CMS with Pantheon architecture for Front-End Sites? diff --git a/source/content/guides/decoupled/overview/09-troubleshooting.md b/source/content/guides/decoupled/overview/09-troubleshooting.md index 77848bc2cd..8c659f3ca8 100644 --- a/source/content/guides/decoupled/overview/09-troubleshooting.md +++ b/source/content/guides/decoupled/overview/09-troubleshooting.md @@ -7,7 +7,7 @@ contributors: [backlineint, cobypear, hckia] layout: guide showtoc: true permalink: docs/guides/decoupled/overview/troubleshooting -reviewed: "2023-03-23" +reviewed: "2025-11-17" contenttype: [guide] innav: [false] categories: [create] @@ -17,6 +17,9 @@ product: [decoupled] integration: [--] --- + + + This section provides information on known issues and solutions to common troubleshooting scenarios. ## Known Issues diff --git a/source/content/guides/decoupled/overview/10-v1-pipeline.md b/source/content/guides/decoupled/overview/10-v1-pipeline.md index d562c33614..3601964e56 100644 --- a/source/content/guides/decoupled/overview/10-v1-pipeline.md +++ b/source/content/guides/decoupled/overview/10-v1-pipeline.md @@ -7,7 +7,7 @@ contributors: [stevector] layout: guide showtoc: true permalink: docs/guides/decoupled/overview/v1-pipeline -reviewed: "2023-03-23" +reviewed: "2025-11-17" contenttype: [guide] innav: [false] categories: [create] @@ -17,6 +17,9 @@ product: [decoupled] integration: [--] --- + + + In the Fall of 2023 Pantheon introduced a new build pipeline for Front End Sites. Among under-the-hood-optimizations, like [caching of folders between builds](/guides/decoupled/overview/manage-settings#build-cache), [the new pipeline now uses your `package.json` file](/guides/decoupled/overview/manage-settings#nodejs-version) to select the appropriate version of Node.js for your build and your runtime environments. diff --git a/source/content/guides/decoupled/wp-backend-starters/01-introduction.md b/source/content/guides/decoupled/wp-backend-starters/01-introduction.md index 3d594e3b3c..3795dbebff 100644 --- a/source/content/guides/decoupled/wp-backend-starters/01-introduction.md +++ b/source/content/guides/decoupled/wp-backend-starters/01-introduction.md @@ -17,6 +17,9 @@ product: [decoupled] integration: [--] --- + + + Front-End Sites on Pantheon allow you to use [decoupled architecture](/guides/decoupled/overview/#what-is-a-decoupled-site) to separate your frontend and backend into distinct entities. You can use the WordPress backend starter kit to streamline the creation of your Front-End Site on Pantheon. This guide shows you how to install, set up local development, manage WordPress dependencies, configure build hooks, and more. diff --git a/source/content/guides/decoupled/wp-backend-starters/02-create.md b/source/content/guides/decoupled/wp-backend-starters/02-create.md index 42ea9f6a96..f26061e0cf 100644 --- a/source/content/guides/decoupled/wp-backend-starters/02-create.md +++ b/source/content/guides/decoupled/wp-backend-starters/02-create.md @@ -17,6 +17,9 @@ product: [decoupled] integration: [--] --- + + + This section provides information on how to create a new WordPress backend project with Pantheon's starter kit. ## Create with Dashboard Upstream diff --git a/source/content/guides/decoupled/wp-backend-starters/03-caching.md b/source/content/guides/decoupled/wp-backend-starters/03-caching.md index 806f8abe8c..27175a6db4 100644 --- a/source/content/guides/decoupled/wp-backend-starters/03-caching.md +++ b/source/content/guides/decoupled/wp-backend-starters/03-caching.md @@ -17,6 +17,9 @@ product: [decoupled] integration: [--] --- + + + Cache settings are configured out-of-the-box for you, but there are circumstances in which you might need to make your own configurations, such as when your CMS is not on Pantheon but your frontend is on Pantheon. ## How it Works diff --git a/source/content/guides/decoupled/wp-backend-starters/04-manage-settings.md b/source/content/guides/decoupled/wp-backend-starters/04-manage-settings.md index b8e5a9354e..acaa980118 100644 --- a/source/content/guides/decoupled/wp-backend-starters/04-manage-settings.md +++ b/source/content/guides/decoupled/wp-backend-starters/04-manage-settings.md @@ -17,4 +17,7 @@ product: [decoupled] integration: [--] --- + + + \ No newline at end of file diff --git a/source/content/guides/decoupled/wp-backend-starters/05-build-hooks.md b/source/content/guides/decoupled/wp-backend-starters/05-build-hooks.md index c978bf41e9..3917f5cd13 100644 --- a/source/content/guides/decoupled/wp-backend-starters/05-build-hooks.md +++ b/source/content/guides/decoupled/wp-backend-starters/05-build-hooks.md @@ -17,6 +17,9 @@ product: [decoupled] integration: [--] --- + + + This section provides information on how to configure build hooks on your WordPress backend. ## What Are Build Hooks? diff --git a/source/content/guides/decoupled/wp-gatsby-frontend-starters/01-introduction.md b/source/content/guides/decoupled/wp-gatsby-frontend-starters/01-introduction.md index 520c684e9b..22415eb89f 100644 --- a/source/content/guides/decoupled/wp-gatsby-frontend-starters/01-introduction.md +++ b/source/content/guides/decoupled/wp-gatsby-frontend-starters/01-introduction.md @@ -17,6 +17,9 @@ product: [decoupled] integration: [--] --- + + + Front-End Sites on Pantheon allow you to use [decoupled architecture](/guides/decoupled/overview/#what-is-a-decoupled-site) to separate your frontend and backend into distinct entities. You can use a frontend starter kit to streamline the creation of your Front-End site on Pantheon. Available WordPress frontend starters are: diff --git a/source/content/guides/decoupled/wp-gatsby-frontend-starters/02-create.md b/source/content/guides/decoupled/wp-gatsby-frontend-starters/02-create.md index 567e91456b..dcef4bc95d 100644 --- a/source/content/guides/decoupled/wp-gatsby-frontend-starters/02-create.md +++ b/source/content/guides/decoupled/wp-gatsby-frontend-starters/02-create.md @@ -17,6 +17,9 @@ product: [decoupled] integration: [--] --- + + + This section provides information on how to use the Gatsby + WordPress starter kit. ## Before You Begin diff --git a/source/content/guides/decoupled/wp-gatsby-frontend-starters/03-build-details.md b/source/content/guides/decoupled/wp-gatsby-frontend-starters/03-build-details.md index a4211b1945..6098a16f69 100644 --- a/source/content/guides/decoupled/wp-gatsby-frontend-starters/03-build-details.md +++ b/source/content/guides/decoupled/wp-gatsby-frontend-starters/03-build-details.md @@ -17,4 +17,7 @@ product: [decoupled] integration: [--] --- + + + \ No newline at end of file diff --git a/source/content/guides/decoupled/wp-gatsby-frontend-starters/04-manage-settings.md b/source/content/guides/decoupled/wp-gatsby-frontend-starters/04-manage-settings.md index 11b8759f5f..a821a263c1 100644 --- a/source/content/guides/decoupled/wp-gatsby-frontend-starters/04-manage-settings.md +++ b/source/content/guides/decoupled/wp-gatsby-frontend-starters/04-manage-settings.md @@ -17,4 +17,7 @@ product: [decoupled] integration: [--] --- + + + \ No newline at end of file diff --git a/source/content/guides/decoupled/wp-gatsby-frontend-starters/05-robots-indexing.md b/source/content/guides/decoupled/wp-gatsby-frontend-starters/05-robots-indexing.md index f24aa0b445..f55173dc80 100644 --- a/source/content/guides/decoupled/wp-gatsby-frontend-starters/05-robots-indexing.md +++ b/source/content/guides/decoupled/wp-gatsby-frontend-starters/05-robots-indexing.md @@ -17,6 +17,9 @@ product: [decoupled] integration: [--] --- + + + This section provides information on how to use a `robots.txt` file to manage indexing for Front-End Sites. ## Robots.txt File diff --git a/source/content/guides/decoupled/wp-nextjs-frontend-starters/01-introduction.md b/source/content/guides/decoupled/wp-nextjs-frontend-starters/01-introduction.md index f621f01da6..7512cd7e3b 100644 --- a/source/content/guides/decoupled/wp-nextjs-frontend-starters/01-introduction.md +++ b/source/content/guides/decoupled/wp-nextjs-frontend-starters/01-introduction.md @@ -17,6 +17,9 @@ product: [decoupled] integration: [--] --- + + + Front-End Sites on Pantheon allow you to use [decoupled architecture](/guides/decoupled/overview/#what-is-a-decoupled-site) to separate your frontend and backend into distinct entities. You can use a frontend starter kit to streamline the creation of your Front-End Site on Pantheon. Available WordPress Front-End starters are: diff --git a/source/content/guides/decoupled/wp-nextjs-frontend-starters/02-create.md b/source/content/guides/decoupled/wp-nextjs-frontend-starters/02-create.md index 253477d5d0..724625dc70 100644 --- a/source/content/guides/decoupled/wp-nextjs-frontend-starters/02-create.md +++ b/source/content/guides/decoupled/wp-nextjs-frontend-starters/02-create.md @@ -17,6 +17,9 @@ product: [decoupled] integration: [--] --- + + + This section provides information on how to use the Next.js + WordPress starter kit. ## Before You Begin diff --git a/source/content/guides/decoupled/wp-nextjs-frontend-starters/03-build-details.md b/source/content/guides/decoupled/wp-nextjs-frontend-starters/03-build-details.md index 60c1b038f7..62973015f9 100644 --- a/source/content/guides/decoupled/wp-nextjs-frontend-starters/03-build-details.md +++ b/source/content/guides/decoupled/wp-nextjs-frontend-starters/03-build-details.md @@ -17,4 +17,7 @@ product: [decoupled] integration: [--] --- + + + \ No newline at end of file diff --git a/source/content/guides/decoupled/wp-nextjs-frontend-starters/03-caching.md b/source/content/guides/decoupled/wp-nextjs-frontend-starters/03-caching.md index ceccb08e5f..f46793515a 100644 --- a/source/content/guides/decoupled/wp-nextjs-frontend-starters/03-caching.md +++ b/source/content/guides/decoupled/wp-nextjs-frontend-starters/03-caching.md @@ -17,6 +17,9 @@ product: [decoupled] integration: [--] --- + + + Cache settings are configured out-of-the-box for you, but there are circumstances in which you might need to make your own configurations, such as when your is not on Pantheon but your frontend is on Pantheon. ## How it Works diff --git a/source/content/guides/decoupled/wp-nextjs-frontend-starters/04-manage-settings.md b/source/content/guides/decoupled/wp-nextjs-frontend-starters/04-manage-settings.md index 0cc2cc988b..4b91146752 100644 --- a/source/content/guides/decoupled/wp-nextjs-frontend-starters/04-manage-settings.md +++ b/source/content/guides/decoupled/wp-nextjs-frontend-starters/04-manage-settings.md @@ -17,4 +17,7 @@ product: [decoupled] integration: [--] --- + + + \ No newline at end of file diff --git a/source/content/guides/decoupled/wp-nextjs-frontend-starters/05-content-preview.md b/source/content/guides/decoupled/wp-nextjs-frontend-starters/05-content-preview.md index 41227fb3c5..7bc8fc40e8 100644 --- a/source/content/guides/decoupled/wp-nextjs-frontend-starters/05-content-preview.md +++ b/source/content/guides/decoupled/wp-nextjs-frontend-starters/05-content-preview.md @@ -17,6 +17,9 @@ product: [decoupled] integration: [--] --- + + + This section provides information on how to configure decoupled content preview for your site. This allows you to preview your content changes in the Next.js app before publishing to your live site. ## Before You Begin diff --git a/source/content/guides/decoupled/wp-nextjs-frontend-starters/06-robots-indexing.md b/source/content/guides/decoupled/wp-nextjs-frontend-starters/06-robots-indexing.md index a37f312b83..c357663b34 100644 --- a/source/content/guides/decoupled/wp-nextjs-frontend-starters/06-robots-indexing.md +++ b/source/content/guides/decoupled/wp-nextjs-frontend-starters/06-robots-indexing.md @@ -17,6 +17,9 @@ product: [decoupled] integration: [--] --- + + + This section provides information on how to use a `robots.txt` file to manage indexing for Front-End Sites. diff --git a/source/content/guides/wordpress-pantheon/08-wordpress-developers.md b/source/content/guides/wordpress-pantheon/08-wordpress-developers.md index 42316c1fa2..bd0460313a 100644 --- a/source/content/guides/wordpress-pantheon/08-wordpress-developers.md +++ b/source/content/guides/wordpress-pantheon/08-wordpress-developers.md @@ -24,7 +24,7 @@ View our [WordPress Command Line](/guides/wp-cli) guide for steps to create and ## Run WordPress as a Backend API -Pantheon supports [running WordPress as an API](/guides/decoupled) (Application Programming Interface) for the backend of headless sites, which enables the CMS to interact with external frontend applications over HTTP requests. +Pantheon supports [running WordPress as an API](/guides/decoupled/overview) (Application Programming Interface) for the backend of headless sites, which enables the CMS to interact with external frontend applications over HTTP requests. ## WordPress on Pantheon Developer Best Practices diff --git a/source/content/nextjs/connecting-custom-domain.md b/source/content/nextjs/connecting-custom-domain.md index 853bcc621f..3791fefed1 100644 --- a/source/content/nextjs/connecting-custom-domain.md +++ b/source/content/nextjs/connecting-custom-domain.md @@ -1,6 +1,6 @@ --- title: Connecting a custom domain to Next.js on Pantheon -description: During the Alpha stage, reach out to Pantheon staff to connect a custom domain to your Next.js site. +description: During the Beta stage, reach out to Pantheon staff to connect a custom domain to your Next.js site. reviewed: "2025-10-31" contenttype: [doc] innav: [true] @@ -13,9 +13,9 @@ permalink: docs/nextjs/connecting-custom-domain-name -Please reach out to Pantheon staff through the communication channels of the Alpha program for assistance with connecting custom domains to Next.js sites. +Please reach out to Pantheon staff through the communication channels of the Beta program for assistance with connecting custom domains to Next.js sites. Sites on Pantheon generally require moving from an unpaid "Sandbox" plan to a paid plan before connecting a custom domain name through the dashboard. -However, in the Alpha phase we have not yet implemented self-service mechanism for moving Next.js sites between plans. +However, in the Beta phase we have not yet implemented self-service mechanism for moving Next.js sites between plans. Once Pantheon staff have enabled the capacity to connect a custom domain name to your Next.js site, you can follow the same instructions as for WordPress and Drupal sites: [Connecting a Custom Domain to Pantheon](/guides/launch/configure-dns/). As with any switching of DNS records, the amount of testing you choose to do before switching will depend on the risk tolerance of your organization and the nature of your site. diff --git a/source/content/nextjs/content-publisher-tutorial.md b/source/content/nextjs/content-publisher-tutorial.md index 9dbe88fb55..0ceef0bbd4 100644 --- a/source/content/nextjs/content-publisher-tutorial.md +++ b/source/content/nextjs/content-publisher-tutorial.md @@ -1,7 +1,7 @@ --- title: Content Publisher Tutorial for Next.js description: Integrate Content Publisher with a Next.js site on Pantheon -reviewed: "2025-10-31" +reviewed: "2025-11-17" contenttype: [doc] innav: [true] audience: [development] @@ -27,7 +27,7 @@ This tutorial will walk you through: ## Requirements -* Access granted for the [Next.js Private Alpha Program](/nextjs/#access--availability) +* Access granted for the [Next.js Private Beta Program](/nextjs/#access--availability) * A GitHub account with [SSH configured](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/about-ssh) * A [Content Publisher account](https://docs.content.pantheon.io/#h.9owhdt6w06gr) with [Administrator access](https://docs.content.pantheon.io/roles) * Install the following applications: diff --git a/source/content/nextjs/hello-world-tutorial.md b/source/content/nextjs/hello-world-tutorial.md index 958a56d7ae..343dbd9c24 100644 --- a/source/content/nextjs/hello-world-tutorial.md +++ b/source/content/nextjs/hello-world-tutorial.md @@ -1,7 +1,7 @@ --- title: Next.js Hello World Tutorial description: Get up and running with a simple Next.js application on Pantheon -reviewed: "2025-10-31" +reviewed: "2025-11-17" contenttype: [doc] innav: [true] audience: [development] @@ -22,7 +22,7 @@ This tutorial will walk you through: ## Requirements -* Access granted for the [Next.js Private Alpha Program](/nextjs/#access--availability) +* Access granted for the [Next.js Private Beta Program](/nextjs/#access--availability) * A GitHub account with [SSH configured](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/about-ssh) * Install [Git](https://git-scm.com/) * (Optional) Install the following applications: diff --git a/source/content/nextjs/migrating-from-front-end-sites.md b/source/content/nextjs/migrating-from-front-end-sites.md index c57350ad4e..0726b5065b 100644 --- a/source/content/nextjs/migrating-from-front-end-sites.md +++ b/source/content/nextjs/migrating-from-front-end-sites.md @@ -1,7 +1,7 @@ --- title: How to migrate from Front-End Sites description: Move your existing Next.js site from Pantheon's Front-End Sites to updated Next.js infrastructure. -reviewed: "2025-10-31" +reviewed: "2025-11-17" contenttype: [doc] innav: [true] audience: [development] @@ -13,11 +13,11 @@ permalink: docs/nextjs/migrating-from-front-end-sites -This guide walks through moving a Next.js site away from Pantheon's earlier [Front-End Sites offering](/guides/decoupled). +This guide walks through moving a Next.js site away from Pantheon's earlier [Front-End Sites offering](/guides/decoupled/overview). ## Requirements -* Access granted for the [Next.js Private Alpha Program](/nextjs/#access--availability) +* Access granted for the [Next.js Private Beta Program](/nextjs/#access--availability) * Administrative access to the GitHub repo used for your Next.js site. * Install the following CLI applications: - [Terminus](/terminus/install) @@ -80,9 +80,9 @@ terminus secret:site:set NEXT_PUBLIC_CMS_BASE_URL "http://example.co ### Confirm your site is working as expected -Once your environment variables are set, trigger a new build by pushing a code change to the `main` branch or opening a pull request. Once another build process has completed without error, confirm that your site is working as expected in the Dev environment. +Once your environment variables are set, trigger a new build by pushing a code change to the `main` branch or opening a pull request. Once another build process has completed without error, confirm that your site is working as expected in the Dev environment. -(Optional) You can follow the build process along by either refreshing the Build tab in the Site Dashboard or via Terminus: +(Optional) You can follow the build process along by either refreshing the Build tab in the Site Dashboard or via Terminus: ```bash{promptUser: user} terminus node:logs:build:list . diff --git a/source/content/nextjs/overview.md b/source/content/nextjs/overview.md index 2e916470dd..fd77a7f23b 100644 --- a/source/content/nextjs/overview.md +++ b/source/content/nextjs/overview.md @@ -16,9 +16,11 @@ Next.js is the leading React framework for building web applications and sites. It stands out for its use of cutting edge development techniques and strong commitment to performance for the end users of the web. ## Access & Availability -Access to Pantheon's Next.js support is currently available through a **Private Alpha** program. To request access, please reach out to nextjs@pantheon.io. +Access to Pantheon's Next.js support is currently available through a **Private Beta** program. -Pantheon's product engineering team is rolling out new functionality often while this product is in Private Alpha. Certain features and functionality are limited, for details see [this section below](#considerations). +To request an invite, [submit this form](https://pantheon.io/nextjs-beta). + +Pantheon's product engineering team is rolling out new functionality often while this product is in Private Beta. Certain features and functionality are limited, for details see [this section below](#considerations). ### Compatibility & Requirements * **Node versions:** @@ -60,4 +62,4 @@ The following are known limitations for Next.js on Pantheon: * Solr * The following Workspace features are not supported for Next.js at this time: * Autopilot - * Custom Upstreams \ No newline at end of file + * Custom Upstreams diff --git a/source/content/partials/fes-deprecated.md b/source/content/partials/fes-deprecated.md new file mode 100644 index 0000000000..3608194a31 --- /dev/null +++ b/source/content/partials/fes-deprecated.md @@ -0,0 +1,5 @@ + + +This documentation is considered deprecated. If you use Front-End Sites today, we encourage you to [migrate](/nextjs/migrating-from-front-end-sites). + + diff --git a/source/content/partials/nextjs-pre-ga.md b/source/content/partials/nextjs-pre-ga.md index 9a1978ce1c..7d56ff0faf 100644 --- a/source/content/partials/nextjs-pre-ga.md +++ b/source/content/partials/nextjs-pre-ga.md @@ -1,9 +1,9 @@ - + -This documentation describes support for Next.js that is under active development and is available only to customers who have been individually approved as part of our [Private Alpha program](/nextjs/#access--availability). +This documentation describes support for Next.js that is under active development and is available only to customers who have been individually approved as part of our **Private Beta** program. -To request access, please reach out to nextjs@pantheon.io. +To request an invite, [submit this form](https://pantheon.io/nextjs-beta). -If you are migrating an existing Next.js site from our [Front-End Sites](https://docs.pantheon.io/guides/decoupled) offering please see our guide on [migrating from Front-End Sites](/nextjs/migrating-from-front-end-sites). +If you are migrating an existing Next.js site from our [Front-End Sites](/guides/decoupled/overview) offering please see our guide on [migrating from Front-End Sites](/nextjs/migrating-from-front-end-sites). diff --git a/source/data/home.yaml b/source/data/home.yaml index 2ab934b1b6..6485d7ea15 100644 --- a/source/data/home.yaml +++ b/source/data/home.yaml @@ -55,12 +55,12 @@ summary: "Your destination for staying informed about our latest innovations and product updates." imageSrc: "https://cdn.bfldr.com/MEM5087K/at/bnmzkfsghpkcscw589pxqrxk/Release_New_Features-_Upstream.svg" url: "/release-notes" - #- headingText: "Using Next.js?" - # summary: "The information you need to use Next.js with Pantheon." - # imageSrc: "https://cdn.bfldr.com/MEM5087K/at/hxt9pfvt8xsr8znf4rc46sgf/Next_JS_-_Gradient.svg" - # url: "/nextjs" + - headingText: "Using Next.js?" + summary: "New feature! Learn more about our improved Next.js service." + imageSrc: "https://cdn.bfldr.com/MEM5087K/at/hxt9pfvt8xsr8znf4rc46sgf/Next_JS_-_Gradient.svg" + url: "/nextjs" - headingText: "Using WordPress?" - summary: "The information you need to use WordPress with Pantheon." + summary: "Your guide to using WordPress on Pantheon." imageSrc: "https://cdn.bfldr.com/MEM5087K/at/mpmvm452gkq9f3sk9cjt8q/WordPress.svg" url: "/develop-wordpress" - headingText: "Using Drupal?" diff --git a/source/data/landings.yaml b/source/data/landings.yaml index 9e86cde89b..f4184b9de4 100644 --- a/source/data/landings.yaml +++ b/source/data/landings.yaml @@ -1183,54 +1183,6 @@ url: '/guides/enterprise-billing-center/invoices' - text: 'Site Portfolio Report' url: '/guides/enterprise-billing-center/site-portfolio-report' -- title: "Front-End Sites on Pantheon" - subtitle: "Learn about Front-End Sites on Pantheon." - path: "guides/decoupled" - guides: - - title: "" - type: "normal" - links: - - text: "Overview" - url: "/guides/decoupled/overview" - - text: "What is Decoupled?" - url: "/guides/decoupled/overview#what-is-a-decoupled-site" - - text: "Front-End Sites Requirements and Considerations" - url: "/guides/decoupled/overview/considerations" - - text: "Front-End Sites Compatibility" - url: "/guides/decoupled/overview/site-options#compatibility" - - text: "Front-End Sites FAQs" - url: "/guides/decoupled/overview/faq" - - text: "Create a Front-End Site" - url: "/guides/decoupled/overview/site" - topics-groups: - - title: "Import a Repository" - subtitle: "" - links: - - text: "Create a Front-End Site by Importing Your Repo" - url: "/guides/decoupled/no-starter-kit/import-repo" - - title: "No Starter or CMS" - subtitle: "" - links: - - text: "Create a Front-End Site without a Starter" - url: "/guides/decoupled/no-starter-kit/create" - - text: "Create a Front-End Site without a CMS" - url: "/guides/decoupled/no-starter-kit/create" - - title: "Frontend Starters" - subtitle: "" - links: - - text: "Drupal + Next.js Frontend Starter" - url: "/guides/decoupled/drupal-nextjs-frontend-starters" - - text: "WordPress + Next.js Frontend Starter" - url: "/guides/decoupled/wp-nextjs-frontend-starters" - - text: "WordPress + Gatsby Frontend Starter" - url: "/guides/decoupled/wp-gatsby-frontend-starters" - - title: "Backend Starters" - subtitle: "" - links: - - text: "Drupal Backend Starter" - url: "/guides/decoupled/drupal-backend-starters" - - text: "WordPress Backend Starter" - url: "/guides/decoupled/wp-backend-starters" - title: "Security" subtitle: "Learn more about platform security, secure development, and secure integration on Pantheon." path: "guides/security" diff --git a/source/images/nextjs/site-list.png b/source/images/nextjs/site-list.png new file mode 100644 index 0000000000..2ecb8628a7 Binary files /dev/null and b/source/images/nextjs/site-list.png differ diff --git a/source/releasenotes/2018-01-01-documentation.md b/source/releasenotes/2018-01-01-documentation.md index 347e66bd55..aec85acecf 100644 --- a/source/releasenotes/2018-01-01-documentation.md +++ b/source/releasenotes/2018-01-01-documentation.md @@ -3,7 +3,7 @@ title: Documentation published_date: "2018-01-01" categories: [documentation] --- -### [Running WordPress and Drupal as a Backend API](/guides/decoupled) +### [Running WordPress and Drupal as a Backend API](/guides/decoupled/overview) Learn the basics of using WordPress or Drupal as a headless API backend. ### [Manage Some Dependencies with Composer](/guides/partial-composer) diff --git a/source/releasenotes/2025-11-18-nextjs-private-beta.md b/source/releasenotes/2025-11-18-nextjs-private-beta.md new file mode 100644 index 0000000000..5f1beb53f4 --- /dev/null +++ b/source/releasenotes/2025-11-18-nextjs-private-beta.md @@ -0,0 +1,34 @@ +--- +title: "Next.js on Pantheon enters Private Beta, sunsetting Front-End Sites" +published_date: "2025-11-18" +categories: [nextjs, documentation, new-feature, front-end-sites] +--- + +Today, Pantheon's new solution for Next.js enters **Private Beta**. To request an invite, [submit this form](https://pantheon.io/nextjs-beta). + +**Front-End Sites**, our previous offering for Next.js, will be discontinued. We encourage users to [migrate to the updated architecture](/nextjs/migrating-from-front-end-sites). + +For more information, see [this related blog post](https://pantheon.io/blog/next-js-beta). + + +## What's new? +Some key changes for Next.js on Pantheon include: + +* Improved runtime architecture, including [support for Pantheon's Global CDN](/nextjs/architecture). +* Site creation via [the command line](/nextjs/cli-tools) or [the dashboard](/nextjs/hello-world-tutorial#site-creation). +* Sites listed in your workspace alongside WordPress and Drupal, instead of a separate tab. +* Unified site dashboard design that's consistent with WordPress and Drupal user interfaces: + ![The Pantheon dashboard showing a dev environment for a Next.js site](../images/nextjs/dev-build.png) + +For more detailed information on the differences from Front-End Sites, [see our migration guide](/nextjs/migrating-from-front-end-sites#differences-between-front-end-sites-and-new-nextjs-sites). + +### Documentation +For usage instructions and guidance, see the following new docs: + +* [Next.js Overview](/nextjs) +* [Runtime Architecture](/nextjs/architecture) +* [Limitations and considerations](/nextjs/considerations) +* [Hello World Tutorial](/nextjs/hello-world-tutorial) +* [Content Publisher Tutorial](/nextjs/content-publisher-tutorial) +* [Migrating from Front-End Sites](/nextjs/migrating-from-front-end-sites) +* [Managing environment variables](/nextjs/environment-variables) diff --git a/source/releasenotescategories/releaseNoteCategories.json b/source/releasenotescategories/releaseNoteCategories.json index bdc5cf73c2..409d246713 100644 --- a/source/releasenotescategories/releaseNoteCategories.json +++ b/source/releasenotescategories/releaseNoteCategories.json @@ -36,6 +36,12 @@ "color": "color-7", "description": "Tailored for updates specific to the Drupal content management system, helping Drupal users stay informed about platform changes that directly impact their workflows" }, + { + "slug": "nextjs", + "displayName": "Next.js", + "color": "color-1", + "description": "Information about Pantheon's support for Next.js, the leading React framework for building web applications" + }, { "slug": "events", "displayName": "Events", diff --git a/src/components/omniSidebarNav/submenus/webInfrastructure.js b/src/components/omniSidebarNav/submenus/webInfrastructure.js index ea99938f19..22e6459594 100644 --- a/src/components/omniSidebarNav/submenus/webInfrastructure.js +++ b/src/components/omniSidebarNav/submenus/webInfrastructure.js @@ -179,9 +179,11 @@ const webInfrastructure = () => { ]), ]), + simpleLink('/addons', 'Performance Add-ons'), + simpleLink('/integrations', 'Integrations'), { - link: '/guides/decoupled', - title: 'Front-End Sites and Starter Kits', + link: '/guides/decoupled/overview', + title: 'Front-End Sites [Deprecated]', children: [ getGuideDirectory('guides/decoupled/overview'), getGuideDirectory('guides/decoupled/wp-nextjs-frontend-starters'), @@ -196,8 +198,6 @@ const webInfrastructure = () => { ), ], }, - simpleLink('/addons', 'Performance Add-ons'), - simpleLink('/integrations', 'Integrations'), ], }; };