Upgrade to wheels 3

[michaeldiederich]

Congratulations for publishing version 3! Hooray!

I checked the documentation for upgrading (https://wheels.dev/3.0.0/guides/introduction/upgrading). Are there any best practices, you could share?

Especially the part with the tests - we have right now >1200 unit tests. Does the migration to TestBox needs to made by hand or is there any migrator?

[bpamiri]

Michael,There is no migrator at the moment. But I could imagine trying to make one this year. Zain may be able to chime in on best practices.-Peter Amiri Sent from my iPhone (auto-typing mispell disclaimer in effect)On Jan 16, 2026, at 5:22 AM, Michael Diederich ***@***.***> wrote: Congratulations for publishing version 3! Hooray! I checked the documentation for upgrading (https://wheels.dev/3.0.0/guides/introduction/upgrading). Are there any best practices, you could share? Especially the part with the tests - we have right now >1200 unit tests. Does the migration to TestBox needs to made by hand or is there any migrator? —Reply to this email directly, view it on GitHub, or unsubscribe.You are receiving this because you are subscribed to this thread.Message ID: ***@***.***>

[zainforbjs]

Thanks, @michaeldiederich — and congrats on having such a solid test suite 👏

At the moment, there’s no automated migrator for converting existing tests to TestBox, so the migration does need to be done by hand. With large suites (like 1,200+ tests), the approach that’s worked best is to migrate incrementally rather than attempting a big-bang rewrite.

A few best practices we’ve seen work well:

• Upgrade the application structure and runtime code to Wheels 3 first, without touching tests.
• Once the app is stable, start migrating tests gradually.
• Prioritize high-value or frequently run tests to get early confidence.
• Treat the migration as a chance to simplify or remove brittle tests.

A TestBox migrator is something I’d like to explore this year, but there’s nothing available today and no fixed timeline yet.

Happy to answer any specific questions as you go through the upgrade.