# EggOFFER — Full LLM Reference

> EggOFFER is a Remix v2 SSR (server-side rendered) multi-category online shopping aggregator. It queries a MongoDB database via Prisma directly in route loaders and renders fully hydrated HTML, making every product and category page immediately indexable by search engines and AI crawlers.

## Architecture

- **Framework**: Remix v2 (SSR) with React 18 + TypeScript
- **Styling**: Tailwind CSS
- **Database**: MongoDB accessed via Prisma ORM (server-only loaders)
- **Deployment**: Node.js / Docker
- **Data source**: Shopify merchant product feeds (`ads` collection) + Shopify Price Rules / Discount Codes

## URL Structure

- `/` — Home: featured products, deal products, active coupons, top stores
- `/products` — Product listing; filters: `?category=<slug>`, `?search=<query>`, `?deal=true`, `?page=<n>`
- `/product/<handle>.p<shopifyProductId>` — Canonical product detail (e.g. `/product/peanut-butter.p8865500332195`)
- `/product/<mongoObjectId>` — Legacy product URL; HTTP 301 redirect to canonical
- `/<category-slug>` — Category product listing (24 slugs, see below)
- `/store/<shop-domain>` — Merchant store page (e.g. `/store/mystore.myshopify.com`)
- `/store/<mongoObjectId>` — Legacy store URL; HTTP 301 redirect to canonical
- `/coupons` — Active discount codes; filters: `?type=freeship|voucher`
- `/sitemap.xml` — Dynamically generated XML sitemap: static pages + 24 categories + up to 1,000 products + all stores
- `/llms.txt` — Curated LLM overview (llms.txt spec)
- `/llms-full.txt` — This expanded technical reference
- `/privacy` — Privacy Policy (static)
- `/tos` — Terms of Service (static)

## Product Categories (24)

| Slug | Name |
|---|---|
| bags-travel | Bags and Travel |
| bedding-bath | Bedding and Bath |
| cameras | Cameras |
| computers-laptops | Computers and Laptops |
| digital-goods | Digital Goods |
| fashion | Fashion |
| furniture-decor | Furniture and Decor |
| groceries | Groceries |
| health-beauty | Health and Beauty |
| home-appliances | Home Appliances |
| kitchen-dining | Kitchen and Dining |
| laundry-cleaning | Laundry and Cleaning |
| media-music-books | Media Music and Books |
| mobiles-tablets | Mobiles and Tablets |
| mother-baby | Mother and Baby |
| motors | Motors |
| pet-supplies | Pet Supplies |
| special-digital-products | Special Digital Products |
| sports-outdoors | Sports and Outdoors |
| stationery-craft | Stationery and Craft |
| tools-diy-outdoor | Tools DIY and Outdoor |
| toys-games | Toys and Games |
| tv-audio-video-gaming-wearables | TV Audio Video Gaming Wearables |
| watches-sunglasses-jewellery | Watches Sunglasses Jewellery |

## SEO Meta Strategy

### Product detail (`/product/<handle>.p<id>`)
- `og:type`: product
- `og:image` + `twitter:image`: actual Shopify product image
- `twitter:card`: summary_large_image
- `description`: product shortDescription (≤155 chars) or auto-generated from name, category, price, store
- Canonical `<link>`: derived from request origin — works correctly across dev, staging, and production

### Category page (`/<slug>`)
- `og:type`: website
- `description`: "Shop <Category> products on EggOFFER. Discover the best prices, fast delivery and exclusive deals."

### Store page (`/store/<shop-domain>`)
- `og:type`: business.business
- `og:image` / `twitter:image`: store logo (omitted when unavailable)
- `twitter:card`: summary_large_image with logo, else summary

## Coupon Types

- **Percentage discount**: `value_type = percentage` (e.g. 20% off)
- **Fixed amount**: `value_type = fixed_amount` (e.g. $5 off)
- **Free shipping**: `target_type = shipping_line`

## Contact

- Website: https://eggoffer.com
- Support: support@eggoffer.com