For detailed documentation on the Decoupled Kit Starters, visit the Decoupled Kit developer documentation.
For more information on using the starter on Pantheon Front-End Sites, visit the Pantheon.io platform documentation.
The Next Drupal starter requires Node.js and is built and tested on the LTS version which can be found on the Node.js downloads page.
The starter kit supports npm, pnpm, and yarn. If you created the starer via the
Pantheon Front-End Sites dashboard, it will use npm by default. To change this,
delete the package-lock.json
file and the node-modules
folder, then run the
install command of your preferred package manager.
If you created the starter via create-pantheon-decoupled-kit
, it will detect
the package manager used to run the command and use it install the starter's
dependencies unless the --noInstall
flag was used.
The Pantheon
@pantheon-systems/drupal-kit
is included as a dependency in this project. This allows developers to make use
of utility functions to simplify the process of building and maintaining a
Front-End site on Pantheon.
API reference documentation can be found at https://decoupledkit.pantheon.io/docs/Packages/drupal-kit.
The create-pantheon-decoupled-kit
npm package, or "the CLI", is the single
source of truth for all of the JavaScript/TypeScript starter kit templates. See
Using the CLI
for more information.
In addition to scaffolding new projects, a number of add-ons are available which can be added to an existing project. For more detailed information on the available add-ons, see the Decoupled Kit developer documentation.
To ensure the Decoupled Kit starter has what it needs to source data from a Decoupled Kit Backend, a health-check is run as a part of the the build command and will error in case a critical component is not met.
See a detailed description of the health-check here.
To disable the health check, see Disabling the decoupled kit health check
To configure the starter for local development with Lando, see the Decoupled Kit developer docs on Local Development.
The Decoupled Kit starters include a number of scripts defined in the
package.json
. To list all of these scripts, cd
into your starter's directory
and in a terminal use the npm run
command.
Some commands include:
Runs the starter in developer mode.
Runs the build step for the starter. By default, the
@pantheon-systems/decoupled-kit-health-check
is run before the build. This
command is required for Pantheon Front-End Sites.
Runs the starter in production mode. This command is required for Pantheon Front-End Sites.
Runs the tests.
Updates the snapshots used for the snapshot tests. The starter comes with an example snapshot test that may need to be updating depending on your configuration.