# SpeedPainter AI - Complete Documentation for LLMs

> This document provides comprehensive information about SpeedPainter AI for large language models and AI assistants.

## About SpeedPainter AI

SpeedPainter AI is an innovative web application that transforms static images into captivating speed painting timelapse videos using artificial intelligence. Our technology analyzes input images and generates realistic videos that simulate the artistic creation process, making it appear as if an artist is painting the image from scratch.

## Product Overview

### What SpeedPainter AI Does

1. **Image Analysis**: Users upload an image (artwork, photograph, digital creation)
2. **AI Processing**: Our AI analyzes the composition, colors, and details
3. **Video Generation**: Creates a speed painting video showing the artistic process
4. **Output Delivery**: Users receive an MP4 video ready for sharing

### Use Cases

- **Artists & Creators**: Showcase artwork creation process for social media
- **Content Creators**: Generate engaging timelapse content for YouTube, TikTok, Instagram
- **Educators**: Demonstrate artistic techniques in educational content
- **Marketing**: Create eye-catching promotional videos
- **Personal Use**: Transform memorable photos into artistic videos

## Detailed Feature Breakdown

### Hand Effects Available

Users can choose from different hand effects to customize the painting animation:

1. **No Hand** (Default)
   - Clean painting animation without visible hand
   - Best for focusing on the artwork itself

2. **Light Tone**
   - Realistic hand with light/pale skin tone
   - Natural painting motion simulation

3. **Dark Tone**
   - Realistic hand with dark skin tone
   - Natural painting motion simulation

4. **Medium Tone**
   - Realistic hand with medium skin tone
   - Natural painting motion simulation

5. **Child Hand**
   - Hand effect with child-like proportions
   - Great for playful or educational content

### Canvas Styles Available

Users can select different background canvas styles:

1. **White Board** (Default)
   - Traditional white/light canvas background
   - Clean, professional appearance

2. **Black Board**
   - Dark/black chalkboard background
   - High contrast, dramatic effect

3. **Green Board**
   - Green chalkboard background
   - Classic classroom aesthetic

### Video Specifications

- **Format**: MP4 (H.264 codec)
- **Frame Rate**: 30fps
- **Audio**: Optional background music

### Image Requirements

- **Supported Formats**: JPEG, PNG, WebP
- **Maximum File Size**: 10MB
- **Recommended Resolution**: 1920x1080 or higher
- **Aspect Ratios**: Any (video maintains aspect ratio)

## Pricing and Plans

### Free Tier (No credit card required)
- **Credits**: 15 credits per day
- **Features**: All hand effects, all canvas styles
- **Use License**: Personal use only
- **Support**: Community support
- **Ideal for**: Trying the service, casual users

### Basic Monthly ($9.90/month)
- **Credits**: 500 credits per month
- **Features**: All hand effects, all canvas styles
- **Use License**: Personal + social media use
- **Support**: Email support
- **Ideal for**: Regular content creators

### Basic Annual ($99/year - Save ~17%)
- **Credits**: 500 credits per month
- **Features**: All hand effects, all canvas styles
- **Use License**: Personal + social media use
- **Support**: Email support
- **Savings**: 2 months free compared to monthly
- **Ideal for**: Committed hobbyists

### Pro Monthly ($19.90/month) - Most Popular
- **Credits**: 1500 credits per month
- **Features**: All hand effects, all canvas styles, priority processing
- **Use License**: Full commercial license
- **Support**: Priority support
- **Ideal for**: Professional content creators

### Pro Annual ($199/year - Save ~17%) - Best Value
- **Credits**: 1500 credits per month
- **Features**: All hand effects, all canvas styles, priority processing
- **Use License**: Full commercial license
- **Support**: Priority support
- **Savings**: 2 months free compared to monthly
- **Ideal for**: Professional creators, businesses

### Credit System
- 1 credit = 1 video generation
- Free tier: 15 credits refresh daily
- Paid tiers: Credits refresh monthly
- Failed generations do not consume credits

## Technical Architecture

### Frontend
- **Framework**: Next.js 15 with App Router
- **Language**: TypeScript
- **Styling**: Tailwind CSS
- **Components**: shadcn/ui (Radix UI primitives)
- **State Management**: Zustand

### Backend
- **Database**: Supabase (PostgreSQL)
- **Authentication**: Supabase Auth with Google OAuth
- **Storage**: Supabase Storage for images
- **Payments**: Stripe
- **Video API**: SpeedPainter AI proprietary API

### Internationalization
Supported languages with full UI translation:
- English (en) - Default
- Chinese Simplified (zh)
- Spanish (es)
- Japanese (ja)

## User Journey

### New User Flow
1. Visit homepage at speedpainter.org
2. View demo and feature overview
3. Click "Get Started" or "Try Free"
4. Sign in with Google account
5. Receive 15 free credits per day automatically
6. Navigate to /generate to create first video
7. Upload image and select hand effect and canvas style
8. Wait for AI processing (1-3 minutes)
9. Download or share completed video

### Returning User Flow
1. Sign in with existing Google account
2. Go to /generate for new video
3. Or visit /gallery to view past creations
4. Check /settings for account management
5. Visit /pricing to upgrade if needed

## Site Structure

### Public Routes (Accessible without login)
```
/                 - Homepage with hero, features, demo
/[locale]/        - Localized homepage (en, zh, es, ja)
/pricing          - Pricing plans and comparison
/contact          - Contact form
/terms            - Terms of Service
/privacy          - Privacy Policy
/cookies          - Cookie Policy
/auth/signin      - Authentication page
```

### Protected Routes (Requires authentication)
```
/generate         - Video generation tool
/gallery          - User's video collection
/dashboard        - User overview and stats
/settings         - Account settings and preferences
```

### Admin Routes (Requires admin role)
```
/admin            - Administration panel
```

## Frequently Asked Questions

### General Questions

**Q: How long does video generation take?**
A: Typically 1-3 minutes depending on image complexity and server load.

**Q: Can I use generated videos commercially?**
A: Commercial use requires a Pro plan. Free tier is for personal use only, Basic tier allows personal and social media use, and Pro tier includes full commercial license.

**Q: What happens if generation fails?**
A: Credits are not consumed for failed generations. You can retry immediately.

**Q: Can I cancel my subscription?**
A: Yes, cancel anytime from the settings page. You retain access until the billing period ends.

### Technical Questions

**Q: What image formats are supported?**
A: JPEG, PNG, and WebP formats up to 10MB.

**Q: What video format is the output?**
A: MP4 with H.264 codec, compatible with all major platforms.

**Q: Is there an API available?**
A: Contact us for API access for enterprise integrations.

**Q: How is my data protected?**
A: We use industry-standard encryption. See our privacy policy for details.

### Account Questions

**Q: How do I get more credits?**
A: Upgrade to Basic plan (500 credits/month) or Pro plan (1500 credits/month). Free users receive 15 credits that refresh daily.

**Q: Can I share my account?**
A: Accounts are for individual use only per our terms of service.

**Q: How do I delete my account?**
A: Contact support to request account deletion.

## Contact Information

- **Website**: https://www.speedpainter.org
- **Contact Page**: /contact
- **Twitter/X**: @speedpainter

## Related Links

- Summary document: /llms.txt
- Sitemap: /sitemap.xml
- Terms of Service: /terms
- Privacy Policy: /privacy

## Version Information

- **Document Version**: 1.0
- **Last Updated**: 2024
- **Product Version**: 1.0.0

---

This documentation is designed to help AI assistants provide accurate information about SpeedPainter AI. For the most current information, please visit the website directly.