Upgrade Guides

Step-by-step guides for migrating between Velocity releases. Each guide covers dependency changes, breaking API updates, and verification steps.

Available Guides

Beta to v1.0.0 Stable

All packages to stable: Astro 6.0.0, MDX 5.0.0, React 5.0.0. No code changes needed. Read the guide →

v0.4.x-beta to v0.4.5-beta

Cookie consent manager, Google Consent Mode v2, security header cleanup. Read the guide →

v0.3.x-beta to v0.4.0-beta

Astro beta.11, Sharp replaces resvg, Vite config simplified. Read the guide →

v0.2.0-beta to v0.3.0-beta

CVA variant system, subcategory folders, barrel exports, 12 new components. Read the guide →

v0.1.0-beta to v0.2.0-beta

Astro 6 beta.9, pnpm, Zod 4 via astro/zod, native SEO, astro:env, and CSP. Read the guide →

Naming Convention

Upgrade guides are named after Velocity versions, not the underlying Astro versions. For example, the guide for moving from v0.1.0-beta to v0.2.0-beta is beta-1-to-beta-2.mdx.

Next Steps

Changelog — Full version history
Quick Start — Setting up a new project