What you get on v2
The upgrade is opt-in, and the new architecture is faster to work in:- Faster builds and reloads. Projects load and rebuild noticeably quicker.
- Cleaner code organization. A component-based structure with clearer imports and dependencies, so the agent (and you) can find things faster.
Upgrading creates a copy of your project on v2. The original is left untouched and stays open and editable, so there’s no risk in trying it.
Before you upgrade
The upgrade is safe to try: it copies your project and leaves the original alone. But a v2 copy is a brand-new project, so before you move a live app over, read these first. A few things worth knowing before you start:- Your live URL moves only if you bring the domain. Choose your domain during the upgrade if you want the live site to point at the v2 copy. Skip it and the original keeps serving traffic.
- The original stays put. Nothing is deleted. You can keep building on the older project, compare the two, or fall back at any time.
- You can migrate the rest later. If you skip your domain, database, or users the first time, run the upgrade again to include them.
How to upgrade
If a project is eligible, you’ll see an Upgrade to v2 button in the builder header. Older projects also show a “legacy” badge on your dashboard so you can tell at a glance which ones haven’t moved yet.Open the project and click Upgrade to v2
The button sits in the builder header for any project that’s still on the older architecture and that you can edit.
Choose what to bring over
Pick the resources to copy into the new project. You can bring over your:
- Domain, so your live URL points at the upgraded project
- Database, including every table, row, and your schema
- Users and authentication, including accounts, sessions, and auth configuration
Review and confirm
You’ll see a summary of the project name and exactly what’s going to transfer. When it looks right, click Start Migration.
What transfers
The upgrade creates a fresh v2 project and copies over what you select.| Resource | What moves |
|---|---|
| Domain | Your custom domain or *.anything.app URL points at the upgraded project |
| Database | All tables, rows, and schema, copied to the new project |
| Users and authentication | User accounts, sessions, and auth configuration |
| Code | Rewritten into the new component-based structure |
Migrating users carries your existing logins across. Password-based users keep their passwords and can sign in on the upgraded project without resetting them.