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.
The Escape Hatch
Infrastructure Independence
Use our Chrome Extension to migrate from Lovable’s proprietary Supabase instance to your own Supabase project. Full data ownership, custom RLS policies, and production-ready infrastructure. Self-service migration completes in under 5 minutes.
Two Tiers: Choose Your Complexity
Self-Service: $99
Best for: MVPs, side projects
- Up to 50 tables
- Standard auth only
- Automatic migration via Chrome Extension
- DIY troubleshooting
- Completes in under 5 minutes
White-Glove: €850+
Best for: Production apps
- Unlimited complexity
- External APIs & webhooks (Stripe, OpenAI, etc.)
- Complex RLS policies
- We handle edge cases
- Custom SQL triggers
- Priority support
Quick Check: Which Tier Fits You?
- I have fewer than 50 tables
- No complex external integrations (Stripe, OpenAI, etc.)
- I can handle manual fixes if needed
Prerequisites
Check Your Project Size
Not sure if your project is “simple” or “complex”?If you have 100+ tables or integrations with Stripe, OpenAI, or other external APIs, skip to the White-Glove option.
Prepare Your Supabase Project
Create a new Supabase project at supabase.com if you haven’t already.You’ll need these credentials (used locally only):
Project Reference ID
Project Reference ID
Location: Supabase Dashboard → Settings → GeneralLooks like:
abc123def456Personal Access Token (PAT)
Personal Access Token (PAT)
Location: Supabase Dashboard → Account → Access TokensUsed for authentication with the Extension
Anon Key (Public)
Anon Key (Public)
Location: Supabase Dashboard → Settings → API → Project API KeysThe
anon public keyService Role Key (Secret)
Service Role Key (Secret)
Location: Supabase Dashboard → Settings → API → Project API KeysThe
service_role key. Keep this secret!Your credentials are used locally only — they’re never sent or stored anywhere. Complete privacy guaranteed.
The Migration Process
1. Install Extension & Connect
Install the Lovable Cloud to Supabase Chrome Extension and connect your credentials.Install Extension →
2. Automatic Migration
Once connected, the extension clones your Lovable Cloud setup and deploys it to Supabase automatically.What’s migrated:
- Database Schema — Tables & rows
- Edge Functions — Serverless logic
- Authentication — Users & permissions
Migration typically completes in under 5 minutes. You’ll receive a notification when it’s ready.
What’s Included
Complete Database Migration
Complete Database Migration
Every table, every row, every relationship:
- PostgreSQL schema recreation
- Data integrity validation
- Index and constraint preservation
- Enum and custom type migration
Edge Functions
Edge Functions
Serverless logic preserved:
- Function code migration
- Environment variables
- Secrets management
- Trigger reconfiguration
Authentication System
Authentication System
User accounts transferred:
- Email/password accounts
- User metadata preservation
- OAuth provider identities (reconfiguration required)
- Password reset flow guidance
What’s NOT Included (Manual Steps)
Storage Buckets & Files
Storage Buckets & Files
Storage is NOT automatically migrated.After migration, you’ll need to:
- Create new storage buckets in your Supabase
- Upload files manually or via script
- Update file references in your database
Complex RLS Policies
Complex RLS Policies
Standard RLS policies migrate automatically.Complex policies may need manual review:
- Policies with custom SQL functions
- Multi-table policy dependencies
- Complex permission logic
External API Integrations
External API Integrations
Third-party services require manual reconfiguration:
- Stripe webhooks
- OpenAI API keys
- Custom payment processors
- External auth providers
Post-Migration Checklist
After migration completes, complete these steps to go live:1. Update AI/API Keys
If your project uses AI features:
- Move to OpenRouter (recommended) or your preferred provider
- Update your API key in Supabase environment variables
2. Recreate Environment Variables
Copy your environment variables from Lovable to Supabase:
- Go to Supabase Dashboard → Settings → API
- Add all required env vars
3. Re-enable Social Auth
OAuth providers need reconfiguration:
- Google, GitHub, Apple, etc.
- Update callback URLs to your Supabase project
- Test login flow
4. Migrate Storage (Manual)
Move files to Supabase Storage:
- Create buckets matching your old structure
- Upload files
- Update database references
Need Help with Complex Logic?
White-Glove Migration: €850+
If your project has:
- 100+ tables
- Stripe, OpenAI, or other external integrations
- Complex custom SQL
- Custom RLS policies
Next Steps
Get the Extension
Start your $99 Self-Service migration
White-Glove Service
Book consultation for complex migrations
Post-Migration Guide
Complete your migration setup
Just need the frontend code? Start with the CLI to convert your React app to Next.js first.
