Overview
The Lovable build with URL allows you to programmatically create applications by passing prompts and images via URL parameters. This enables direct integration with Lovable’s app generation capabilities.What to use it for
You can do the following with build with URL:- Implement a build with Lovable button in your application or on your website.
- Generate a link with your favourite prompt to share with friends, collegues, or post on social.
Link Generator
For a simple link generation experience go to the Lovable Links tool. You write your prompt and upload images. The Lovable Link tool returns a URL you can share to generate an application with the same prompt and images.Base URL
autosubmit
(boolean): Must be set to true
to automatically process the request
URL with Parameters
Parameters
Required Parameters
prompt
(string): Description of the application you want to build
Optional Parameters
images
(string): URL-encoded image URLs to include as references (can be specified multiple times)
Example Usage
Basic App Generation
With Reference Images
Multiple Images
Limitations
Image Requirements
- Images must be publicly accessible URLs.
- You can attach a maximum of 10 images.
- Prompt cannot be longer than 50k characters. Very long URLs might break.
- Supported formats: Common web image formats (JPEG, PNG, and WebP)
Authentication
- If user is already logged in: Project creates immediately
- If user is not logged in: Redirected to signup, then autosubmit triggers after authentication. Parameters are preserved through the entire signup/login flow
Best Practices
- Keep prompts concise: Focus on core functionality and key features
- Use descriptive language: Clear descriptions yield better results
- Include reference images: Visual examples help guide the generation process
- Test URL encoding: Ensure special characters in URLs are properly encoded
Error Handling
If the URL is malformed or exceeds length limits, you may encounter:- Browser “URL too long” errors
- Incomplete parameter parsing
- Failed autosubmission