# llms.txt - Content Guide for LLMs

This file provides information about the content available on this website to help LLMs understand and interact with the site effectively.

## Site Information

**Site Name:** Harlowe  
**Type:** E-commerce Storefront  
**Platform:** Shopify Hydrogen + Remix  
**CMS:** Sanity  
**Search:** Algolia

## Supported Locales

This website supports multiple locales for internationalization:

- **Default (GB):** https://harlowe.eu/ - English (United Kingdom), Currency: GBP £
- **Europe (EN):** https://harlowe.eu/en-eu - English (Europe), Currency: EUR €
- **France:** https://harlowe.eu/fr-eu - French (France), Currency: EUR €
- **Germany:** https://harlowe.eu/de-eu - German (Germany), Currency: EUR €
- **Spain:** https://harlowe.eu/es-eu - Spanish (Spain), Currency: EUR €
- **Italy:** https://harlowe.eu/it-eu - Italian (Italy), Currency: EUR €

All content is available in all supported locales. Locale-specific URLs follow the pattern: `/{locale}/content-path`

## Content Types

### Products
- **URL Pattern:** `/{locale}/products/{handle}`
- **Example:** `https://harlowe.eu/products/example-product` or `https://harlowe.eu/fr-eu/products/example-product`
- **Source:** Shopify Storefront API
- **Features:** Product variants, pricing, images, descriptions, inventory status

### Collections
- **URL Pattern:** `/{locale}/collections/{handle}`
- **Example:** `https://harlowe.eu/collections/summer-collection` or `https://harlowe.eu/de-eu/collections/summer-collection`
- **Source:** Shopify Storefront API
- **Features:** Product listings, filtering, sorting

### Pages (CMS Content)
- **URL Pattern:** `/{locale}/pages/{handle}`
- **Example:** `https://harlowe.eu/pages/about-us` or `https://harlowe.eu/es-eu/pages/about-us`
- **Source:** Sanity CMS
- **Features:** Rich content modules, hero sections, customizable layouts

### Blog Posts
- **URL Pattern:** `/{locale}/blogs/{blogHandle}/{articleHandle}`
- **Example:** `https://harlowe.eu/blogs/news/article-title` or `https://harlowe.eu/it-eu/blogs/news/article-title`
- **Source:** Sanity CMS
- **Features:** Rich text content, images, categories

### Events
- **URL Pattern:** `/{locale}/events/{eventHandle}` or `/{locale}/events/{eventHandle}/{slug}`
- **Example:** `https://harlowe.eu/events/summer-sale` or `https://harlowe.eu/fr-eu/events/summer-sale`
- **Source:** Sanity CMS
- **Features:** Event details, dates, locations, related content

### Homepage
- **URL Pattern:** `/` or `/{locale}`
- **Example:** `https://harlowe.eu/` (default GB) or `https://harlowe.eu/fr-eu` (French)
- **Source:** Sanity CMS (home document)
- **Features:** Modular content sections, hero sections, featured products

## Sitemaps

Sitemaps are available to discover all content:

- **Main Sitemap Index:** https://harlowe.eu/sitemap.xml
- **Products Sitemap:** https://harlowe.eu/sitemap/products.xml (paginated)
- **Collections Sitemap:** https://harlowe.eu/sitemap/collections.xml
- **Pages Sitemap:** https://harlowe.eu/sitemap/pages.xml (paginated)
- **Articles Sitemap:** https://harlowe.eu/sitemap/articles.xml

All sitemaps include locale-specific URLs for all supported languages.

## API Endpoints

### Public APIs

- **Product API:** https://harlowe.eu/api/products - Get product data
- **Product by ID:** https://harlowe.eu/api/products/{id} - Get specific product
- **References API:** https://harlowe.eu/api/references - Get content references
- **Locales API:** https://harlowe.eu/api/locales - Get available locales
- **Contact API:** https://harlowe.eu/api/contact - Submit contact form

### Search

- **Search Page:** `/{locale}/search`
- **Search API:** Algolia-powered search with multi-language support
- **Features:** Product search, collection filtering, faceted search

## Content Structure

### Content Modules (Available on Pages)

The site uses a modular content system with the following module types:

- **Hero Module:** Multi-slide hero sections with CTAs
- **Product Features:** Dynamic product showcases
- **Grid Module:** Flexible grid layouts
- **Accordion Module:** Collapsible content sections
- **Icon Grid:** Feature highlights with icons
- **Content Block:** Rich text content
- **Video Module:** YouTube, Vimeo, and MP4 video embeds
- **Callout Module:** Promotional banners
- **Image Gallery:** Advanced image galleries with hotspots
- **Tabs Module:** Tabbed content organization
- **Product Recommendations:** Related product suggestions
- **Blog Posts Grid:** Featured blog posts
- **Bento Grid:** Modern grid layouts

### E-commerce Features

- **Shopping Cart:** `/{locale}/cart`
- **Customer Account:** `/{locale}/account` (login, orders, addresses, profile, settings)
- **Checkout:** Shopify-hosted checkout
- **Product Recommendations:** AI-powered product suggestions
- **Inventory Management:** Real-time stock status

## SEO Features

- **Structured Data:** JSON-LD markup on all pages
- **Meta Tags:** Dynamic meta tags per page
- **OpenGraph:** Social media sharing support
- **Twitter Cards:** Twitter sharing optimization
- **Canonical URLs:** Proper canonicalization
- **Robots.txt:** https://harlowe.eu/robots.txt - Crawler directives

## Content Discovery

### For LLMs:

1. **Start with Sitemaps:** Use `https://harlowe.eu/sitemap.xml` to discover all content
2. **Locale-Aware:** Always check for locale-specific versions of content
3. **Content Types:** Products, Collections, Pages, Blog Posts, and Events are the main content types
4. **API Access:** Use API endpoints for structured data access
5. **Search:** Use the search functionality to find specific content

### Best Practices:

- Respect locale preferences when accessing content
- Use sitemaps for comprehensive content discovery
- Check for structured data (JSON-LD) in page source
- Consider multi-language content when providing information
- Use API endpoints for programmatic access

## Robots.txt

The site has a robots.txt file at `https://harlowe.eu/robots.txt` that provides crawler directives. Key disallowed paths:
- `/admin`
- `/cart`
- `/account`
- `/checkout`
- `/orders`
- `/search` (but `/search/` is allowed)

## Additional Resources

- **Documentation:** See README.md files in the codebase
- **Content Management:** Sanity Studio for content editing
- **E-commerce Platform:** Shopify Storefront API
- **Search Platform:** Algolia

---

Last updated: January 2025