> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nextlovable.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Quick Start
> Get up and running with next-lovable 0.0.6 in 5 minutes
**Version 0.0.6**: This version requires authentication for all operations. Consider upgrading to 0.0.7+ for free single file conversions.
## Prerequisites
Before you begin, make sure you have:
Create an account at [nextlovable.com](https://nextlovable.com)
## Your First Migration
Let's start with migrating a simple React project:
### Step 1: Prepare Your React Project
Make sure you have a React project with React Router. Here's a sample structure:
```bash theme={null}
my-react-app/
├── src/
│ ├── App.tsx
│ ├── components/
│ │ └── Navigation.tsx
│ └── pages/
│ ├── Home.tsx
│ └── About.tsx
├── package.json
└── vite.config.js
```
### Step 2: Preview the Migration (Dry Run)
See what changes will be made without modifying anything:
```bash theme={null}
next-lovable ./my-react-app --dry-run
```
Expected output
You'll see a summary of:
* Files that will be converted
* React Router patterns found
* Components that need 'use client' directives
* New Next.js file structure
### Step 3: Execute the Migration
Run the actual migration:
```bash theme={null}
next-lovable ./my-react-app ./my-next-app --yes --install
```
This will:
* Create a new Next.js project in `./my-next-app`
* Convert React Router to Next.js App Router
* Add 'use client' directives where needed
* Install all dependencies
* Set up the proper Next.js configuration
### Step 4: Review and Test
```bash theme={null}
cd my-next-app
```
```bash theme={null}
npm run dev
```
Visit [http://localhost:3000](http://localhost:3000) to see your migrated app
## Command Structure (v0.0.6)
Version 0.0.6 uses a simpler command structure:
```bash Basic Migration theme={null}
next-lovable [target-directory]
```
```bash With Options theme={null}
next-lovable ./my-app ./next-app --dry-run --yes --install
```
### Available Options
Path to your React application
Where to create the new Next.js project (optional)
Simulate migration without making changes
Skip confirmation prompts
Install dependencies after migration
## What Gets Converted
* `useNavigate()` → `useRouter()`
* `` → ``
* `useLocation()` → `usePathname()`
* Route structure converted to App Router
* Automatic 'use client' directive addition
* Page components moved to app directory
* Layout components properly structured
* Vite config → Next.js config
* Package.json scripts updated
* Dependencies migrated
## Example Migration
```tsx Before (React Router) theme={null}
// src/App.tsx
import { BrowserRouter, Routes, Route } from 'react-router-dom';
import Home from './pages/Home';
import About from './pages/About';
function App() {
return (
} />
} />
);
}
export default App;
```
```tsx After (Next.js App Router) theme={null}
// app/layout.tsx
export default function RootLayout({
children,
}: {
children: React.ReactNode;
}) {
return (
{children}
);
}
// app/page.tsx
export default function Home() {
return
Home Page
;
}
// app/about/page.tsx
export default function About() {
return
About Page
;
}
```
## Limitations in v0.0.6
**Version 0.0.6 Limitations**:
* Requires authentication for all operations
* No single file conversion mode
* Limited transformation options
* No granular control over conversions
## Upgrade Benefits
Consider upgrading to version 0.0.7+ for:
Single file conversions without authentication
Granular transformation options
Subcommand structure (convert, migrate)
Faster processing and better error handling
## Common Issues
1. Check source directory permissions
2. Ensure target directory is writable
3. Verify sufficient disk space
4. Review error messages for specific issues
1. Run `npm install` in the target directory
2. Check for TypeScript errors
3. Review Next.js configuration
4. Clear Next.js cache: `rm -rf .next`
## What's Next?
Review how your React components were converted
Navigate through your app to ensure everything works
Deploy your new Next.js app to your preferred platform
Upgrade to version 0.0.7+ for enhanced features
Detailed CLI documentation
Common issues and solutions
Upgrade for more features