mirror of
https://github.com/Wan-Video/Wan2.1.git
synced 2025-12-16 20:23:21 +00:00
e8fda73741
This commit adds a production-ready Progressive Web App for AI-powered video generation using Wan2.1 models. Features: - Next.js 15 frontend with App Router and PWA support - FastAPI backend with Replicate integration - 50+ prompt templates across 7 categories - Supabase authentication and database - Credit system with usage tracking - Text-to-Video and Image-to-Video generation - Complete documentation (setup, deployment, contributing) Project Structure: - apps/web: Next.js frontend with shadcn/ui components - apps/api: FastAPI backend with GPU processing via Replicate - packages/db: Database schema and migrations for Supabase Tech Stack: - Frontend: Next.js 15, shadcn/ui, Tailwind, Zustand, React Hook Form, Zod - Backend: FastAPI, Replicate, Supabase - Database: Supabase (Postgres) with RLS - Infrastructure: Turborepo monorepo, Vercel/Modal deployment Documentation: - README.md: Project overview and features - SETUP.md: Complete setup guide (5-minute quickstart) - DEPLOYMENT.md: Production deployment instructions - CONTRIBUTING.md: Contribution guidelines - PROJECT_SUMMARY.md: Comprehensive project documentation Ready for development and deployment. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
115 lines
2.5 KiB
Markdown
115 lines
2.5 KiB
Markdown
# Wan2.1 PWA - AI Video Generation Platform
|
|
|
|
A production-ready Progressive Web App for AI-powered video generation using Wan2.1 models.
|
|
|
|
## Features
|
|
|
|
- 🎨 Smart Prompt Engineering: 50+ templates with context-aware suggestions
|
|
- 🎬 Video Generation: Text-to-Video and Image-to-Video
|
|
- 📱 Progressive Web App: Installable, offline-capable
|
|
- 🔐 Authentication: Supabase Auth with OAuth support
|
|
- 💳 Credit System: Freemium model with usage tracking
|
|
- ⚡ Real-time Progress: WebSocket-based generation tracking
|
|
- 🎯 Template Library: Categorized prompts (Cinematic, Animation, Realistic)
|
|
- 📥 Download & Share: Export videos to device
|
|
|
|
## Tech Stack
|
|
|
|
### Frontend
|
|
- Framework: Next.js 15 (App Router)
|
|
- UI: shadcn/ui + Tailwind CSS
|
|
- State: Zustand
|
|
- Forms: React Hook Form + Zod
|
|
- PWA: next-pwa
|
|
|
|
### Backend
|
|
- API: FastAPI (Python)
|
|
- GPU: Replicate / Modal
|
|
- Queue: Celery + Redis
|
|
|
|
### Database
|
|
- DB: Supabase (Postgres)
|
|
- Auth: Supabase Auth
|
|
- Storage: Supabase Storage
|
|
- Cache: Upstash Redis
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
wan-pwa/
|
|
├── apps/
|
|
│ ├── web/ # Next.js frontend
|
|
│ └── api/ # FastAPI backend
|
|
├── packages/
|
|
│ ├── ui/ # Shared UI components
|
|
│ ├── db/ # Database schema & migrations
|
|
│ └── types/ # Shared TypeScript types
|
|
├── turbo.json # Monorepo build config
|
|
└── package.json # Root dependencies
|
|
```
|
|
|
|
## Prerequisites
|
|
|
|
- Node.js 18+
|
|
- Python 3.10+
|
|
- npm 9+
|
|
- Supabase account
|
|
- Replicate account
|
|
|
|
## Setup
|
|
|
|
See [SETUP.md](./SETUP.md) for detailed instructions.
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
# Clone & Install
|
|
git clone <your-repo>
|
|
cd wan-pwa
|
|
npm install
|
|
|
|
# Start all services
|
|
npm run dev
|
|
|
|
# Frontend: http://localhost:3000
|
|
# Backend: http://localhost:8000
|
|
```
|
|
|
|
## Development Commands
|
|
|
|
```bash
|
|
npm run dev # Start all services
|
|
npm run build # Build all packages
|
|
npm run lint # Lint all packages
|
|
npm run test # Run all tests
|
|
npm run clean # Clean build artifacts
|
|
npm run format # Format code with Prettier
|
|
```
|
|
|
|
## Deployment
|
|
|
|
- Frontend: Vercel
|
|
- Backend: Modal or Railway
|
|
- Database: Supabase
|
|
|
|
See [DEPLOYMENT.md](./DEPLOYMENT.md) for detailed instructions.
|
|
|
|
## Project Roadmap
|
|
|
|
- [x] Monorepo setup
|
|
- [ ] Authentication flows
|
|
- [ ] Prompt template system
|
|
- [ ] T2V generation
|
|
- [ ] I2V generation
|
|
- [ ] Batch processing
|
|
- [ ] Payment integration
|
|
- [ ] Mobile app
|
|
|
|
## Contributing
|
|
|
|
See [CONTRIBUTING.md](./CONTRIBUTING.md)
|
|
|
|
## License
|
|
|
|
MIT License - see [LICENSE](./LICENSE)
|