What is next-lovable?
A smart CLI tool that automatically converts your React applications to Next.js 14+ using the new App Router. It specializes in migrating React Router applications with zero manual work.
Key Features
Smart Router Conversion
Automatically converts React Router to Next.js App Router
Free Single File Testing
Test individual components without credits or authentication
Vite to Next.js Migration
Seamlessly migrates from Vite build system to Next.js
Intelligent Components
Automatically adds ‘use client’ directives where needed
Get Started in 2 Minutes
1
Install globally
2
Try your first conversion (free!)
3
Apply the conversion
No account needed for single file conversions! Perfect for testing and learning.
Documentation
Installation Guide
System requirements and setup instructions
Quick Start
Your first conversion in 5 minutes
Convert Command
Free file conversion (no auth required)
Migrate Command
Full project migration (requires account)
Troubleshooting
Common issues and solutions
Best Practices
Tips for successful migrations
What You Can Do
Free Features (No Auth Required)
Single File Conversion
Convert individual React files to Next.js format
Preview Changes
See exactly what will change before applying
Premium Features (Account Required)
Full Project Migration
Convert entire React applications to Next.js
Batch Processing
Convert multiple files and directories at once
What Gets Converted
React Router → Next.js Navigation
React Router → Next.js Navigation
React Helmet → Next.js Head
React Helmet → Next.js Head
<Helmet>
→<Head>
fromnext/head
- Meta tags and title preservation
- SEO attributes maintained
Client Component Detection
Client Component Detection
- Automatic “use client” directive addition
- Detects React hooks, event handlers, browser APIs
- Maintains server/client component boundaries
Context Provider Migration
Context Provider Migration
- Converts React Context providers
- Maintains context functionality in Next.js structure
- Preserves type safety
Quick Command Reference
Task | Command | Credits | Auth |
---|---|---|---|
Test conversion | next-lovable convert file.tsx --dry-run | ❌ Free | ❌ No |
Convert file | next-lovable convert file.tsx | ❌ Free | ❌ No |
Preview migration | next-lovable migrate ./app --dry-run | ✅ Yes | ✅ Yes |
Full migration | next-lovable migrate ./app ./next-app | ✅ Yes | ✅ Yes |
Real-World Example
Important Notes
Version 0.7+: Uses new subcommand structure (
convert
, migrate
)Version 0.6 and earlier: Uses legacy command formatStart with the free
convert
command to get familiar with the tool before migrating entire projects.Need Help?
Ready to migrate your React app to Next.js? Start with a quick conversion →