README

UX Blocks Ecommerce

Shop section Twig components

Note

Read-only mirror. See CONTRIBUTING.md for how to propose changes.

Features

• 10 shop section roles — product cards, cart, checkout, orders, and promos
• Native-first (nat) — marketing-style sections styled with ui-kernel tokens
• Registry-aligned — blocks.shop.* fragment ids
• Explicit opt-in tier — never pulled in by symfinity/ux-blocks-full
• Flex recipe — bundle registration on install

Component inventory

Highlights: composable product list and overview sections; checkout and order summary layouts; cart drawer quickview when interactive tier is present.

Handbook: docs/components.md.

Prerequisites

Add the symfinity/recipes Flex endpoint to your project's composer.json (see recipes README) — recipes are not in Symfony's official recipe repository yet.

Installation

Explicit opt-in — add only when you ship storefront pages. See UX Blocks install profiles.

composer require symfinity/ux-blocks-ecommerce

See Installation.

Quick Start

<twig:ProductOverview title="Classic Tee" price="29.00" />
<twig:ProductListSection title="You may also like" />

See Quick start for the full walkthrough.

Documentation

• Quick start — minimal setup path
• Installation — Flex, dependencies, verify
• Configuration — bundle and app options
• Components — role index and examples
• Usage — day-to-day patterns
• Upgrade — version migrations

Requirements

• PHP 8.2 or higher
• Symfony 7.4 or 8.x
• symfinity/ux-blocks-core ^0.1
• symfinity/ux-blocks-marketing ^0.1 (installed automatically)

Support

• GitHub Issues
• Security
• Contributing

License

MIT