> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shoppex.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Theme Development

> Customize a hosted Shoppex storefront with the Theme Builder and ThemeDocument tooling.

# Theme Development

Every hosted Shoppex storefront is a ThemeDocument rendered by the same block
renderer. You customize pages, blocks, colors, typography, content, and custom
CSS without maintaining a separate theme codebase.

<CardGroup cols={2}>
  <Card title="Theme Builder" icon="palette">
    Edit pages and blocks visually in the dashboard, then preview and publish.
  </Card>

  <Card title="AI and API tooling" icon="wand-magic-sparkles">
    Inspect document settings and apply structured changes with scoped access.
  </Card>
</CardGroup>

## Recommended workflow

<Steps>
  <Step title="Choose a theme">
    Open **Store → Themes** and select a Shoppex composition.
  </Step>

  <Step title="Edit the document">
    Add or reorder blocks and update their settings in the Theme Builder.
  </Step>

  <Step title="Preview">
    Check important pages and responsive layouts before publishing.
  </Step>

  <Step title="Publish">
    Publishing validates the document and creates a new serving revision.
  </Step>
</Steps>

For a self-hosted headless application, use `@shoppexio/storefront` instead of
the hosted Theme Builder.