# Monthlees - LLMs.txt
# Last Updated: 2025-12-21
# Version: 1.0

## Site Overview

**Domain**: https://monthlees.com
**Site Name**: Monthlees
**Purpose**: Membership-based supplement marketplace offering premium, third-party tested supplements at wholesale pricing

**Tagline**: "Premium supplements without premium prices. Every month."

**Business Model**: 
- Membership-based e-commerce platform
- Members pay a monthly or annual subscription fee
- Members receive 50-70% discounts on premium supplements
- 7-day free trial for new members
- No contract, cancel anytime
- 30-day money-back guarantee

## Company Information

**Founder**: Christopher Walker, Founder & CEO
**Mission**: To provide premium, clinical-grade supplements at true cost, eliminating inflated retail markups

**Contact**:
- Support Email: support@monthlees.com
- Support Hours: Available via email

## Key Value Propositions

1. **Save 50-70%** on premium supplements compared to retail prices
2. **Third-party tested** products for quality assurance
3. **Clinical-grade formulas** with proper dosing
4. **80+ premium supplements** available
5. **Members save $80-$200/month** on average
6. **GMP Certified, FDA Compliant, Third-Party Tested**

## Site Structure & Key Pages

### Public Pages

**Homepage** (`/`)
- Hero section with value proposition
- Category sections
- Product showcases
- Testimonials and social proof
- FAQ section
- Call-to-action for membership signup

**How It Works** (`/how-it-works`)
- Explains the membership model
- Comparison with competitors
- Product showcase
- Membership benefits
- Quality standards overview
- FAQ and objections handling

**Quality Standards** (`/quality-standards`)
- Third-party testing information
- GMP certification details
- FDA compliance information
- Ingredient sourcing standards
- Quality assurance processes

**Our Products** (`/our-products`)
- Browse all available supplements
- Product categories
- Search and filter functionality
- Product listings with member pricing

**Pricing** (`/pricing`)
- Membership plan options
- Monthly and annual pricing
- Feature comparisons
- Money-back guarantee information

**Special Offer** (`/special-offer`)
- Founder's story
- Industry insights
- Value proposition details
- Membership signup

**Shipping** (`/shipping`)
- Shipping information
- Return policy
- Delivery times
- International shipping (if available)

**Product Pages** (`/product/[handle]`)
- Individual product details
- Member vs. non-member pricing
- Product specifications
- Ingredients and supplement facts
- Reviews and testimonials
- Add to cart functionality

**Search** (`/search`)
- Product search functionality
- Category browsing
- Filter by price, category, etc.
- Collection pages (`/search/[collection]`)

### Membership & Account Pages

**Join** (`/join`)
- Membership signup flow
- Plan selection
- Payment setup

**Login** (`/login`)
- User authentication
- Account access

**Member Pricing** (`/member-pricing`)
- Member-exclusive pricing display
- Membership benefits overview

**Welcome** (`/welcome`)
- Post-signup welcome page
- Onboarding information

**Refer** (`/refer`)
- Referral program
- Share with friends functionality

### Special Features

**Bundle Builder** (`/bundle-builder`)
- Custom supplement bundle creation
- Personalized recommendations
- Bundle pricing calculator

**Quiz** (`/f/quiz`)
- Personalized supplement quiz
- Product recommendations based on answers
- Health goal assessment

**Quick Shop** (`/f/quick-shop`)
- Fast product browsing
- Quick add to cart

**Instant Savings** (`/f/instant`)
- Special offers and promotions
- Limited-time deals

## Product Catalog

**Source**: Shopify-powered product catalog
**Overlay System**: Supabase provides member pricing overlays and metadata

**Product Categories**:
- Supplements organized by health goals and categories
- Searchable and filterable catalog
- Member vs. non-member pricing displayed

**Pricing Model**:
- Non-members: Retail pricing
- Members: 50-70% discount (member pricing)
- Member pricing displayed after authentication
- Subscription options available for recurring orders

**Product Features**:
- Third-party tested
- GMP certified
- FDA compliant
- Clinical-grade formulas
- Detailed ingredient lists
- Supplement facts available
- Product reviews and ratings

## Membership Model

**Membership Tiers**:
- Multiple plan options (Essentials, Performance, Pro, etc.)
- Monthly and annual billing options
- 7-day free trial for new members
- No contract required
- Cancel anytime

**Membership Benefits**:
- Access to member-only pricing (50-70% savings)
- Free shipping on orders (with shipping credits)
- Priority customer support
- Exclusive product access
- Referral rewards program

**Trial Process**:
1. User signs up for membership
2. 7-day free trial begins
3. Trial ends on first purchase OR after 7 days
4. Membership becomes active and billing starts

**Billing**:
- Managed via Clerk Billing + Stripe
- Secure payment processing
- Automatic renewals
- Easy cancellation

## API Endpoints

### Public APIs

**Cart Operations**:
- `POST /api/cart/batch-add` - Add multiple items to cart

**Membership**:
- `GET /api/membership/check` - Check membership status
- `GET /api/membership/plan-id` - Get membership plan ID

**Quiz & Recommendations**:
- `POST /api/quiz/recommendations` - Get personalized product recommendations

**Free Gift**:
- `POST /api/free-gift/choice` - Select free gift
- `POST /api/free-gift/redeem` - Redeem free gift
- `POST /api/free-gift/restore` - Restore free gift selection

**Shipping Credits**:
- `POST /api/shipping-credits/apply` - Apply shipping credits
- `GET /api/shipping-credits/status` - Check shipping credit status

**Webhooks**:
- `POST /api/clerk/billing` - Clerk billing webhook handler
- `POST /api/stripe/webhooks` - Stripe webhook handler
- `POST /api/shopify/orders` - Shopify orders webhook
- Internal cache management endpoints (not publicly accessible)

### Authentication

**Authentication Provider**: Clerk
- User authentication and management
- Session handling
- User profiles

**Billing Provider**: Clerk Billing + Stripe
- Subscription management
- Payment processing
- Webhook handling

## Integrations

**E-commerce**: Shopify
- Product catalog
- Cart management
- Order processing
- Inventory management

**Authentication**: Clerk
- User accounts
- Authentication
- User management

**Payments**: Stripe
- Payment processing
- Subscription billing
- Webhook handling

**Database**: Supabase
- Product overlays (member pricing)
- Membership status
- User metadata
- Product metadata

**Analytics**: PostHog
- User analytics
- Event tracking
- Product analytics

## Content Types

**Product Pages**:
- Product descriptions
- Ingredient lists
- Supplement facts
- Usage instructions
- Reviews and testimonials
- Related products

**Blog/Content** (if applicable):
- Health and wellness articles
- Supplement education
- Founder's insights
- Industry news

**Marketing Pages**:
- Landing pages
- Special offers
- Promotional content
- Educational content

## Key Features

**Bundle Builder**:
- Custom supplement bundle creation
- Personalized recommendations
- Save on bundles

**Product Quiz**:
- Personalized assessment
- Product recommendations
- Health goal matching

**Referral Program**:
- Share with friends
- Earn rewards
- Give $10, get $10

**Shipping Credits**:
- Free shipping for members
- Credit system
- Automatic application

**Member Pricing**:
- Dynamic pricing display
- Member-only access
- Significant savings

## Trust & Quality Indicators

**Certifications**:
- GMP Certified
- FDA Compliant
- Third-Party Tested

**Quality Standards**:
- Third-party testing for all products
- Banned ingredients list compliance
- Clinical-grade formulas
- Proper dosing

**Guarantees**:
- 30-day money-back guarantee
- No contract required
- Cancel anytime
- 7-day free trial

## Social Proof

**Media Mentions**:
- Featured in Esquire, TikTok, WIRED, Yahoo Finance, Business Insider, Art of Manliness, Wellness Mama, Goodreads, YouTube

**Testimonials**:
- Customer reviews
- Member success stories
- Savings testimonials

**Live Counter**:
- Real-time display of member savings
- Social proof element

## Technical Stack

**Framework**: Next.js 15.3.6 (React 19)
**Language**: TypeScript
**Styling**: Tailwind CSS
**Deployment**: Vercel
**CDN**: Vercel Edge Network

**Key Libraries**:
- Next.js App Router
- React Server Components
- Server Actions
- Clerk for authentication
- Shopify Storefront API
- Stripe for payments
- Supabase for database
- PostHog for analytics

## SEO & Discoverability

**Sitemap**: `/sitemap.xml`
**Robots**: `/robots.txt`
**Structured Data**: Schema.org markup
**Open Graph**: Social media previews
**Canonical URLs**: Proper canonicalization

## Content Guidelines

**Tone**: Professional, trustworthy, educational
**Focus**: Health, wellness, supplement education
**Target Audience**: Health-conscious consumers seeking quality supplements at fair prices

## Support & Contact

**Support Email**: support@monthlees.com
**Support Available**: Via email

## Legal & Policies

**Privacy Policy**: Available in footer
**Terms of Service**: Available in footer
**Shipping & Returns**: `/shipping`
**Accessibility**: WCAG compliant

## Additional Resources

**Sitemap**: https://monthlees.com/sitemap.xml
**Robots**: https://monthlees.com/robots.txt
**Agents File**: https://monthlees.com/agents.txt

---

For AI agents and developers, see: https://monthlees.com/agents.txt