@faststore/core v3.0.0 Package Updates

This version introduces API extension improvements, error page customization in the Headless CMS, and FastStore v2 users can benefit from Next.js 13 support.

To benefit from the following updates, upgrade your store @faststore/core and @faststore/cli packages to v3.0.0. In your local FastStore project, install the @faststore/core and @faststore/cli up-to-date version by running yarn add @faststore/core@3.0.0 and then yarn add -D @faststore/cli@3.0.0. Run the project locally with yarn dev.

⚠️ We strongly recommend trying this in your local development environment to ensure compatibility with your existing codebase before changing to production.

✨ Improvements to API extension - #2176

@faststore/graphql-utils deprecated in favor of the client-preset plugin, reducing bundle sizes, aligning with community standards, and adopting modern bundling and compilation tools for FastStore API extension users.

To benefit from these improvements, update your store's @faststore/core package to v3.0.0 and follow the Improvements to API extensions guide for more information.

✨ Enhance error page customization in the Headless CMS with new content types and section - #2184

Stores using FastStore v2 now support content customization on the login, 500, and 404 error pages through the EmptyState section via the Headless CMS.

To benefit from the new content types, update your store's @faststore/core package to v3.0.0 and sync the changes:

• To sync the updated version, open a new terminal and run faststore cms-sync.
• Access the VTEX Admin and go to Headless CMS > FastStore. You should be able to see the three new content types listed there.
• Click on one of the content types, and in Add section ( +).
• Choose the EmptyState section and update its fields according to your store's requirements.

✨ FastStore now supports Next.js 13 - #2198

FastStore now supports Next.js 13 which brings general improvements related to performance and stability that stores can leverage from.

Edit your store's package.json :

  "dependencies": {
  ...
    "next": "^13.5.6",
    ...
  },

Refer to the Upgrading from 12 to 13 official Next.js documentation for more information on how to migrate to version 13.

Adds Newsletter component to @faststore/ui package

• Newsletter component are now available in the FastStore UI. Refer to Newsletter documentation for further details.

• Breaking Change: We are deprecating the __experimentalNewsletterAddendum override from Newsletter Section. You should override it using NewsletterAddendum.

Release Notes - August 2022

Gift, OrderSummary, SkuSelector, and CartItem components are now available in the FastStore UI. Also, updates to the FastStore API improve the shopping cart UX and allow adding user's session information to the orderForm.

FastStore UI

Gift

• 🎉 New component - #1443

  Use the Gift component to display promotional gift items.

  

OrderSummary

• 🎉 New component - #1456

  Use the OrderSummary component to provide a summary of the items in the cart, including the total price, related shipping tax, and discounts.

  

SkuSelector

• 🎉 New component - #1462

  Use the SkuSelector component on Product Details Pages (PDPs) to display all SKUs available for a given product.

  

CartItem

• 🎉 New component - #1461

  Use the CartItem component to display summarized data about an item placed in the shopping cart.

  

FastStore API

• 🐛 Fixed "Buy 2 get 3" promotions - #1434

  Cart UX issues related to promotions, such as "Buy 2 get 3," have been fixed. Now, items and gifts are correctly combined when necessary.

  

• ✨ Product releaseDate now available - #1438

  The StoreProduct entity can now return the releaseDate of an item.

• ✨ Session info now available as an argument of validateCart - #1444

  The validateCart mutation now accepts the session argument. This allows adding the user's session information to the orderForm, making the shopping flow consistent between storefront and checkout, and allowing for regionalized prices.

Documentation

• 🎉 New documentation feedback feature - #1448

  

New and improved docs

• FastStore, WebOps & Headless CMS Beta Program - #1446

  • Program overview and timeline - #1446
  • Feedback and issue tracking - #1446
  • Customer invitation - #1446
  • Features and capabilities - #1446
  • Changes from Store Framework - #1446

• Performance Overivew - #1452

  • Getting started with Lighthouse - #1458
  • Analyzing a project's bundle size - #1453
  • Testing the server-side rendering - #1458

• FastStore API

  • Extending the GraphQL schema - #1436 / #1445
  • Using a GraphQL IDE to explore the FastStore API - #1445 / #1428
  • Fetching API data on the storefront - #1445

• Analytics - #1449

  • sendAnalyticsEvent - #1449
  • useAnalyticsEvent - #1449
  • Extending and customizing native types - #1449
  • Sending custom events - #1449
  • Analytics on FastStore - #1449
  • Analytics on official starters - #1449
  • Analytics on Store Framework and FastStore comparison - #1449

• Glossary - #1452

Release Notes - July 2022

The search query has been enhanced to allow cross-selling and upselling of products. Also, the new subscribeToNewsletter mutation is now available in the FastStore API. In the FastStore UI, the Slider and PriceRange components now allow ref forwarding.

FastStore UI

ProductTitle

• 🎉 New component - #1418

  Use the ProductTitle component to display a header with product details, such as its name, reference number, and labels.

  

• ✨ ProductTitle now uses ref forwarding - #1427

  The ProductTitle component allows passing a previously received ref further down to a child.

PriceRange

• ✨ PriceRange now uses ref forwarding for min and max inputs - #1380

  The PriceRange component now accepts receiving refs for both min and max inputs. With the ref forwarding technique, other components using the PriceRange can trigger input functions and control the min and max values of PriceRange.

• ✨ New PriceRange look and feel - #1400

  The PriceRange component now displays the min/max values centered above the Slider's thumbs and allows for more customizations.

• 🐛 PriceRange track position fixed - #1404

  The track position of the PriceRange component has been adjusted for maximum absolute values greater than a hundred.

Slider

• ✨ Slider now uses ref forwarding for min and max inputs - #1380

  The Slider component now accepts receiving refs for both min and max inputs. With the ref forwarding technique, other components using the Slider can trigger input functions and control the min and max values of Slider.

• ✨ New prop added to Slider - #1415

  The Slider component now includes the step prop that allows specifying the interval between the input values.

• 🐛 Slider values are now rounded - #1417
  The Slider component now displays only rounded values.

• 🐛 Slider thumb elements repositioned - #1423

  The Slider thumb elements' have been repositioned in the DOM so they can have customized behavior states.

FastStore API

• 🧹 Generated schema types updated - #1413/#1431

  The generated TS types from the GraphQL schema have been updated.

VTEX Platform

• 🎉 Support for Cross Selling now available - #1396

  The following facets have been added to the existing Search query in order to allow cross-selling and upselling products:

  • buy
  • view
  • similars
  • viewAndBought
  • accessories
  • suggestions

• 🎉 New subscribeToNewsletter mutation available - #1385

  The new subscribeToNewsletter mutation allows stores to save data to their MasterData newsletter list.

• 🎉 New skuSelector-related properties added to ProductGroup - #1407

  The ProductGroup type now includes the skuVariations attribute, which brings with it four new properties:

  • allVariantsByName - Returns all available options for each SKU variant property, indexed by their name.
  • slugsMap - Returns the slug for the SKU that matches the currently selected product variations.
  • activeVariations - Returns the property values for the current SKU.
  • availableVariations - Returns the available options for each varying SKU property, considering the dominantVariantName property.

  These new properties allow users to query data about SKU specification variants more quickly and are especially handy for implementing SKU Selector components.

• 🐛 StoreOffer resolver fixed - #1399

  The priceCurrency field from StoreOffer now grabs the same info from the current context's sales channel and fetches the correct price currency value.

• 🐛 Missing Catalog page types now available - #1411

  The FastStore API now supports the following page types: SubCategory, Collection, Cluster. This should enable stores to render pages that match those types without issues.

• 🐛 Issues related to Collection pages fixed - #1429

  Issues when trying to fetch the StoreCollection.breadcrumbList field for Collection pages have been fixed. Before detecting the page type of a certain route, the slufigyRoot function now checks if the page is a Collection one.

FastStore SDK

• 🧹 Refactored SDKs' code - #1392

  The FastStore SDK package has been refactored in order to remove all React dependencies.

Documentation

🎉 New

Analytics SDK

• Analytics - #1393/#1419
  • How to extend and customize native types - #1393
  • How to send custom events - #1393
  • sendAnalyticsEvent - #1393/#1419
  • useAnalyticsEvent - #1393/#1419
• Troubleshooting Analytics and Partytown - #1397
• Analytics on FastStore - #1405
• Analytics on official starters - #1405

UI

• AggregateRating - #1395

API

• Using GraphiQL to explore the FastStore API - #1390
• Fetching API data on the storefront - #1403

VTEX Headless CMS

• VTEX Headless CMS Widgets - #1401

✨ Improved

• Configuring external DNS for a custom domain - #1406/#1422
• FasStore API overview - #1366
• Extending the GraphQL schema - #1416
• Using GraphiQL to explore the FastStore API - #1428 / #1432

Internal

• 🐛 @faststore/graphql-utils now uses the commonjs module - #1394

• 🧹 Improved Git blame view - #1409

• 🧹 @store-framework removed from CODEOWNERS - #1410

• 🧹 Wrong references to package names fixed - #1414

• 🧹 Auto-generated changelog fixed - #1425

• 🧹 Broken documentation links fixed - #1424/#1430

• 🧹 Changelog configs fixed - #1426

Release Notes - June 2022

The FastStore UI now includes the Hero and Dropdown components. Also, the FastStore API was enhanced to better support page error handling. Global changes were also implemented to enable price range filtering on PLPs.

FastStore UI

Hero

• 🎉 New Hero component - #1336

  The Hero component is a full-width banner presented on the above-the-fold section of a web page. It serves as the first glimpse of your brand's identity and messaging.

  

AggregateRating

• 🎉 New AggregateRating component - #1386

OutOfStock

• ✨ OutOfStock's nested components now accept otherProps - #1341

  The OutOfStockTitle and OutOfStockMessage components now accept additional data attributes through the otherProps attribute.

Slider

• ✨ Slider component enhanced - #1364

  The Slider component now accepts an initial state out of the min/max domain. Also, the onEnd callback function was added to enable triggering effects after user interaction.

FastStore API

VTEX Platform

• 🎉 Request error handling functionality added - #1361

  The FastStore API now returns the proper page error code (400 or 404), allowing FastStore websites to respond to these errors accordingly.

• 🎉 Canonical PDP slugs added - #1338

  So that VTEX stores migrating to FastStore can work seamlessly, a 301 redirect between vtexSlug and fastStoreSlug was created, where:

  • vtexSlug: /{slug}/p
  • fastStoreSlug: ${slug}-${skuId}/p

• ✨ Resolvers and types updated to allow price range filtering on PLPs - #1364

  The search query now receives price. Also, the StoreFacetRange, StoreFacetBoolean, StoreFacetValueRange, and StoreFacetValueBoolean types were created to allow price range filtering on PLPs.

• 🐛 validateCart error for additionalProperties fixed - #1325

  The following error Field "propertyID" is not defined by type IStorePropertyValue., related to products with additionalProperties added to the cart, was fixed.

• 🐛 AggregateOffer resolver fixed for selecting the best seller - #1350

  For SKUs sold by multiple sellers, the AggregateOffer resolver was not able to detect the best seller consistently. This issue was solved by making the AggregateOffer resolver return the lowest and highest prices according to the bestOfferFirst function.

• 🐛 Test inconsistencies fixed - #1360

  Test inconsistencies were resolved to provide a development environment more similar to the production one.

• 🧹 FastStore API mocks updated to use auto fuzzy - #1359

FastStore SDK

• 🎉 Full support to Trade Policies now available - #1319

  The Session context provider now accepts a new function called onValidateSession, which calls the backend to validate the session. On any modification to the channel, such as logging in to the store, the session values (e.g., channel, person, language) are updated accordingly so the user can start browsing on the new session.

• ✨ useSearchState updated to allow price range filtering on PLPs - #1364

  The new setState function was added to the useSearchState context. All other useSearchState functions were removed and exported as helper functions.

Documentation

🎉 New

• Playground
• FastStore API - Overview
  • FastStore API - Get Started
  • Queries
    • product
    • allProducts
    • collection
    • allCollections
    • search
  • Mutations
    • cart
    • session
  • Objects
  • Inputs
  • Enums
  • Scalars
• Troubleshooting FastStore
  • Tracing the error source
• Troubleshooting - VTEX Integration
• Components Overview
  • Hero
  • Dropdown
  • OutOfStock
  • ProductCard

✨ Improved

• Configuring external DNS for a custom domain
• Identifying development errors and Starter bugs
• Card
• Button

Internal

• 🎉 FastStore repository now uses Turborepo cache - #1330

• 🎉 FastStore repository now uses CodeQL analysis - #1331

• ✨ Codesandbox CI improved - #1357

• 🧹 Docs package removed from Codesandbox build - #1334

• 🧹 Circular dependencies removed from FastStore SDK - #1333

• 🧹 Purged unused CSS from the docs package - #1345

• 🧹 Typescript errors fixed - #1352

• 🧹 tsconfig package replaced by shared - #1379

• 🧹 Eslint configs improved - #1368

• 🧹 build script updated - #1362

• 🧹 Prettier configured - #1369

• 🧹 outdir added to all tsconfig - #1372

• 🧹 Packages' module field updated - #1374

FastStore Release Notes - May 2022

FastStore UI

OutOfStock

• 🎉New OutOfStock component - #1314

Use the OutOfStock component to display a subscription form for shoppers who want to be alerted when the product is back in stock.

ProductCard

• 🎉New ProductCard component - #1272

Use the ProductCard component to provide a general view of a product, including images, name, price, discount, and buy button.

FastStore SDK

useStorage

• ✨Updated hook component - #1316

The shopping cart is now persistent across the browser's tabs. Before, if two items were added to the cart through distinct tabs, the last item would always overwrite the prior one.

FastStore API

VTEX Platform

• 🐛 Top searches - #1321

All requests to the FastStore Search API now receive locale info so the search can return product suggestions according to the user locale.

• 🐛 Fixed breadcrumb broken links - #1306

Breadcrumb links that were broken have been fixed, allowing shoppers to navigate the website without getting 404 errors.

• ✨ Support for querying additional properties of a product - #1304

The FastStore API has been enhanced to support querying any additional property of a product.

• ✨ Sync Cart with Checkout - #1299

The behavior of the validateCart resolver has been modified. After placing an order, the cart is now cleared, and any changes made during checkout are reflected in the cart.

• 🐛The Search API now receives selectedFacets component - #1297

Filtering search results according to the user's region has been fixed.

• 🐛Fixed promotion issues - #1289

Promotions such as Buy 2 Get 3 now work correctly.

• 🐛Fixed SKU offer issues - #1282

Product offers related to a specific SKU have been fixed, and now the offers are available only for available SKUs.

• 🐛Fixed in the Serch API - #1273

Suggestions are now working as expected.

Internal

• 🎉Turborepo on FastStore - #1296

The FastStore project now uses Turborepo.

• 📑New guide: Installing Releases on VTEX Headless CMS - #1310

• 📑FastStore API documentation available on GraphiQL - #1305

FastStore API reference documentation is now available. For more information, refer to this announcement.

• 📑Improved the descriptions of FastStore API - #1303

• 🐛Fixed styles and data attributes - #1287

Styles used on the FastStore UI documentation have been updated after the adjustments to the data attributes.

Starters

• 🎉New Community Starters

Check out the new Community Starters, created and maintained by FastStore community members:

• Beauty Store.
• Toy Store.
• Pets Store.

FastStore Release Notes - April 2022

FastStore UI

Banner

• 🐛 otherProps parameter - #1218
  Other props can now be passed on the Banner component.

DropdownMenu

• 🐛 Fix DropdownMenu position - #1199
  The DropdownMenu component no longer has issues with scrolling. Now the component has the properties scrollLeft and scrollTop to calculate the position, and adds event.preventDefault() in KeyDown press event, avoiding page scroll when pressed.

FastStore SDK

Analytics

• 🐛 Fixed URL to events - #1228
  The Analytics SDK types is now compliant with Google Analytics 4 (GA4), which means custom properties can't be added to events directly on the SDK.

lighthouse-config

Performance budget

• 🧹 Increased the performance budget back to 95 - 1201

FastStore API

VTEX Platform

Breaking change

• 💥 Removed Gatsby plugins - 1215
  All unused Gatsby plugins were removed to be more open to other frameworks. The removal of unused Gatsby plugins also improved the speed with which the FastStore monorepo was published and developed.

Before	After

• 💥 Handle channel as facet for search and product queries - 1197
  The channel function is now a string object that contains salesChannel and regionId. Before, channel were a integer that represented a sales channel now it has the following format in store.config.js:

// Default channel
  channel: '{"salesChannel":"1"}',

Enhancement

• ✨ New Search event API - #1241
  The search.query event has been added to the VTEX Intelligent Search Analytics API. This event is used to generate indices like Top Searches and Suggestions.

• ✨ New Intelligent Search API - #1216
  The simulation of search queries has been removed in favor of the new Intelligent Search API, which already performs the simulation.

Bug fix

• 🐛 @faststore/api and VTEX catalog slug mismatches - #1214
  The links between @faststore/api and VTEX Catalog are now fixed.

Chore

• 🧹 Stable tests for the faststore/api - 1200
  The tests from @faststore/api are no longer reliant on dynamic data, which means they won't fail if something changes in the account from which the data is collected.

Documentation

• 📑 Troubleshooting for Creating storefronts with Gatsby - #1261
  Check out the new tutorial for common errors that you might face while working with FastStore.

• 📑 New Other Resources - #1251

• 📑 New: send your feedback about faststore.dev - #1247

• 📑 New Starter: Next.JS - #1240

• 📑 New: Starter submission - #1239
  Submit your starter and get featured on the FastStore Community Starters Library.

• 📑 New Release Notes - Lighthouse reports - #1235

• 📑 New dark mode available in faststore.dev - #1233

• 📑 Updated Extending the schema in FastStore API documentation - #1224

• 📑 New Troubleshooting problems in FastStore - #1219
  Check out the new guide on identifying if the issue you are facing is from FasStore/WebOps or a mistake on your side.

• 📑 New Sending CMS updates to VTEX IO WebOps - #1213
  Check out the new user guide to learn how to set up WebOps to communicate with the VTEX Headless CMS and receive CMS updates via the VTEX Admin.

• 📑 Updated Configuring your VTEX account - #1212
  The vtex.admin-cms@0.x and vtex.admin-cms-graphql-rc@0.x were updated to @1.x. Also, updated the build URL to /build-releases since Releases is now the default option to build and publish on the CMS.

• 📑 New Enabling private CMS previews - #1211
  Check out the new VTEX Headless CMS user guide on how to change public previews to private previews.

• 📑 New Gatsby 4 now available Release Note - #1210
  FastStore infrastructure now allows the use of site generators that support server-side rendering (SSR), such as Next.js and Gatsby 4.

Internal

• 📑 Updated faststore.dev homepage - #1250

• 📑 Updated FAQ page in faststore.dev - #1249

• 📑 Updated announcementBar in faststore.dev - #1237

• 📑 Updated faststore.dev description for SEO - #1230

• 📑 Added faststore.dev thumbnail - #1229

• 📑 Updated docusaurus.config.js with GA4 trackingID - #1226

• 📑 Implemented Google Analytics 4 (GA4) in faststore.dev - #1222

• 📑 Updated Gatsby overview - #1205

FastStore Release Notes - March 2022

FastStore UI

Dropdown

• 🎉 New Dropdown molecule - #1178
  Use the Dropdown component as an options menu or a dropdown select.

FastStore SDK

setSession function

• 🐛 Fixed setSession function type - #1172
  Now the ContextValue of the setSession function receives a session: Partial<Session> argument. With the fix, it's possible to pass partial information of a session. For example:

const { setSession } = useSession()
setSession({ postalCode: 'foo' })

• ✨ Improve the performance of useStorage hook - #1186
  The setTimeout function was created to prevent the creation of tasks that take longer than 50ms to process. The function improves the performance of the useStorage hook by wrapping two of its tasks: the async promise and the set state of an item.

• ✨ Add setFacets function to the search context - #1189
  The setFacets function sets all selected facets without any processing, allowing full control of the selected facets.

FastStore API

VTEX Platform

• 🐛 Added missing totalCount field to pageInfo in allCollections query - #1173
  Now the resolver for the allCollections query returns the number of valid collections in the store when a user asks for pageInfo.totalCount field.

• 🎉 New Session query - #1176
  The Session query returns only the channel and country values. The addition of this query enables VTEX regionalization, which requires the regionId located within the channel.

• 🎉 Add local server and GraphQL tests - #1179
  The @faststore/api package now comes with an Express GraphQL Server setup allowing you to test the API without having to link the package to a store.

• ✨ hideUnavaibleitems parameter in the search API - #1180
  The Search API now has a parameter called hideUnavailableItems. This parameter either hides (true) or displays (false) an out-of-stock product.

• 🐛 Removed frontend computation to the backend - #1184
  Offers are now sorted according to the order of the offers array.

• ✨ Returning null as profile - #1190
  Now the API returns null for the person query when executed by an anonymous user, avoiding a mismatch with the default user session values, preventing the session of the anonymous user from being reset, and lowering the Total Blocking Time (TBT) metric.

Documentation

• 📑 Added VTEX Headless CMS API Reference - #1194
  The vtex.admin-releases@0.x app was added to Step 2 - Installing the Headless CMS app on your VTEX account. The app is one of the VTEX Headless CMS's required apps.

Internal

• 🐛 Fixed codebase typos - #1183

FastStore Release Notes - February 2022

FastStore UI

SearchInput

• ✨ Adjust SearchInput reference - #1153 The SearchInput component now uses imperative code for input behaviors. The useImperativeHandle hook is used to give the component control over the value that is returned by explicitly stating the return value.

FastStore

SDK

• ✨ Stable useStorage hook - #1146
  The useStorage hook is now stable, meaning that if there is no value stored on the persistent storage, the hook won't trigger a re-rendering of the React API. Instead, the useStorage will use the initialValue. This behavior leads to a smaller footprint of the user's device and smaller total blocking time (TBTs).

FastStore API

VTEX Platform

• 🐛 Fix allCollections query pagination and pagetype timeout errors - #1140
  The pagination of allCollections requests and timeouts during pagetype fetching were fixed.

• 🐛 Fix PDP and PLP breadcrumb list item's URL paths - #1148
  Uppercase and spaces in PLP and PDP links used in the breadcrumb component have been fixed.

• ✨ Moves some Filter logic to the API - #1154
  Logic from the Filter component was moved from the frontend to the backend (API) to reduce processing on the frontend. Thus, the VTEX API can now sort the facets values alphabetically. Also, the departamento facet was removed from the PLP page.

• 🐛 Fix StoreProduct returning wrong SKU - #1156
  SKU IDs on accounts in which multiple SKUs are available for each product no longer retur incorrect StoreProduct values.

• 🐛 Fix filter active brands - #1157
  The NotFoundError: Catalog returned FullText for slug: canyon. error no longer occurs for cases where the API returns a list of brands containing inactive brands.

• 🐛 Fix Cart item availability - #1160
  Now, if a product has a limited inventory, the cart component limits the number of products the user can add to it. Also, if the user adds more items, a toast message is raised, warning the user.

gatsby-plugin-nginx

• 🐛 Remove trailing slash from incoming requests - #1145
  Now, headers are properly set when a requested page has an exact match, but the request URL contains a trailing slash.

lighthouse-config

• ✨ Add performance budgets to lighthouse config - #1150
  Now, the Lighthouse report includes a Performance Budgets section.
  A performance budget establishes limits on metrics that influence site performance.

FastStore Release Notes - January 2022

FastStore UI

Incentive

• 🎉 New Incentive atom - #1064 Use the Incentive component to display a trust badge for your store’s website.

Link

• 🎉 New Link atom - #1067 Use the Link component to display a hyperlink as any HTML tag.

Card

• 🎉 New Card organism - #1079 Use the Card component to display summarized information about a product.

QuantitySelector

• 🎉 New QuantitySelector molecule - #1083 Use the QuantitySelector component to allow shoppers to select the quantity of a given product to purchase.

• 🎉 Add missing components. - #1063
  Breadcrumb, LoadingButton, PriceRange, RadioGroup components are now exported by @faststore/ui.

Badge

• ✨ Add ...otherProps to the Badge component - #1085 Other props can now be passed on the Badge component.

Radio

• 🐛 Fix FastStore UI imports - #1069
  The RadioGroup and RadioOption components are now correctly imported in the UI.

Payment Methods

• 🐛 Removing aria-labelledby from payment methods component - #1092
  The PaymentMethods component is no longer returning an accessibility error on FastStore UI.

Accessibility

• 🐛 Fix accessibility issues on FastStore UI components - #1096 The following components are no longer with accessibility issues: Badge, Form, Price, Radio, Select, Textarea, Carousel, IconButton, PriceRange and Table.

AccordionItem

• ✨ Add prefixId attribute to AccordionItem - #1118 The prefixId attribute, avoids the problem of having two Accordio IDs in the same page.

Starters

• ✨ Update Starter Library - #1133 The Starter Library has new Base Store images.

Contributing

• 🎉New issue templates - #1086
  Now you can use the templates to open issues or describe the proposed changes in your pull requests. For more info, refer to our Contribution guide.

FastStore SDK

Analytics

• ✨ Add item generics to analytics events - #1101 With the item property, users can control over a variety of types rather than a single one. This allows users to add extra properties inside an item.

FastStore API

VTEX Platform

• 🎉 Add Sales channel to product query - #1108
  The salesChannel is now available in the product query.
• 🐛 Fix JS files exposure - #1081
  This fix makes the graphql-utils package compatible with other frameworks.
• 🐛 Fix ordering of breadcrumbList - #1094
  The categoryTrees of the Breadcrumb component is now reversed and displaying the right category and subcategories in the store.
• 🐛 Fix SKU loader - #1100
  The SKU dataLoader algorithm is now fixed and can avoid potential errors, such as the Could not find SKU for product message.
• 🐛 Fix Breadcrumb data on collection pages - #1104
  Breadcrumb lists no longer return empty, now the catalog data fills the Breadcrumb information.
• 🐛 Fix redirect to external pages - #1114
  The redirect.csv file now allows redirecting to an external page.
• 🐛 Fix unfiltered allCollections query - #1131
  The collection query no longer opens to many requests to fetch categories, brands, and landing pages, since the collection field resolver respects the first and after parameters to not open to many requests.

VTEX Headless CMS

• ✨ fetch content by ID using REST API from CMS for preview - #1120 Now the gatsby-plugin-cms receives webhookBody params, fetch the values on the CMS API and return it to preview on webOps.

Documentation

• 📑New SDK Search reference - #1065
  Check out the new Search SDK module documentation and learn how to increase product discoverability by implementing a faceted search in your store.

• 📑Updated the Quickstart documentation - #1066 Now you configure your FastStore project settings in the store.config.js file, an easy way to set up the repo without creating environment variables.

• 📑New FasStore FAQ - #1068
  Check out the Frequently Asked Questions on FastStore Portal.

• 📑New Starters Library - #1065
  Check out the new Starter Library and quickly start your FastStore website with the templates.

• 📑New SDK Cart documentation - #1095
  Check out the new SDK Card documentation and start managing your store’s shopping cart.

• 📑New VTEX IO WebOps Secrets guides - #1105
  Check out the new Security documentation and learn how to use the Secrets API. Use it to hold confidential data and avoid exposing sensitive data in your FastStore code..

• 📑New VTEX Headless CMS documentation - #1111 Check out the new track for VTEX Headless CMS and learn how to integrate your FastStore project with VTEX Headless CMS, our preferred solution for content management.

• 📑New Migrating from gatsby-plugin-cms to gatsby-source-cms guide - #1126
  Check out the new Migrating from gatsby-plugin-cms to gatsby-source-cms guide and learn how to migrate to the newer gatsby-source-cms plugin that uses a dedicated API to fetch the content from the VTEX Headless CMS. Also it lets you use the Gatsby Preview Server to build and preview your pages before publishing them.

• 📑New on VTEX Platform integration - Hosting a FastStore + VTEX website - #1129
  Check out the new Hosting a FastStore + VTEX website guide and learn how to integrate your FastStore storefront project with VTEX, how to make it publicly available to end-users and have the VTEX Checkout functioning in your store.

• 📑New on VTEX Platform integration - Integrating VTEX login - #1132
  Check out the new Integrating VTEX login guide and learn how to integrate the VTEX Login with your FastStore project.

Internal

• ✨ Auto generate reference documentation for FastStore UI comoponents with react-docgen-typescript plugin - #1070

• 🎉 Send feedback for any documentation available on FastStore Portal. - #1097
  To submit the feedback, look for Was this page helpful? at the end of any documentation on the Portal.