Zengtudor/Wan2.1
1
0
Fork 0
mirror of https://github.com/Wan-Video/Wan2.1.git synced 2025-11-03 05:52:18 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
576864de25
Wan2.1/wan-pwa
History
Claude e9fc673b3c
fix: resolve React version conflict for Vercel deployment 
Fixed dependency resolution error that was preventing Vercel builds
from completing successfully.

## Problem
Vercel build failed with:
```
npm error ERESOLVE unable to resolve dependency tree
npm error Could not resolve dependency:
npm error peer react@"^18.2.0 || 19.0.0-rc-66855b96-20241106" from next@15.0.3
```

React 19 stable (19.2.0) was being resolved, but Next.js 15.0.3 only
supports React 18.2.0 or specific React 19 RC versions.

## Solution

### 1. Downgraded React to 18.2.0 (Stable)
- Changed react from ^19.0.0-rc.0 → ^18.2.0
- Changed react-dom from ^19.0.0-rc.0 → ^18.2.0
- React 18.2.0 is fully stable and compatible with Next.js 15.0.3

### 2. Added .npmrc Configuration
- Configured npm for optimal Vercel builds
- Disabled legacy-peer-deps (not needed with correct versions)
- Enabled auto-install-peers for smooth dependency resolution
- Performance optimizations for CI/CD environment

### 3. Added vercel.json Configuration
- Optimized build command for monorepo structure
- Configured environment variable references
- Set preferred region (iad1 - Washington DC)
- Framework detection for Next.js

## Files Changed
- apps/web/package.json - React version downgrade
- .npmrc - npm configuration for Vercel
- apps/web/vercel.json - Vercel deployment config

## Testing
Build should now complete successfully on Vercel with:
- npm install ✅
- npm run build ✅
- Next.js production build ✅

## Notes
- React 18.2.0 is the recommended stable version for Next.js 15
- All shadcn/ui components are compatible with React 18
- No breaking changes in application code required
- When Next.js 16 releases, we can upgrade to React 19 stable

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-24 14:55:30 +00:00
..
apps fix: resolve React version conflict for Vercel deployment 2025-10-24 14:55:30 +00:00
packages/db feat: Implement Phase 3 - Backend Integration & Critical Polish 2025-10-24 14:36:07 +00:00
.eslintrc.js chore: add configuration files for monorepo setup 2025-10-24 14:19:02 +00:00
.gitignore feat: Add complete Wan2.1 PWA - AI Video Generation Platform 2025-10-24 14:18:18 +00:00
.npmrc fix: resolve React version conflict for Vercel deployment 2025-10-24 14:55:30 +00:00
.prettierrc chore: add configuration files for monorepo setup 2025-10-24 14:19:02 +00:00
CONTRIBUTING.md feat: Add complete Wan2.1 PWA - AI Video Generation Platform 2025-10-24 14:18:18 +00:00
DEPLOYMENT.md feat: Add complete Wan2.1 PWA - AI Video Generation Platform 2025-10-24 14:18:18 +00:00
LICENSE feat: Add complete Wan2.1 PWA - AI Video Generation Platform 2025-10-24 14:18:18 +00:00
MCP_SERVER_SETUP.md docs: add MCP Server setup guide for Claude Desktop integration 2025-10-24 14:45:06 +00:00
package.json chore: add configuration files for monorepo setup 2025-10-24 14:19:02 +00:00
PHASE_3_IMPLEMENTATION.md feat: Implement Phase 3 - Backend Integration & Critical Polish 2025-10-24 14:36:07 +00:00
PROJECT_SUMMARY.md feat: Add complete Wan2.1 PWA - AI Video Generation Platform 2025-10-24 14:18:18 +00:00
README.md feat: Add complete Wan2.1 PWA - AI Video Generation Platform 2025-10-24 14:18:18 +00:00
SETUP.md feat: Add complete Wan2.1 PWA - AI Video Generation Platform 2025-10-24 14:18:18 +00:00
turbo.json chore: add configuration files for monorepo setup 2025-10-24 14:19:02 +00:00

README.md

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 for detailed instructions.

Quick Start

# 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

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 for detailed instructions.

Project Roadmap

  • Monorepo setup
  • Authentication flows
  • Prompt template system
  • T2V generation
  • I2V generation
  • Batch processing
  • Payment integration
  • Mobile app

Contributing

See CONTRIBUTING.md

License

MIT License - see LICENSE