Documentation
Feedback
Guides
Storefront Development

Storefront Development
FastStore
FastStore versions and support levels
FastStore has two main versions: FastStore v1 and FastStore v2+. This document presents 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 is 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 includes all versions starting from v2 and introduces significant 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: Continuous performance monitoring, with proactive measures to prevent deployments that fail to meet Lighthouse and quality standards.
  • Semantic versioning: FastStore v2+ uses Semantic Versioning to manage releases:
    • Majors: Introduce breaking changes, including incompatible API changes.
    • 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 nameFastStore v1FastStore v2FastStore v3
api
cli
components
core
graphql-utils
lighthouse
sdk
styles
ui

Other aspects

AspectFastStore v1FastStore v2FastStore v3
DocumentationFastStore v1 PortalDevelopers PortalDevelopers Portal
Project onboardingCloning the FastStore starter repository.Onboarding appWebOps
Development frameworkGatsby / Next.jsNext.jsNext.js

Support levels

Different levels of support are available depending on the FastStore version. The following table details the status, support availability, support availability, and recommendations for new projects for each version.
CriteriaFastStore v1FastStore v2+
StatusNo longer updated.Actively maintained.
SupportLimited support. Only bugs and vulnerabilities related to public VTEX APIs are addressed.Full support.
New ProjectsNot 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, consult VTEX to ensure compatibility and a smooth transition. For assistance, open a ticket with the VTEX Support team.
Contributors
1
Photo of the contributor
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Contributors
1
Photo of the contributor
On this page