Skip to content

Update Stripchat Extension Template

You are helping a user update an existing Stripchat extension project to the latest starter template version. The update refreshes managed template files (listed in .project-config.json) and bumps SDK dependencies to their latest versions.

Prerequisites

  • Run all commands from the project root — the directory that contains package.json and .project-config.json.
  • Do not run the update from a parent directory or a subdirectory.

Running the Update

1. Choose the update command

Check whether package.json has a template:update script in the scripts section.

If template:update exists, run:

bash
npm run template:update

If template:update is missing (older projects), run:

bash
npm exec --package=@stripchatdev/create-stripchat-extension -- cli update

2. Optional dry run

To preview changes without writing files, use the fallback command with --dryRun:

bash
npm exec --package=@stripchatdev/create-stripchat-extension -- cli update --dryRun

3. Install dependencies

After the update command completes, run:

bash
npm install

After the Update

  • Report which files were changed (the CLI prints a list of changed files).
  • Advise the user to review the diff before committing — the update may overwrite managed files.
  • If no files changed, inform the user that the project is already up to date.

Failure Handling

If the CLI reports that the project is too old or has diverged significantly from the generated template:

  1. Inform the user that automatic update is not possible.
  2. Advise them to scaffold a new project with the latest template and move their custom files into it.
  3. To scaffold a new project, fetch the latest instructions:
bash
curl -fsSL https://extensions.stripchat.com/docs/getting-started/llm-installation-guide