How ecombio/storefront works
Ecombio is a headless Shopify storefront: shoppers browse and search the catalog, inspect products, manage a cart, and proceed to Shopify-hosted checkout; signed-in customers can also manage account details and orders. The repository includes complementary discovery surfaces for Markdown and agent commerce, plus reviews and Shopify-driven cache refresh. The tree and sampled routes support these major areas, but most page and data-layer implementations were not sampled, so some internal wiring is intentionally left out.
Main entry points: collections Catalog and product UI · cart Cart UI · md Markdown endpoints · route.ts Review endpoint
Components 25
Storefront browsing
- Store pages
app - Catalog and product UI
components/collections - Search UI
components/search
Cart and accounts
- Cart UI
components/cart - Cart operations
lib/cart/server.ts - Customer account
app/account/(authenticated) - Customer sessions
lib/auth/server.ts
Agent discovery
- Markdown endpoints
app/md - Storefront guide
app/llms.txt/route.ts - UCP profile
app/agent/ucp-profile.json/route.ts - Shop Agent
agent/agent.ts - Agent session
app/api/agent/session/route.ts
External integrations
- Hosted checkout
- Customer Account API
- Review endpoint
app/api/yotpo/reviews/route.ts - Yotpo reviews
- Shopify webhook
app/api/webhooks/shopify/route.ts
Shopify data
- Product data
lib/product/server.ts - Collection data
lib/collections/server.ts - Search data
lib/search/server.ts - Storefront API
lib/shopify/storefront/server.ts - Tagged cache
Other components
- Shopper
- AI agent
- Shopify
Connections 28
- Shopper → Store pages: browses
- Store pages → Catalog and product UI: renders
- Catalog and product UI → Collection data: loads collections
- Catalog and product UI → Product data: loads products
- Shopper → Search UI: searches
- Search UI → Search data: requests results
- Storefront API → Shopify: queries catalog
- Shopper → Cart UI: manages cart
- Cart UI → Cart operations: updates cart
- Cart operations → Storefront API: reads and writes
- Cart UI → Hosted checkout: starts checkout
- Shopper → Customer account: manages account
- Customer account → Customer sessions: checks session
- Customer sessions → Customer Account API: authenticates
- AI agent → Storefront guide: reads guide
- Storefront guide → Collection data: lists collections
- AI agent → Markdown endpoints: fetches Markdown
- Markdown endpoints → Search data: loads search
- Markdown endpoints → Product data: loads products
- AI agent → UCP profile: discovers commerce
- Shopper → Shop Agent: chats with
- Shop Agent → Agent session: prepares session
- Agent session → Cart operations: creates or reads cart
- Shopper → Review endpoint: submits review
- Review endpoint → Product data: resolves product
- Review endpoint → Yotpo reviews: submits review
- Shopify → Shopify webhook: sends event
- Shopify webhook → Tagged cache: invalidates tags