Skip to main content


Learn how we help you build future-proof ecommerce websites with the VTEX IO WebOps CI pipeline and Faststore library.

How to build an ecommerce store

Modern digital commerce requires composable pieces of Packaged Business Capabilities (PBC) to create unique experiences. For example, an ecommerce site may want to use Algolia as their search engine, VTEX for checkout, Bazaarvoice for reviews, and other specific modules to satisfy particular business needs.

That means companies now have an open ecosystem with data coming from various sources. In this sense, an API gateway that adapts the incoming data for the frontend might be necessary.

Once this gateway is set up, it is necessary to determine which technology you'll use for your store frontend. Independently from this choice, a frontend server that consumes the API gateway will always be required. Notice that, to present the dynamic data of your ecommerce (e.g., price, number of available items), you'll also need to handle Server-Side Rendering (SSR), which will also consume the API gateway. Hence, you'll end up with the following:

That's enough for the basics. However, to keep evolving an ecommerce, you'll need new deployments. Here is where we have a Control Plane - the part of the architecture that compiles and handles which version of the store is online.

How we help you

To allow a technology-agnostic backend, we simply established that our Frontend Server is the CDN itself. Just like that, we permit the indirect communication between the frontend and the API gateway via a more powerful Control Plane, which becomes responsible for serving the CDN with the appropriate assets. In summary, the Control Plane is composed of two main parts:

  • A Static Site Generator (SSG): a tool that generates static HTML pages from templates and raw data at build-time instead of real-time. There are plenty of SSGs available in the market (e.g., Gatsby, Next.js, Hugo), and you are free to choose the one you prefer.
  • A Jamstack CDN Provider: a CI pipeline focused on stability and performance for the web. There are also plenty of CDN providers, like Netlify, Gatsby Cloud, Vercel and WebOps.

This explains the autonomy we give developers to choose their favorite tech stack. Since the Frontend Server is not directly tied to the API gateway, even using React becomes optional.


We understand, however, that freedom can be scary sometimes. That's why, to help you build your store frontend, we deliver the FastStore - a set of libraries that supports integrations with headless ecommerce platforms, provides ecommerce-focused React components and GA4 compatible analytics functions.

Our architecture also gives developers full power over the API Gateway. This layer is built with a Node.js server. In practice, this means that, as a technology-agnostic solution, you can choose your own communication protocol - GraphQL is no longer obligatory. Notice that here you are single-tenant, i.e., you have your own independent server instance.

With so much creativity and freedom space, what we offer is a safe environment for experimenting. By connecting with a Git provider, it's possible to create a team of QA robots that run E2E tests, evaluate code quality, and measure the impact of each Pull Request on a store's performance. Don't forget: performance implies an increase in the store's SEO score, conversion rate, and navigation experience!


FastStore is supported right out of the box at WebOps. Use their QA bots to analyze performance, avoid regressions and detect code smells before even deploying anything to production

Didn't find your answers? Ask the Community. For documentation suggestions, submit your feedback.