---
title: "Bridge theme"
description: "A future Liquid companion for Shopify-native theme app blocks that cannot render headlessly."
canonical_url: "https://nyxel.dev/docs/bridge"
markdown_url: "https://nyxel.dev/docs/bridge.md"
---

# Bridge theme
URL: /docs/bridge
LLM index: /llms.txt
Description: A future Liquid companion for Shopify-native theme app blocks that cannot render headlessly.

# Bridge theme

Some Shopify apps expose theme app extensions that Shopify renders through Liquid theme infrastructure. An Astro storefront cannot execute those app blocks directly.

Bridge is a future, narrowly scoped Liquid companion for stores that need one of those surfaces. It is not another implementation of the storefront.

## Intended responsibility

Bridge would publish a minimal Shopify theme capable of rendering an approved app block on a Shopify-owned route. The Astro storefront could embed that result when an iframe is acceptable, with explicit sizing, loading, and error behavior.

Display-oriented widgets such as reviews, loyalty summaries, or sizing tools are the clearest candidates. SEO-critical markup, cart mutations, customer identity, and scripts that assume full theme ownership require separate evaluation.

## Required safeguards

A Bridge integration needs an explicit assignment between an app block and an Astro placement, a stable origin policy, responsive iframe sizing, and clear behavior in Shopify theme preview. It must not redirect ordinary storefront traffic into a partial Liquid theme.

The hosted platform also needs to explain which surface owns configuration and how a merchant diagnoses an unavailable block. Until those requirements are implemented, Bridge remains future work rather than a hidden dependency of the core storefront.

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.
Docs-scoped sitemap: [/docs/sitemap.md](/docs/sitemap.md).
Well-known sitemap: [/.well-known/sitemap.md](/.well-known/sitemap.md).