next-lovable 0.0.48 → 0.0.49

package/README.md

@@ -1,24 +1,28 @@
 # next-lovable
 
-A CLI tool to migrate React applications to Next.js 13+ (App Router).
+An intelligent CLI tool to automatically migrate React applications to Next.js 13+ (App Router), specializing in React Router to App Router conversions.
 
-## Features
+## Key Features
 
-- Converts React Router routes to Next.js App Router
-- Migrates from Vite to Next.js build system
-- Handles package.json dependencies
-- Preserves existing components and layouts
-- Adds necessary Next.js configuration files
-- Supports TypeScript projects
+- 🚀 Smart React Router to Next.js App Router conversion
+- 📦 Automated migration from Vite to Next.js build system
+- 🔄 Intelligent component transformation with 'use client' directives
+- 🎯 Automatic handling of:
+  - Route configurations
+  - Layouts and page structures
+  - Package dependencies
+  - React Helmet to Next.js Metadata
+  - Client/Server component separation
 
 ## Prerequisites
 
 - Node.js 18.x or higher
 - npm or yarn
+- A nextlovable.com account
 - A React project using:
   - React Router
-  - Vite (as build tool)
-  - TypeScript (optional)
+  - Vite
+  - TypeScript (optional but recommended)
 
 ## Installation
 
@@ -26,87 +30,98 @@ A CLI tool to migrate React applications to Next.js 13+ (App Router).
 npm install -g next-lovable
 ```
 
+## Authentication
+
+The tool requires authentication with your nextlovable.com account:
+- Login will be prompted on first use
+- Sessions are securely stored for future use
+- Automatic token refresh handling
+
 ## Usage
 
-Basic usage:
+### Basic Command
+
 ```bash
 next-lovable <source-directory> [target-directory]
 ```
 
-Test migration without making changes or using credit:
+### Dry Run Mode (Recommended First Step)
+
 ```bash
 next-lovable ./my-react-app --dry-run
 ```
 
-The `--dry-run` (or `-d`) option simulates the migration process without making actual changes. This is useful to:
-- Validate your project structure
-- Check for potential conversion errors
-- Preview file modifications
-- Avoid using conversion credits unnecessarily
-- Get a report of all changes that would be made
+The `--dry-run` option provides:
+- 🔍 Complete project analysis
+- 📝 Detailed migration report
+- ⚠️ Potential issue warnings
+- 📊 List of files to be modified
+- 🎯 Preview of transformations
+- 0️⃣ No actual changes made
 
+### Full Migration
 
-With options:
 ```bash
 next-lovable ./my-react-app ./next-app --yes --install
 ```
 
-### Options
+### Available Options
 
 - `-y, --yes`: Skip confirmation prompts
 - `-i, --install`: Install dependencies after migration
+- `-d, --dry-run`: Simulation mode without changes
 - `--help`: Show help information
-- `--d, --dry-run`: Run migration in simulation mode without making actual changes. Shows what files would be created/modified.
 
-### Examples
+## Migration Process
 
-1. Basic migration:
-```bash
-next-lovable ./my-react-app
-```
+1. **Authentication & Validation**
+   - Account verification
+   - Project structure validation
+   - Dependencies check
 
-2. Specify target directory:
-```bash
-next-lovable ./my-react-app ./converted-app
-```
+2. **Smart Analysis**
+   - Route structure analysis
+   - Component classification
+   - Context provider detection
+   - Client/Server boundary identification
 
-3. Non-interactive migration with dependency installation:
-```bash
-next-lovable ./my-react-app --yes --install
-```
+3. **Automated Transformations**
+   - React Router to App Router conversion
+   - Layout structure creation
+   - Component migrations
+   - Dependency updates
+   - Configuration generation
 
-## Migration Process
+4. **Post-Migration Setup**
+   - Next.js configuration
+   - TypeScript adjustments
+   - Development environment setup
 
-1. **Setup and Validation**
-   - Validates source project
-   - Creates target directory
+## Intelligent Features
 
-2. **Project Structure**
-   - Copies project files
-   - Restructures directories to Next.js format
-   - Converts route structure
+- 🧠 Smart component analysis for 'use client' directives
+- 🔄 Automatic context provider migration
+- 📱 Layout preservation and enhancement
+- 🛠️ Dependency resolution and cleanup
+- 🎯 Typescript support and type preservation
 
-3. **Code Transformation**
-   - Adds 'use client' directives
-   - Updates import paths
-   - Converts router code
-   - Creates Next.js page files
+## Post-Migration
 
-4. **Configuration**
-   - Updates package.json
-   - Creates Next.js config files
-   - Sets up root layout
+1. Review generated files in `src/app`
+2. Test with `npm run dev`
+3. Check converted routes
+4. Verify component functionality
 
-## Post-Migration Steps
+## Limitations
 
-1. Review generated files in `src/app`
-2. Check component imports and paths
-3. Update any remaining router-specific code
-4. Test the application with `npm run dev`
+- 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
 
-## Known Limitations
+## Best Practices
 
-- Complex React Router configurations may need manual adjustment
-- Custom route handling might require additional setup
-- State management libraries may need manual updates
-- Some components might need manual 'use client' directive additions
+1. Always run `--dry-run` first
+2. Keep a backup of your original project
+3. Review generated files before deployment
+4. Test thoroughly after migration

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-lovable",
-  "version": "0.0.48",
+  "version": "0.0.49",
   "description": "Cross-platform tool to migrate Lovable React projects to Next.js",
   "main": "./dist/index.js",
   "homepage": "https://nextlovable.com",