# Lexsis Storefront Documentation

> Build AI-powered Shopify landing pages with the Storefront MCP

Canonical URL: https://0.0.0.0:3005/

Build high-converting, personalized Shopify landing pages powered by AI.

## Machine-Readable Documentation

Every documentation URL returns Markdown when the request uses
`Accept: text/markdown` or a recognized AI-agent user agent. Add
`?format=markdown` to any page URL to request Markdown explicitly.

- [`/llms.txt`](/llms.txt) lists all documentation pages.
- [`/llms-full.txt`](/llms-full.txt) contains the complete documentation corpus.

## What is Lexsis Storefronts?

Lexsis Storefronts lets you create landing pages, product detail pages, and
guided shopping experiences that adapt to your audience. Connect your AI agent
to the Storefront MCP, generate pages from brand context, products, and
campaign intent, then review them before publication.

## Core Concepts

- **Page JSON** — JSON documents that define page structure (head, theme, sections, scripts)
- **Sections** — HTML blocks with Tailwind CSS that compose a page
- **Islands** — Pre-built React components for interactive commerce (BuyBox, Cart, Reviews)
- **Themes** — CSS custom properties (`--lx-*` variables) for brand customization
- **Workspaces** — Brand containers that hold your identity, pages, and experiments

## Architecture

```
┌─────────────────────────────────────────────────────┐
│  AI Agent (Claude, Cursor, etc.)                     │
│                                                      │
│  1. Read resources (vibe://docs/generation-guide)    │
│  2. Call domain routers (lexsis_assets, lexsis_drafts)     │
└─────────────┬───────────────────────────────────────┘
              │ MCP Protocol
              ▼
┌─────────────────────────────────────────────────────┐
│  Storefront Blueprint MCP Server                     │
│                                                      │
│  19 tools + resources + skill guides                 │
└─────────────┬───────────────────────────────────────┘
              │
              ▼
┌─────────────────────────────────────────────────────┐
│  Live Shopify Landing Page                           │
│  - SSR rendered                                      │
│  - Islands hydrated client-side                      │
│  - Cached at edge (60s server, 1hr stale)           │
└─────────────────────────────────────────────────────┘
```

## Quick Links

- [Getting Started](/getting-started) — Set up and generate your first page
- [Page Schema](/pages/schema) — Full JSON reference
- [Islands](/islands) — Interactive commerce components
- [Tools](/tools) — The 19-tool consolidated MCP surface
- [Tracking Tags & Page Analytics](/tracking) — Configure tags and understand page events
- [Changelog](/changelog) — Release history and new features