Spectral 9.x Upgrade Guide

Spectral 9.x upgrades to TypeScript 5, which introduces several breaking changes. While the Spectral component APIs remain backwards-compatible with Spectral 8.x, you'll need to update your custom component's TypeScript to version 5 or later.

For current code-native projects, install components from npm and use the latest Spectral SDK.

When upgrading code-native flows from Spectral 8, remove the config-page generic: change flow<typeof configPages>() to flow(). Keep the scaffold's .spectral/index.ts and named configuration exports so the SDK can infer configuration types.

If you need the original component-reference syntax for a project that remains on Spectral 9, see the historical Spectral 9 instructions.