Skip to main content

Updating Spec-Up-T

Introduction​

This guide provides step-by-step instructions to update your Spec-Up-T installation.

Prerequisites​

Before proceeding, ensure you have the following tools and knowledge:

  • Basic familiarity with Git and npm.
  • A text editor (e.g., VS Code or Notepad++).
  • Installed Node.js and npm.
  • Access to the Spec-Up-T GitHub repository.

Update​

Updating your Spec-Up-T installation requires the following steps:

1. Run migration script​

Make sure you are in the root directory of your installation, then run the migration script as follows:

npx spec-up-migrate complete --skip-detection
info

Good to know:

npx spec-up-migrate complete --skip-detection
│   │               │        │
│   │               │        └── Option/Flag
│   │               └─────────── Subcommand/Command
│   └─────────────────────────── Package/Tool
└─────────────────────────────── Package runner

2. Manual work: check specs.json and terminology files​

Depending on the installation being converted, the specs.json may need to be updated.

Also, the terminology files may need to be moved. This is manual work.

Compare your specs.json with the boilerplate version. Use the following tool to identify differences. Ensure all entries align with the boilerplate.

npx compare-spec-up-t-specs

See the tools page for more details.

Completion​

Your Spec-Up-T installation is now up to date. If you encounter any issues, refer to the troubleshooting guide or open an issue in the Spec-Up-T GitHub repository.