Skip to main content

How to install dependencies

Follow these steps after scaffolding a Foundation app from the private npm distribution.

Prerequisites​

Before running the scaffolder, make sure you have:

  • Node.js 24
  • pnpm
  • Git

The scaffolder runs git init and pnpm install in the generated app. If either command fails, check that the corresponding CLI is installed and available on your PATH, then rerun the scaffolder.

pnpm dlx @krakentech/create-blueprint-foundation my-app
cd my-app

1. Set up npm credentials​

Blueprint's Foundation app depends on private npm packages. To have access to these, set the necessary authToken in an .npmrc file locally. The authToken is provided by Kraken Technologies, typically supplied by CDL during initial Kraken instantiation and rotated at defined periods.

  1. Duplicate the .npmrc.example file and rename it to .npmrc at the root of the project.
  2. Paste the value of the authToken provided by Kraken Technologies as the value for //registry.npmjs.org/:\_authToken=.

2. Set up environment variables​

Copy .env.example to .env.local and set these required values before running pnpm generate:

  • KRAKEN_GRAPHQL_ENDPOINT
  • KRAKEN_AUTH_ENDPOINT
  • KRAKEN_OAUTH_CLIENT_ID
  • KRAKEN_X_CLIENT_IP_SECRET_KEY

3. Make sure you have node v24.15.0 installed​

The generated Foundation app includes a .nvmrc, so you can run nvm use to make sure you're using the right version.

4. Install dependencies​

The scaffolder runs this for new external-client projects. Rerun it only after changing the version of any of the dependencies.

First enable corepack (if you haven't already) by running:

corepack enable
note

You'll have to do this once every time you use a node version for the first time.

Then run:

pnpm i
Troubleshooting

If you see a ERR_PNPM_FETCH error when running pnpm i, it is likely due to a missing or invalid authToken. Double-check your .npmrc file has the correct value. If you need help obtaining the token, reach out on the #cust-web-blueprint-feedback Slack channel.

You should now be ready to configure the Foundation app, including the required Kraken environment variables, and then run it locally!