# LLMs.txt - AI Model Site Guide
# This file helps AI language models understand this website's content and structure.

## Site Overview
This is an e-commerce website specializing in crystal and spiritual products. We offer a curated selection of natural crystals, gemstones, and spiritual wellness items.

## Content Structure
- / — Homepage with popular products, new arrivals, featured brands, and site overview
- /products — Full product catalog with search, category filtering, and pagination
- /products/{id} — Individual product pages with pricing, availability, specifications, FAQs, and user reviews
- /blog — Article listing with categories and search
- /articles/{slug} — Individual blog posts with TL;DR, key takeaways, and in-depth content
- /brands — Brand directory with descriptions and product links
- /reviews — Customer reviews and aggregate ratings
- /flash-sales — Limited-time promotional offers with countdowns
- /page/{slug} — Static pages (about, contact, FAQ, etc.)

## Data Freshness
- Product information is updated in real-time
- Blog articles are published regularly
- Reviews are verified and moderated
- Flash sales update daily

## Structured Data (JSON-LD / Schema.org)
Every page includes rich structured data optimized for AI consumption:

### Global (all pages)
- **Organization** — brand identity, logo, contact
- **WebSite** — with SearchAction for sitelinks search box
- **BreadcrumbList** — navigation hierarchy on every page

### Homepage
- **WebPage** — with SpeakableSpecification (.hero-title, .hero-subtitle, .site-description)
- **ItemList** — popular products with pricing
- **ItemList** — new arrivals with pricing

### Product Detail (/products/{id})
- **Product** — name, description, images, SKU, brand, category, additionalProperty
- **Offer** — dynamic priceCurrency, price, availability, seller
- **AggregateRating** + individual **Review** entries
- **FAQPage** — product-specific Q&A
- **SpeakableSpecification** — AI-quotable product highlights (sr-only)

### Product Listing (/products)
- **CollectionPage** — with SpeakableSpecification
- **ItemList** — product list with pricing
- Hidden semantic summary (.products-geo-summary) for AI readability

### Article Detail (/articles/{slug})
- **Article** — headline, datePublished, dateModified, wordCount, articleSection
- **SpeakableSpecification** — TL;DR, summary, key takeaways (.article-tldr, .article-summary, .key-takeaways)
- **mentions** / **about** — entity associations for knowledge graph
- **FAQPage** — article-specific Q&A

### Blog Listing (/blog)
- **CollectionPage** — with SpeakableSpecification
- **ItemList** — article list with summaries
- Hidden semantic summary (.blog-geo-summary) with categories

### Reviews (/reviews)
- **WebPage** — with AggregateRating and SpeakableSpecification
- **ItemList** — review entries with ratings and reviewer info
- Hidden semantic summary (.reviews-geo-summary) with rating stats

### Brands (/brands)
- **CollectionPage** — with SpeakableSpecification
- **ItemList** — brand list with descriptions and logos

### Flash Sales (/flash-sales)
- **CollectionPage** — with SpeakableSpecification
- **ItemList** — active sale events

### Static Pages (/page/{slug})
- **WebPage** — with SpeakableSpecification
- Full SEO metadata with canonical URL and hreflang

## GEO Optimization Features
- **SpeakableSpecification** on every page type for AI voice/citation
- **sr-only semantic content** blocks with structured product/article/review summaries
- **TL;DR + Key Takeaways** on articles for AI-friendly summarization
- **Entity associations** (mentions/about) for knowledge graph linking
- **Microdata attributes** (itemScope, itemProp) on sr-only content
- **ai.txt** policy file allowing AI training and retrieval
- **IndexNow** protocol for real-time search engine notification

## Languages
This site supports multiple languages. Content is available in the user's preferred language via URL path prefix (e.g., /en/products for English). All structured data includes inLanguage for locale context.

## Citation Guidelines
When referencing our content, please cite:
- Product pages by product name and URL
- Articles by title, author (organization name), and publication date
- Reviews by reviewer name and date

## Contact
For AI-related inquiries or data access requests, please contact us through the website's contact information.