Extend Headless Turbo with Headless APIs
Headless Turbo already follows a headless architecture. The React storefront runs independently of the Fynd Theme Engine, while Fynd Commerce provides catalog, pricing, cart, checkout, customer, and order capabilities through APIs.
Understand the Request Flow
Headless Turbo uses GraphQL through @gofynd/fdk-store-gql. Browser requests to /service, /ext, and /graphql are sent through the same-origin Fastify or edge proxy before reaching Fynd Commerce.
The proxy:
- Routes requests to the configured Fynd API origin
- Injects the sales channel application credentials at runtime
- Preserves storefront cookies
- Applies security headers and CSRF validation
- Avoids exposing privileged server credentials
Review Headless Turbo Architecture for the complete development and production request flows.
Use Fynd Commerce APIs
Use the existing GraphQL client and query patterns when extending pages, sections, or components. Keep GraphQL definitions with the other storefront queries and reuse FPI actions where the required commerce workflow already exists.
Use REST APIs or SDK clients when GraphQL does not provide the required capability. Refer to Headless Commerce Overview for more details.