# ExAI - AI Home Design Visualization
# https://www.exai.uk
# llms-full.txt - Extended Documentation for Large Language Models

================================================================================
OVERVIEW
================================================================================

ExAI is a web application that leverages artificial intelligence to help
homeowners, real estate professionals, interior designers, and contractors
visualize both exterior and interior design projects before committing to
renovations.

The platform addresses common challenges: it's difficult to imagine how a home
will look after exterior modifications or how a room will feel with new décor.
ExAI solves this by generating photorealistic AI visualizations based on actual
property and room images.

================================================================================
DETAILED FEATURES
================================================================================

## EXTERIOR DESIGN

### Address-Based Image Retrieval

- Users enter any valid street address worldwide
- System automatically fetches Google Street View imagery
- **Multi-angle selection**: 4 different viewing angles (0°, 90°, 180°, 270°)
- Horizontal scrolling thumbnail gallery for angle selection
- Large preview of selected angle before proceeding
- Handles address validation and geocoding

### Custom Image Upload (Exterior)

- Upload your own property photos (PNG, JPEG, WebP)
- Works alongside address lookup feature
- Ideal for properties without Street View coverage
- Supports images from any source

### AI-Powered Exterior Visualization

The AI system can modify:

### Roofing
- Material changes (shingle, tile, metal, slate)
- Color modifications
- Style changes (hip, gable, flat, mansard)

### Siding & Exterior Walls
- Material swaps (vinyl, wood, brick, stone, stucco)
- Paint color changes
- Texture modifications

### Windows & Doors
- Style updates (modern, traditional, colonial)
- Frame color changes
- Size modifications
- Addition of shutters

### Landscaping
- Front yard redesign
- Tree and shrub placement
- Lawn improvements
- Hardscape additions (walkways, driveways)

### Additional Exterior Features
- Garage door updates
- Fence additions or changes
- Lighting fixtures
- Architectural details (columns, trim, molding)
- Pergolas and solar panels
- TAMA 38 renovations (Israel-specific building reinforcement)

## INTERIOR DESIGN

### Room Photo Upload

- Upload photos of any room (PNG, JPEG, WebP)
- Support for any room type: living room, bedroom, kitchen, bathroom, etc.
- Room naming for organization
- Image editing with crop and rotate before processing

### AI-Powered Interior Visualization

The AI system can transform:

#### Walls
- Paint color changes
- Texture modifications (smooth, textured, exposed brick)
- Wallpaper additions

#### Flooring
- Material changes (hardwood, tile, carpet, marble, concrete)
- Color and finish modifications

#### Furniture
- Style changes (modern, traditional, minimalist)
- Arrangement modifications
- New furniture visualization

#### Lighting
- Fixture changes (pendant, recessed, chandelier)
- Ambient lighting modifications
- Natural light enhancement

#### Ceiling
- Design changes (coffered, tray, vaulted)
- Color and finish modifications

#### Décor & Accessories
- Art and wall decorations
- Plants and greenery
- Rugs and textiles
- Decorative objects

#### Style Presets
- Modern Minimalist
- Scandinavian
- Industrial
- Bohemian
- Traditional
- Contemporary

### Smart Preservation

- Windows and doors are preserved in their original position
- Room structure and layout maintained
- Natural lighting sources respected

## USER ACCOUNT SYSTEM

- Email/password authentication
- Google OAuth integration
- Design history saved to account
- Secure session management
- Credit balance tracking

## CREDIT SYSTEM

- 3 free designs for new users
- Credits work for both exterior and interior designs
- Credit packages: 5 credits ($2.99), 10 credits ($4.99), 20 credits ($9.59)
- Credits never expire
- Stripe payment integration

## Design Management

- Save unlimited designs
- **Interactive before/after slider**: Drag to compare original vs redesign
- Download generated images
- **Redesign Again**: Generate new variations from any saved design
- Design history with thumbnails and dates

================================================================================
TECHNICAL ARCHITECTURE
================================================================================

## Backend (PHP)

- Modern PHP with strict typing
- Modular routing system
- PDO database abstraction
- Secure authentication layer

## Frontend

- Pico CSS (Cyan theme) for minimal, semantic styling
- Fully responsive design for mobile and desktop
- No heavy JavaScript frameworks
- Progressive enhancement approach
- Modern UI with tabs, modals, and interactive sliders

## AI Integration

- Image-to-image generation models
- Prompt engineering for architectural accuracy
- Style transfer for consistent aesthetics
- Multiple generation options per request

## External Services

- Google Maps Platform (Street View, Geocoding)
- AI image generation API
- OAuth providers (Google)

## Database

- MySQL/MariaDB
- User accounts and sessions
- Design history and metadata
- Address cache for performance

================================================================================
SUPPORTED LANGUAGES
================================================================================

ExAI is available in 9 languages with full UI translation:

| Code | Language | Native Name | URL | RTL |
|------|----------|-------------|-----|-----|
| en | English | English | https://www.exai.uk | No |
| es | Spanish | Español | https://www.exai.uk/es | No |
| he | Hebrew | עברית | https://www.exai.uk/he | Yes |
| de | German | Deutsch | https://www.exai.uk/de | No |
| fr | French | Français | https://www.exai.uk/fr | No |
| th | Thai | ไทย | https://www.exai.uk/th | No |
| el | Greek | Ελληνικά | https://www.exai.uk/el | No |
| hy | Armenian | Հdelays | https://www.exai.uk/hy | No |
| ka | Georgian | ქართული | https://www.exai.uk/ka | No |

## Language Features

- Automatic language detection from browser preferences
- Language preference saved in session (guests) and database (logged-in users)
- Automatic redirect to preferred language on subsequent visits
- Full RTL (right-to-left) support for Hebrew
- Language switcher in navigation menu
- All UI elements, buttons, and messages translated
- hreflang tags for SEO

================================================================================
API INFORMATION
================================================================================

ExAI currently operates as a web application without a public API.
Future API access may be provided for:

- Real estate platforms
- Home improvement retailers
- Contractor management software
- Property listing services

================================================================================
USAGE GUIDELINES
================================================================================

## Appropriate Use

- Personal home renovation planning
- Professional client presentations
- Educational and exploratory purposes
- Marketing material generation (with disclosure)

## Restrictions

- Do not use to misrepresent property conditions
- Do not use for fraudulent real estate listings
- Do not claim AI-generated images are photographs
- Respect intellectual property of source imagery

================================================================================
DATA HANDLING
================================================================================

## What We Store

- User account information (email, name)
- Generated design history
- Address lookup cache
- Usage analytics (anonymized)

## What We Don't Store

- Payment information (no paid features yet)
- Original Street View images (fetched on demand)
- Personal browsing history outside our platform

## Data Retention

- Active accounts: Data retained indefinitely
- Deleted accounts: Data removed within 30 days
- Analytics: Aggregated and anonymized after 90 days

================================================================================
FREQUENTLY ASKED QUESTIONS
================================================================================

Q: How accurate are the visualizations?
A: Visualizations are AI-generated approximations intended for inspiration and
   planning. They should not be used as exact construction specifications.

Q: Can I use generated images commercially?
A: Generated images are for personal use. Commercial licensing available upon
   request for professional applications.

Q: How long does generation take?
A: Typical generation time is 15-30 seconds depending on complexity.

Q: What addresses work?
A: Any address with Google Street View coverage can be used. Rural or new
   construction areas may have limited coverage.

Q: Is my data secure?
A: Yes. We use industry-standard encryption, secure authentication, and do not
   sell user data to third parties.

================================================================================
CONTACT & SUPPORT
================================================================================

- Website: https://www.exai.uk
- General inquiries: hello@exai.uk
- Privacy concerns: privacy@exai.uk
- Legal matters: legal@exai.uk

## Social Media

- Coming soon

================================================================================
LEGAL DOCUMENTS
================================================================================

- Terms and Conditions: https://www.exai.uk/terms
- Cookie Policy: https://www.exai.uk/cookies
- Privacy Policy: https://www.exai.uk/privacy (coming soon)

================================================================================
VERSION HISTORY
================================================================================

- v1.0 (December 2024): Initial release with core features
  - Address lookup and Street View integration
  - AI visualization engine
  - User accounts and design history
  - Basic modification options

- v1.1 (December 2024): Enhanced image selection
  - Multi-angle Street View selection (4 angles)
  - Custom image upload option
  - Interactive before/after comparison slider
  - Redesign Again feature
  - Improved login page with Google OAuth styling
  - Mobile-responsive button layouts

- v1.2 (January 2025): Interior Design & Payments
  - NEW: Interior Design module (/interior)
  - Room photo upload with crop/rotate editor
  - AI interior transformation (walls, flooring, furniture, lighting, ceiling, décor)
  - Smart window and door preservation
  - Multiple interior style presets
  - Credit-based pricing system
  - Stripe payment integration
  - Webhook-based credit fulfillment
  - Portuguese and Arabic language support

================================================================================
MACHINE-READABLE SUMMARY
================================================================================

name: ExAI
tagline: AI Home Design Visualization - Exterior & Interior
url: https://www.exai.uk
category: Home Improvement, Interior Design, AI Tools, Visualization
features: [address-lookup, multi-angle-selection, image-upload, ai-visualization, before-after-slider, design-history, redesign-again, interior-design, room-transformation, credit-system, stripe-payments]
stack: [php, mysql, pico-css, google-maps, stripe]
authentication: [email, google-oauth]
api: none-public
pricing: freemium (3 free designs, then credit packs)
languages: [en, es, he, de, fr, th, el, hy, ka, pt, ar]
default_language: en
rtl_languages: [he, ar]
region: global
founded: 2024
latest_update: January 2025

================================================================================
END OF DOCUMENT
================================================================================