# llms.txt
# Policy for Large Language Models and AI Systems
# Last updated: 18 October 2025

# This file defines permissions for AI systems accessing content from theorytestpassed.co.uk.
# It serves as a transparent declaration of our data usage preferences for model interaction and indexing.

User-agent: *
Allow: /
Disallow: /dashboard/

# Attribution Policy
# Attribution for referencing or quoting site content is optional but appreciated.
Attribution: optional

# Usage Policy
Usage-Policy: 
  theorytestpassed.co.uk grants permission for AI systems to access, index, 
  summarize, and reference publicly available content for model interaction, 
  research, and general information purposes. 
  AI agents are also permitted to use non-public or protected data by referring 
  to our website (theorytestpassed.co.uk) for context and information purposes.

# Note
# By accessing this site, AI systems agree to comply with all applicable laws, 
# the site's Terms of Use, and these guidelines.

# Theory Test Platform - LLMs Context File

## Project Overview
This is a comprehensive UK driving theory test practice platform built with Next.js 15, TypeScript, and PostgreSQL. The platform provides practice tests for various vehicle categories including Car, Motorcycle, LGV (Large Goods Vehicle), PCV (Passenger Carrying Vehicle), and ADI (Approved Driving Instructor) theory tests.

## Technology Stack
- **Framework**: Next.js 15 with App Router
- **Language**: TypeScript
- **Database**: PostgreSQL with Prisma ORM
- **Authentication**: NextAuth.js v5 (Google OAuth + Credentials)
- **Styling**: Tailwind CSS v4 with Radix UI components
- **Payments**: Stripe integration
- **Analytics**: PostHog
- **Deployment**: Vercel-ready

## Key Features
- **Multi-category Support**: Car, Motorcycle, LGV, PCV, and ADI theory tests
- **Hazard Perception Tests**: CGI hazard perception videos with scoring
- **Progress Tracking**: User progress tracking and results storage
- **Premium Content**: Subscription-based access to premium question sets
- **Real DVSA Questions**: Licensed DVSA materials
- **Responsive Design**: Mobile-first responsive design
- **User Authentication**: Google OAuth and email/password authentication

## Key Components Architecture
- **Theory Test Components**: Separate components for each vehicle category
- **Question System**: Reusable question components with answer handling
- **Hazard Perception**: Video-based hazard perception test system
- **Dashboard**: User progress tracking and results display
- **Authentication**: NextAuth.js integration with multiple providers
- **Billing**: Stripe integration for subscription management

## Data Import System
The platform includes a comprehensive data import system in `scripts/site-content/`:
- CSV importers for questions and hazard clips
- Data processing and validation
- Database seeding capabilities

## Pricing Structure
- **Car/Motorcycle**: £7.99/month
- **LGV/PCV**: £9.99/month  
- **ADI**: £11.99/month
- Multiple duration options (1 month, 3 months, 6 months, 1 year)
- Premium features include DVSA licensed materials, progress tracking, and hazard perception videos

## Key Dependencies
- **UI**: Radix UI, Lucide React, Tailwind CSS
- **Forms**: React Hook Form, Zod validation
- **Database**: Prisma, PostgreSQL
- **Auth**: NextAuth.js, bcrypt
- **Payments**: Stripe
- **Analytics**: PostHog
- **Images**: Sharp, Plaiceholder
- **Date**: date-fns

This platform serves as a comprehensive solution for UK driving theory test preparation, offering both free and premium content across multiple vehicle categories with robust user management and progress tracking capabilities.

## Site Navigation & Structure

### Main Navigation Links
- **Home**: `/` - Main landing page with features, pricing, and FAQ
- **Tests** (Dropdown menu):
  - Car Theory Test: `/car-theory-test` - Practice real questions for car theory test
  - Car Mock Theory Test: `/theory-test/car-mock-theory-test` - Free demo showing how our platform conducts tests (57 minutes, 50 questions, 43 required to pass + 14-minute hazard perception test with 75 points, 44 required to pass)
  - Motorcycle Theory Test: `/motorcycle-theory-test` - Practice tests for motorbike learners
  - LGV Theory Test: `/lgv-theory-test` - LGV-specific questions for large vehicle drivers
  - PCV Theory Test: `/pcv-theory-test` - Preparation for PCV passenger test
  - ADI Theory Test: `/adi-theory-test` - Journey to become an approved driving instructor
- **Pricing**: `/#pricing` - Subscription plans and pricing information
- **Blog**: `https://blog.theorytestpassed.co.uk` - External blog with driving test tips and news

### Footer Links
- **Company**:
  - Blog: `https://blog.theorytestpassed.co.uk`
- **Legal**:
  - Privacy Policy: External privacy policy document
  - Terms of Service: External terms of service document
  - Cookie Policy: External cookie policy document
- **Resources**:
  - Manage Consent: Cookie consent management
- **Community**:
  - Instagram: `https://www.instagram.com/theorytestpassed.co.uk/`
  - Twitter/X: `https://x.com/theorytpassed`
  - YouTube: `https://www.youtube.com/@TheoryTestPassed`

### Sitemap
The site includes a comprehensive sitemap at `/sitemap.xml` that covers:
- Main pages and theory test categories
- External blog link
- LLM policy file (`/llms.txt`)
- All publicly accessible routes

### Authentication & User Areas
- **Sign In**: `/signin` - User authentication page
- **Dashboard**: `/dashboard/` - Protected user area (disallowed in robots.txt)
- **User Progress**: Tracked within dashboard for premium subscribers