Documentation
Feedback
Guides
Storefront Development

Storefront Development
FastStore
FastStore WebOps - Dashboard
Once you have created your FastStore project or are already working on customizing it, you can use the WebOps Dashboard to have an overview of your website’s deployments and performance.
The WebOps Dashboard provides a comprehensive overview of website builds and deploy previews and offers suggestions on how to improve your storefront's performance based on Lighthouse scores.
{"base64":"  ","img":{"width":1303,"height":836,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":193459,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@EDU-14723-faststore-dashboard/images/dashboard-overview.png"}}
To access the WebOps Dashboard, go to Storefront > FastStore WebOps in the VTEX Admin. The Dashboard has four tabs: Overview, Deploys, Integrations, and Settings.

Overview

The Overview tab provides a quick snapshot of your website's key details, including the live store URL, CMS information, and latest deploy.

Production Overview

The Production Overview section provides the following information about the latest deploy of your live store:
FieldDescription
Live StoreURL for your production environment, accessible to shoppers.
RepositoryGitHub repository associated with the project.
SourceCommit for the current deployment, including the date, time, and who made it.
CMS ProviderLink to Headless CMS.
CMS ProjectLink to the FastStore project in Headless CMS.

Live deployment statuses

This section also displays the status of the live deployment:
  • Success: The commit was deployed to the production environment and is live.
  • Queued: The commit is next in line to be deployed.
  • In progress: The commit is currently being deployed.
  • Failed: The deployment failed. Further details can be found by clicking the link below the Deploy button.

Lighthouse Scores

When your store goes live (in production), ensuring optimal performance and a good user experience becomes crucial. The Lighthouse Scores section offers insights into four key areas measured by Lighthouse, helping you understand their impact on your store's performance.
  • Performance: Indicates how fast your pages load.
  • Accessibility: Reflects how usable your pages are for people with disabilities.
  • Best practices: Indicates how well your pages adhere to coding best practices.
  • SEO: Reflects how well your pages are optimized for search engines.
These scores are based on the pages defined for testing in the Integrations tab.

Production Deploys

This section lists the recent deploys to your production store. Each item on the list is composed of the following:
{"base64":"  ","img":{"width":644,"height":247,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":19619,"url":"https://vtexhelp.vtexassets.com/assets/docs/src/dashboard-production-deploys___840fcb7b30bc2c7a1e4e5d1d255a58f9.png"}}
For a complete list of all store deployments and details about them, see the Deploys tab.

Preview Deploys

This section lists all the deploy previews created for GitHub branches in your project repository. These previews are automatically available for each pull request opened for a corresponding branch.

Deploys

The Deploys tab provides insights into your store's deployments, including their status (success, failed, etc.). The table below summarizes the key features of the Deploys page.
{"base64":"  ","img":{"width":1401,"height":745,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":253908,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@EDU-14723-faststore-dashboard/images/deploys-webops.png"}}
FeatureDescription
1 - Search barSearches by deploy ID, commit, message, or author.
2 - PaginationNavigates through pages of deployment data.
3 - EnviromentFilters deployments by environment:
  1. Production: The live store where customers can interact with.
  2. Preview: Test environment for new features, design changes, and code modifications before releasing them to production.
4 - BranchFilters deployments by GitHub branches.
5 - StatusFilters deploy status:
  1. Queued: The deployment is the next in line to be executed.
  2. In progress: The deployment is underway.
  3. Success: The deployment has completed successfully.
  4. Failed: The deployment process encountered an error and did not complete as expected.
6 - Sort byFilters deployments by Latest first or Oldest First.
7 - Deployments tableLists each store deployment with the following information:
  1. Score: Lighthouse score for the deployment.
  2. Source: Commit ID and branch.
  3. Author: Deploy author and the date and time of the deployment.
  4. Environment: The environment which received the changes, Production or Preview.
  5. Deploy ID: The ID of the specific deployment.
  6. Status: The deploy status.

Deployment details

For more information, click any entry in the deploy table.
{"base64":"  ","img":{"width":1401,"height":745,"type":"gif","mime":"image/gif","wUnits":"px","hUnits":"px","length":1206808,"url":"https://vtexhelp.vtexassets.com/assets/docs/src/deployment-details___011bb7391157ad21eb965d8bcfc75b03.gif"}}
In the Deploy Steps section, select a step (example: Build - Discovery) to view logs. These logs appear on the right and help diagnose failed deployments.

Integrations

The Integrations tab allows you to configure store pages for Lighthouse Tests. Here, you can specify the URLs for a product listing page (PLP) and a product details page (PDP) to undergo automatic Lighthouse score testing during deployments, ensuring a consistent testing experience.
{"base64":"  ","img":{"width":679,"height":495,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":38754,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@EDU-14723-faststore-dashboard/images/integrations-webops.png"}}

Configuring pages for Lighthouse testing

To set the pages you want to test with Lighthouse, follow these steps:
  1. In the Path for a PLP field, enter the category slug defined in the Catalog.
  2. In the Path for a PDP field, enter the slug for the specific product detail page (PDP) you want to test.
  3. Click Save.
Once you've set the pages for testing and after a new deployment, go to the Overview tab and access the Lighthouse Scores section to check the scores for those pages.

Settings

The Settings tab is where you configure your store’s production domain as part of the go-live process. Here, you can add your primary production domain to ensure it's properly set up for customer access. Before adding the domain, make sure the external DNS settings are correctly configured in your VTEX Account Settings.
This feature also supports multiple domains, allowing you to configure and enable each domain individually in the corresponding subaccount.
To learn more about domain configuration, including rules for main hosts, see the guide Configuring the store domain.
WebOps domain configuration always takes priority over any settings in discovery.config.js file. It’s recommended that you manage all domain configurations through WebOps to centralize all domain settings into a single source.
{"base64":"  ","img":{"width":700,"height":612,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":44985,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@EDU-14723-faststore-dashboard/images/settings-webops.png"}}

Production domain

In the Production domain section, choose your store’s domain from the dropdown list within the Host field and then click Add to set up the primary domain of your store.
After adding your domain to WebOps, a new deployment will be triggered automatically. You can monitor the deployment's progress in the Deploy tab until it's fully completed and has the status Success. If the domain setting is incorrect, the deployment will receive the status Failed, and you can check the build logs by following the instructions in Deployment details.

Current Domains

The Current Domains section displays the default and primary domains that have been configured for your store. This section serves as a reference point to ensure that your domains are correctly set up in WebOps. By checking this list, you can confirm whether your domains have been successfully added and are ready for use in the FastStore environment.
If your domain is not listed, it may indicate an issue with the configuration or DNS settings that need to be addressed before proceeding with the go-live process.
To remove a domain that is no longer needed, click the trash icon alongside the current domain you want to remove.
{"base64":"  ","img":{"width":633,"height":259,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":17138,"url":"https://vtexhelp.vtexassets.com/assets/docs/src/current-domain___9ff9bcec03f19dd420f8802accd885e4.png"}}

Deleting the project

To delete your FastStore project, click the More actions menu (). Then, click Delete Project.
A modal to confirm your choice will open.
Proceed with caution. Deleting the project is irreversible and will permanently remove all deployments and domains associated with it.
Contributors
2
Photo of the contributor
Photo of the contributor
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Contributors
2
Photo of the contributor
Photo of the contributor
On this page