Legacy Version: This is version 0.0.6 which requires authentication for all operations. Consider upgrading to version 0.0.7+ for free single file conversions and enhanced features.

What is next-lovable v0.0.6?

A CLI tool that automatically converts your React applications to Next.js 13+ using the new App Router. This legacy version provides full project migration capabilities with API-based processing.

​
Key Features

Complete Project Migration

Full React to Next.js App Router conversion

Smart Router Conversion

React Router to Next.js navigation transformation

Vite to Next.js Migration

Seamlessly migrates from Vite build system

Intelligent Components

Automatically adds ‘use client’ directives where needed

​
Get Started

1

Install the CLI

npm install -g next-lovable@0.0.6
2

Preview your migration

next-lovable ./my-react-app --dry-run
3

Run the migration

next-lovable ./my-react-app ./my-next-app --yes --install

​
Documentation

Installation Guide

Setup and authentication instructions

Quick Start

Your first migration in 5 minutes

Migration Command

Complete command reference

Troubleshooting

Common issues and solutions

Upgrade to v0.0.7+

Enhanced features and free conversions

​
What You Can Do

​
Full Project Migration (Authentication Required)

Complete Migration

Convert entire React applications to Next.js

Preview Changes

See exactly what will change before applying

​
What Gets Converted

​
Command Reference

TaskCommandAuthenticationCredits
Preview migrationnext-lovable ./app --dry-run✅ Yes❌ No
Full migrationnext-lovable ./app ./next-app✅ Yes✅ Yes

​
Real-World Example

// src/App.tsx
import { BrowserRouter, Routes, Route } from 'react-router-dom';
import Home from './pages/Home';
import About from './pages/About';

function App() {
  return (
    <BrowserRouter>
      <Routes>
        <Route path="/" element={<Home />} />
        <Route path="/about" element={<About />} />
      </Routes>
    </BrowserRouter>
  );
}

export default App;

​
Version 0.0.6 Limitations

Important Limitations:
  • Authentication required for all operations
  • Credit consumption for all migrations
  • No single file mode - only full project migration
  • Limited error recovery compared to newer versions
  • Simpler CLI without subcommands

​
Why Upgrade to v0.0.7+?

Free Features

Single file conversions without authentication

Better CLI

Subcommand structure with more control

Enhanced Performance

Faster processing and better error handling

Granular Control

Choose specific transformations to apply
Migration Path: Existing v0.0.6 users can easily upgrade to the latest version for enhanced features and free single file conversions.

​
Command Structure

Version 0.0.6 uses a simple command structure: 
# Basic migration
next-lovable <source-directory> [target-directory]

# With options
next-lovable ./my-app ./next-app --dry-run --yes --install

​
Available Options

  • --dry-run, -d - Preview changes without making them
  • --yes, -y - Skip confirmation prompts
  • --install, -i - Install dependencies after migration

​
🔧 Prerequisites

1

Node.js 16+

Version 0.0.6 requires Node.js 16.x or higher
2

React Project

A React application using React Router
3

nextlovable.com Account

Required for authentication and API access
4

Active Credits

Migration operations consume credits

​
Need Help?

Done for you

We’ll convert your beautiful Lovable app into a lightning-fast, SEO-ready website that actually shows up in search results. No coding required.

​
Ready to Migrate?

Start with v0.0.6

Use the current legacy version

Upgrade to Latest

Get enhanced features and free conversions
Legacy Support: While v0.0.6 continues to work, we recommend upgrading to version 0.0.7+ for the best experience with free features and enhanced capabilities.

​
What Gets Converted

​
React Router → Next.js Router

import { Link, useNavigate, useLocation } from 'react-router-dom';

export const Navigation = () => {
  const navigate = useNavigate();
  const location = useLocation();

  return (
    <nav>
      <Link to="/dashboard">Dashboard</Link>
      <Link to={`/profile/${userId}`}>Profile</Link>
      <button onClick={() => navigate('/settings')}>Settings</button>
      <p>Current: {location.pathname}</p>
    </nav>
  );
};

​
React Helmet → Next.js Head

import { Helmet } from 'react-helmet';

export const PageMeta = ({ title, description }) => (
  <Helmet>
    <title>{title}</title>
    <meta name="description" content={description} />
  </Helmet>
);

​
Command Comparison Table

TaskCommandCredits RequiredAuthentication
Preview project migrationnext-lovable migrate ./my-app --dry-run❌✅ Yes
Full project migrationnext-lovable migrate ./my-app ./next-app✅ Yes✅ Yes

​
⚠️ Important Notes

Version 0.7+: Uses new subcommand structure (migrate, convert)Version 0.6 and earlier: Uses legacy command format
Always backup your original project before running a full migration!

​
Limitations & Best Practices

​
Known Limitations

  • Complex custom route configurations may need manual adjustments
  • Dynamic route parameters might require review
  • Some third-party integrations may need updates
  • Complex state management setups might need fine-tuning

​
Best Practices

  1. Always test individual files first using the free convert command
  2. Run --dry-run before any actual migration
  3. Keep backups of your original project
  4. Review generated files before deployment
  5. Test thoroughly after migration

​
Getting Help

List Available Commands

next-lovable --help
Ready to migrate your React app to Next.js? Start with a simple file conversion to see the magic in action! 🚀