Create a Front-End Site

This section provides information to help you create your Front-End Site.

Before You Begin

Confirm the following prerequisites before you create your site:

• The Front-End-Sites tab is enabled in your dashboard after onboarding.

• Your site repository is in GitHub.

• Composer is installed globally.

  • Composer is required for the CMS backends.

• You have a domain to use for the Front-End Site.

• You will use Next.js or Gatsby as the frontend framework.

  Info:

  Note

  You can use any JavaScript-based runtime, or any static site generator that outputs HTML/CSS/JS, but Pantheon only fully supports Next.js and Gatsby.

• (Optional). You are using the latest version of Drupal, or WordPress for the CMS.

• (Optional). If using a pre-configured starter kit template, you will use one of the following combinations:

  • Drupal and Next.js

  • WordPress and Next.js

  • WordPress and Gatsby

    Info:

    Note

    Other configurations are possible but not fully supported.

Optional Components

1. Install Terminus version 3.0.0 or higher.

   • You can also install the following plugins to improve your experience:
     • terminus self:plugin:install terminus-build-tools-plugin
     • terminus self:plugin:install terminus-secrets-plugin
     • Reload the terminus plugins: terminus self:plugin:reload
     • Clear cache for composer: composer clear-cache
     • Validate that the required plugins are installed: terminus self:plugin:list

2. Create a Machine Token.

   • Generate a machine token.
   • Authenticate the token into Terminus.

3. Create GitHub Personal Access Tokens.

4. Create CircleCI Personal API Tokens.

Create a Front-End Site

You must decide how you want to create your Front-End Site before you can begin your journey with decoupled site architecture. There are several methods you can use. Select the method below that meets your configuration requirements and follow the instructions carefully.