Upgrade a project to TanStack Start
You can upgrade an older Lovable project to the TanStack Start framework so its pages build on the server. This gives you faster loading, working social media preview cards, and better search visibility without changing your design.
Anyone editing an older Lovable app built on React and Vite who needs better search visibility, working link previews, or newer features.
Do this, in order
- 1
Type 'What stack is this project on?' into your project chat to confirm whether your app is on the older React + Vite setup.
Newer projects already use TanStack Start, so you should make sure an upgrade is actually needed.
- 2
Type '/' in the chat and choose 'Migrate to TanStack Start', or go to Project Settings under General to find 'Migrate to TanStack Start'.
This opens the migration dialog without changing any code yet.
- 3
Select 'Start migration' on the confirmation card to begin the process.
Lovable requires your explicit approval before rewriting the project files and spending build credits.
- 4
Watch the chat and tell Lovable to 'continue' if it pauses on a larger project.
Large apps may exceed a single run, so Lovable will report what is finished and wait for your go-ahead to keep going.
- 5
Test your pages in the preview, then publish your project when you are satisfied, or restore from version history if you want to undo.
The upgrade only affects your draft project; your live visitors will not see the changes until you hit publish.
Paste this into your project
Upgrade my app to TanStack Start so my pages render on the server and my link previews work.
Words decoded
- Server-side rendering (SSR)
- Building the full, finished webpage on the server before sending it to the user, rather than sending a blank page that the browser has to assemble itself.
- TanStack Start
- The modern underlying framework Lovable uses to build apps that render on the server.
- Vite
- The older foundation Lovable used, which built pages inside the visitor's browser instead of on the server.
Where people get stuck
- Your live site will not show the improvements until you manually publish the project after the upgrade completes.
- Upgrading consumes standard build credits (usually 10 to 35 credits), so a low credit balance can cause the process to stop partway through.
- Some third-party tools or code packages only work inside a browser and might cause a blank page or error until you ask Lovable to fix them for server rendering.
- Link previews on sites like Slack or LinkedIn might still look old immediately after publishing because those platforms temporarily save old preview images in their cache.
The short version, steps, decoder and prompt on this page are written automatically from Lovable's own documentation and can lag or misread it. The official page is always the authority.