Skip to main content

Understand Headless Turbo Theme

Headless Turbo theme is Fynd's reference implementation for independently hosted headless storefronts. It is based on Turbo Theme, built with React 18, and retrieves commerce data from Fynd Commerce using GraphQL through @gofynd/fdk-store-gql.

Developers use the same core storefront model in the Headless Turbo theme:

  • React pages, sections, and shared components
  • Fynd Platform Interface (FPI) and GraphQL queries
  • LESS and CSS styling
  • Page layouts, providers, helpers, and locale resources
  • Existing Theme Development and Theme Best Practices

Understand What Changes​

The Headless Turbo theme replaces the Fynd-managed theme runtime with an application runtime owned by you:

  • Fastify serves the storefront and proxies Fynd API requests.
  • Webpack builds the React application.
  • Environment variables bind the storefront to a Fynd sales channel.
  • Local files replace Theme Editor configuration.
  • Your deployment platform handles builds, domains, TLS, logs, monitoring, and rollback.

The repository includes documented deployment approaches for serverless hosting. Other platforms need an adapter that provides the same static asset, SPA fallback, runtime credential injection, and API proxy behavior.

Choose Headless Turbo Theme​

Use the Headless Turbo theme when you need:

  • Independent hosting and CI/CD
  • Control over runtime behavior and infrastructure
  • Edge, container, or custom cloud deployment
  • Code-driven storefront configuration

Use a Fynd-hosted theme when you need Theme Editor customization, Fynd-managed delivery, or Partners Marketplace distribution.

Further Reading​