Releases: vtex/faststore
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 - #1427The
ProductTitle
component allows passing a previously received ref further down to a child.
PriceRange
-
β¨
PriceRange
now uses ref forwarding for min and max inputs - #1380The
PriceRange
component now accepts receiving refs for both min and max inputs. With the ref forwarding technique, other components using thePriceRange
can trigger input functions and control the min and max values ofPriceRange
. -
β¨ New
PriceRange
look and feel - #1400The
PriceRange
component now displays the min/max values centered above theSlider
's thumbs and allows for more customizations. -
π
PriceRange
track position fixed - #1404The 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 - #1380The
Slider
component now accepts receiving refs for both min and max inputs. With the ref forwarding technique, other components using theSlider
can trigger input functions and control the min and max values ofSlider
. -
β¨ New prop added to
Slider
- #1415The
Slider
component now includes thestep
prop that allows specifying the interval between the input values. -
π
Slider
values are now rounded - #1417
TheSlider
component now displays only rounded values. -
π
Slider
thumb elements repositioned - #1423The
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 - #1385The new
subscribeToNewsletter
mutation allows stores to save data to their MasterData newsletter list. -
π New
skuSelector
-related properties added toProductGroup
- #1407The
ProductGroup
type now includes theskuVariations
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 thedominantVariantName
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 - #1399The
priceCurrency
field fromStoreOffer
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, theslufigyRoot
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
- Troubleshooting Analytics and Partytown - #1397
- Analytics on FastStore - #1405
- Analytics on official starters - #1405
UI
API
VTEX Headless CMS
β¨ 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
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 - #1336The
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 acceptotherProps
- #1341The
OutOfStockTitle
andOutOfStockMessage
components now accept additional data attributes through theotherProps
attribute.
Slider
-
β¨ Slider component enhanced - #1364
The
Slider
component now accepts an initial state out of the min/max domain. Also, theonEnd
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
or404
), 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
andfastStoreSlug
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 receivesprice
. Also, theStoreFacetRange
,StoreFacetBoolean
,StoreFacetValueRange
, andStoreFacetValueBoolean
types were created to allow price range filtering on PLPs. -
π
validateCart
error foradditionalProperties
fixed - #1325The following error
Field "propertyID" is not defined by type IStorePropertyValue.
, related to products withadditionalProperties
added to the cart, was fixed. -
π
AggregateOffer
resolver fixed for selecting the best seller - #1350For SKUs sold by multiple sellers, the
AggregateOffer
resolver was not able to detect the best seller consistently. This issue was solved by making theAggregateOffer
resolver return the lowest and highest prices according to thebestOfferFirst
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 calledonValidateSession
, 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 - #1364The new
setState
function was added to theuseSearchState
context. All otheruseSearchState
functions were removed and exported as helper functions.
Documentation
π New
- Playground
- FastStore API - Overview
- Troubleshooting FastStore
- Troubleshooting - VTEX Integration
- Components Overview
β¨ 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 byshared
- #1379 -
π§Ή Eslint configs improved - #1368
-
π§Ή
build
script updated - #1362 -
π§Ή Prettier configured - #1369
-
π§Ή
outdir
added to alltsconfig
- #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.
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:
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
TheDropdownMenu
component no longer has issues with scrolling. Now the component has the propertiesscrollLeft
andscrollTop
to calculate the position, and addsevent.preventDefault()
inKeyDown
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
Thechannel
function is now a string object that containssalesChannel
andregionId
. Before,channel
were a integer that represented a sales channel now it has the following format instore.config.js
:
// Default channel
channel: '{"salesChannel":"1"}',
Enhancement
-
β¨ New Search event API - #1241
Thesearch.query
event has been added to the VTEX Intelligent Search Analytics API. This event is used to generate indices likeTop Searches
andSuggestions
. -
β¨ 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
Thevtex.admin-cms@0.x
andvtex.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
infaststore.dev
- #1237 -
π Updated faststore.dev description for SEO - #1230
-
π Added faststore.dev thumbnail - #1229
-
π Updated
docusaurus.config.js
with GA4trackingID
- #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 theDropdown
component as an options menu or a dropdown select.
FastStore SDK
setSession function
- π Fixed
setSession
function type - #1172
Now theContextValue
of thesetSession
function receives asession: 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
ThesetTimeout
function was created to prevent the creation of tasks that take longer than 50ms to process. The function improves the performance of theuseStorage
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
ThesetFacets
function sets all selected facets without any processing, allowing full control of the selected facets.
FastStore API
VTEX Platform
-
π Added missing
totalCount
field topageInfo
inallCollections
query - #1173
Now the resolver for theallCollections
query returns the number of valid collections in the store when a user asks forpageInfo.totalCount
field. -
π New
Session
query - #1176
TheSession
query returns only the channel and country values. The addition of this query enables VTEX regionalization, which requires theregionId
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 calledhideUnavailableItems
. 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 theoffers
array. -
β¨ Returning null as profile - #1190
Now the API returnsnull
for theperson
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
Thevtex.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 TheSearchInput
component now uses imperative code for input behaviors. TheuseImperativeHandle
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
TheuseStorage
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, theuseStorage
will use theinitialValue
. 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 ofallCollections
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 theFilter
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, thedepartamento
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 incorrectStoreProduct
values. -
π Fix filter active brands - #1157
TheNotFoundError: 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
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 theBadge
component - #1085 Other props can now be passed on the Badge component.
Radio
- π Fix FastStore UI imports - #1069
TheRadioGroup
andRadioOption
components are now correctly imported in the UI.
Payment Methods
- π Removing aria-labelledby from payment methods component - #1092
ThePaymentMethods
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
andTable
.
AccordionItem
- β¨ Add
prefixId
attribute to AccordionItem - #1118 TheprefixId
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 theitem
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
ThesalesChannel
is now available in the product query. - π Fix JS files exposure - #1081
This fix makes thegraphql-utils
package compatible with other frameworks. - π Fix ordering of breadcrumbList - #1094
ThecategoryTrees
of the Breadcrumb component is now reversed and displaying the right category and subcategories in the store. - π Fix SKU loader - #1100
The SKUdataLoader
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
Theredirect.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
receiveswebhookBody
params, fetch the values on the CMS API and return it to preview on webOps.
Documentation
-
πNew SDK Search reference - #1065
Check out the newSearch
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 newergatsby-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.
FastStore Release Notes - December 2021
General
-
π New FastStore Documentation Portal. - #1061
The first iteration of the FastStore Documentation Portal is now available at https://faststore.dev. Send feedback and open documentation requests via GitHub issues. Bear in mind that this is still a work in progress.
FastStore UI
Label
-
π New Label component. - #1001
Use theLabel
component to identify text fields, checkboxes, radio buttons, and drop-down menus.-20%
Show code
<Label>-20%</Label>
Alert
-
π New Alert component. - #1020
Use theAlert
component to display short messages related to the behavior of a system, feature, or page.Show code
function Component() { const styles = { warning: { backgroundColor: '#fff2d4', color: "#eea236", borderRadius: "0.5rem", padding: "1rem" }, } return ( <Alert style={styles.warning}> <React.Fragment key=".0"> <Icon component={<Warning />} /> <span> This is an example of how you can use the Alert component along with icons! </span> </React.Fragment> </Alert> ) }
PaymentMethods
-
π New
PaymentMethods
component. - #1020
Use thePaymentMethods
component to display the logos of the available payment options in a store.Show code
function Component() { const VisaCard = () => ( <img alt= "Visa logo" width = { 50} height = { 50} src = "https://upload.wikimedia.org/wikipedia/commons/thumb/5/5e/Visa_Inc._logo.svg/2560px-Visa_Inc._logo.svg.png" /> ) const MasterCard = () => ( <img alt= "Mastercard logo" width = { 50} height = { 50} src = "https://upload.wikimedia.org/wikipedia/commons/thumb/2/2a/Mastercard-logo.svg/1544px-Mastercard-logo.svg.png" /> ) const AmericanExpressCard = () => ( <img alt= "American express logo" width = { 50} height = { 50} src = "https://upload.wikimedia.org/wikipedia/commons/thumb/f/fa/American_Express_logo_%282018%29.svg/1200px-American_Express_logo_%282018%29.svg.png" /> ) const MaestroCard = () => ( <img alt= "Maestro logo" width = { 50} height = { 50} src = "https://upload.wikimedia.org/wikipedia/commons/4/4d/Maestro_logo.png" /> ) const EloCard = () => ( <img alt= "Elo logo" width = { 50} height = { 50} src = "https://upload.wikimedia.org/wikipedia/commons/thumb/d/da/Elo_card_association_logo_-_black_text.svg/1024px-Elo_card_association_logo_-_black_text.svg.png" /> ) const HiperCard = () => ( <img alt= "Hipercard logo" width = { 50} height = { 50} src = "https://upload.wikimedia.org/wikipedia/commons/thumb/8/89/Hipercard_logo.svg/2000px-Hipercard_logo.svg.png" /> ) const PayPal = () => ( <img alt= "PayPal brand" width = { 50} height = { 50} src = "https://upload.wikimedia.org/wikipedia/commons/thumb/3/39/PayPal_logo.svg/2560px-PayPal_logo.svg.png" /> ) const DinersClub = () => ( <img alt= "Diners club logo" width = { 50} height = { 50} src = "https://upload.wikimedia.org/wikipedia/commons/a/a6/Diners_Club_Logo3.svg" /> ) return ( <PaymentMethods title= "Payment Methods" > <VisaCard /> <MasterCard /> <MaestroCard /> <AmericanExpressCard /> <HiperCard /> <EloCard /> <DinersClub /> <PayPal /> </PaymentMethods> ) }
RadioGroup
-
π New
RadioGroup
component. - #1033
Use theRadioGroup
component to allow users to select a single option from a list of two or more mutually exclusive options.Show code
function Component () { const [option, setOption] = useState('radio-1') return ( <RadioGroup name="radio-group" selectedValue={option} onChange={(v) => setOption(v.currentTarget.value)} > <RadioOption value="radio-1" label="Radio 1"> <span>Radio 1</span> </RadioOption> <RadioOption value="radio-2" label="Radio 2"> <span>Radio 2</span> </RadioOption> </RadioGroup> ) }
Contributing
-
β¨ Improved FastStore UI Storybook with web accessibility checks for components. - #1036
FastStore UI Storybook now has a new tab called
Accessibility
that helps developers test components' compliance with web accessibility standards. -
β¨ Enhanced process to create components in the FastStore UI. - #1039
If you are developing new components for the FastStore UI, just run
yarn generate-ui-component
in the FastStore project, give a name to your component and answer which component type you are developing to automatically create all the basic files your component will need.For more information, please refer to our Contribution guide.
FastStore API
VTEX Platform
FastStore Release Notes - November 2021
Features π
- New component: Accordion molecule (#985)
We have added the Accordion component to the FastStore UI. The Accordion component hides its content by default.
- New component: Breadcrumb molecule (#986)
We have added the Breadcrumb Molecule to the FastStore UI. Use it to create secondary navigation and help users identify their location in the store.
- New component: Table molecule (#987)
We have added the Table molecule to the FastStore UI.
Bug fixes π
-
Browser support (#984)
FastStore 0.x now supports older browsers versions. -
Search Input Accessibility issues (#1000)
We have addedaria-labels
to the input field and button of the Search Input component to solve accessibility issues.
Improvements βοΈ
-
Add a11y tests for all atoms (#988)
We have added accessibility tests for atoms of FastStore UI -
Add a11y tests for all molecules (#992)
We have added accessibility tests for molecules of FastStore UI. -
Accordion doc (#994)
We have improved the Storybook doc to show more information about the components that compose the Accordion.
Breaking Changes π₯
- Lighthouse CI updated: Changes on performance score and Lighthouse report
We have updated the Lighthouse CI to the version 8 of Google Lighthouse that can reflect on score variations in Lighthouse CI of Pull Requests.
From now on, the overall score of Cumulative Shift Layout
and Total Blocking Time
have increased in importance, and the deprioritized metrics are First Contentful Paint
, Speed Index
, and Time to Interactive
.
FastStore Release Notes - October 2021
Features
-
π Send and receive custom events via the Analytics module #937
We've added the
UknownEvent
event type to the Analytics module. This is a minimal event sent via thesendAnalyticsEvent
function, which can be overwritten by other event types, such as pre-purchase interactions.- Check out the details on how to manage analytics events in the Analytics module documentation and the Google Analytics 4 (GA4) data model.
-
π Source store plugin #944
We've added the plugin
gatsby-source-store
to source products and collections into the Gatsby's GraphQL layer. This plugin replaces thegatsby-source-vtex
plugin and works with the store-api GraphQL schema.- Learn how to install and use the
gatsby-source-store
plugin here.
- Learn how to install and use the
-
π Modal Molecule #957
Use the Modal Molecule to create alert windows in your storefront.
-
π GraphQL Code Generator #960
We've added the GraphQL Code Generator CLI to automatically generate TypeScript typings for
store-api
. -
π Spinner atom #961
Now, you can use the Spinner atom as a loading button component.
-
π Cart component with state validation #963
We modified the Cart APIs to provide a cart with state validation. The browser now has its cart state, which is validated by the backend. The backend signalizes if the frontend should be modified or not. For example, if the browser's state is not valid, containing a product currently unavailable at your store, the backend will send the updated cart state to the frontend.
-
π Storybook theme #979
Besides adding a new logo and theme to the Store UI Storybook, we also synced the FastStore CHANGELOG.md with the Storybook Changelog.