FastStore versions and support levels
FastStore has two main versions: FastStore v1 and FastStore v2+. This document outlines the key differences between these versions, their support levels, and guidelines for upgrading.
FastStore v1
FastStore v1 was the first version of the framework. While it served as the foundation for FastStore, it's no longer actively maintained. New projects must use the latest version of FastStore.
FastStore v2+
FastStore v2+ is the latest and most advanced version of the storefront solution. It encompasses all versions starting from v2 and introduces major improvements over FastStore v1, such as:
- Simplified updates: Stores are monitored for version updates with minimal friction, including automatic non-critical updates and a more efficient integration process.
- Separation of VTEX-managed code and store customizations: Clear segmentation between VTEX and custom code to help in the debug process.
- CMS-first approach: Headless CMS manages content updates (texts, images, links) while behavioral and UI component changes remain code-based, ensuring a structured workflow.
- Optimized performance and quality monitoring: Ongoing performance tracking with proactive safeguards to prevent deployments that don’t meet Lighthouse and quality standards.
- Semantic versioning: FastStore v2+ uses Semantic Versioning for managing releases:
- Majors: Introduce breaking changes, including incompatible API updates.
- Minors: Introduce backward-compatible features.
- Patches: Include backward-compatible bug fixes.
Key differences between FastStore versions
One of the main changes from FastStore v1 to FastStore v2+ is the separation between VTEX code and store-specific customizations. This separation introduced the
core package for VTEX code and reserved the /src folder for store-specific customizations. Below are the key differences between the versions:Packages
| Package name | FastStore v1 | FastStore v2 | FastStore v3 |
|---|---|---|---|
api | ✅ | ✅ | ✅ |
cli | ✅ | ✅ | ✅ |
components | ✅ | ✅ | ✅ |
core | ❌ | ✅ | ✅ |
graphql-utils | ✅ | ✅ | ✅ |
lighthouse | ✅ | ✅ | ✅ |
sdk | ✅ | ✅ | ✅ |
styles | ✅ | ❌ | ❌ |
ui | ✅ | ✅ | ✅ |
Other aspects
| Aspect | FastStore v1 | FastStore v2 | FastStore v3 |
|---|---|---|---|
| Documentation | FastStore v1 Portal | Developers Portal | Developers Portal |
| Project onboarding | Cloning the FastStore starter repository. | Onboarding app | WebOps |
| Development framework | Gatsby / Next.js | Next.js | Next.js |
Support levels
Different levels of support are available depending on the FastStore version. The following table details the status, support availability, and recommendations for each version of new projects.
| Criteria | FastStore v1 | FastStore v2+ |
|---|---|---|
| Status | No longer updated. | Actively maintained. |
| Support | Limited support. Only bugs and vulnerabilities related to public VTEX APIs are addressed. | Full support. |
| New Projects | Not supported. Only FastStore v2+ is available for new projects. | Recommended for all new storefront implementations. |
If you have any questions about the level of support provided for different FastStore versions, open a ticket with the VTEX Support team.
Upgrade between FastStore versions
Before upgrading to a new FastStore version, contact VTEX to ensure compatibility and a smooth transition. For assistance, open a ticket with the VTEX Support team.