docs: migration guide

[GalacticHypernova]

🔗 Linked issue

❓ Type of change

• 📖 Documentation (updates to the documentation or readme)
• 🐞 Bug fix (a non-breaking change that fixes an issue)
• 👌 Enhancement (improving an existing functionality)
• ✨ New feature (a non-breaking change that adds functionality)
• 🧹 Chore (updates to the build process or auxiliary tools and libraries)
• ⚠️ Breaking change (fix or feature that would cause existing functionality to change)

📚 Description

Work in progress migration guide from Nuxt UI v2 to Nuxt UI v3. None of the phrasing is final and is likely to change as I gather everything necessary and as it gets refined

📝 Checklist

• I have linked an issue or discussion.
• I have updated the documentation accordingly.

[pkg-pr-new]

npm i https://pkg.pr.new/@nuxt/ui@2871

commit: 09d4b64

[GalacticHypernova]

@benjamincanac should I also include UI Pro changes in here or keep it a separate migration guide? If the latter, I may need a little bit of help with the module selection 😅

[benjamincanac]

We can just do Nuxt UI for now and later on we'll either make another page for UI Pro or integrate it in the same page with the :module-only component.

[GalacticHypernova]

Sounds good to me! I'll start testing components to see what was changed, hopefully I'll find it all

[GalacticHypernova]

Hey @benjamincanac ! Is there anything else I missed? Or was the color palette transition the last change that was yet to be added to the PR? If I missed anything please do let me know!

[benjamincanac]

@GalacticHypernova I would say there are tons of things missing 😬 You didn't mention anything about the different installation, theming, Tailwind CSS v4 using css-first config instead of js file, props change, app.config.ts change, etc.

But I can continue this when I'm done with Nuxt UI Pro v3 no worries 😊

[GalacticHypernova]

Oh my, you're right. I am so sorry, I indeed forgot about the props, theming, and app.config changes. I was mainly going off of what I had personally tested so I now realize that it is very likely I only encountered a small chunk. I actually just went over the recent releases and noticed some breaking changes, but I don't know which of them were from v2 to v3 and which were from earlier v3 to later v3. I'll go over it tomorrow and take care of all them. Sorry again!
Though regarding the Tailwind changes, I assume we should just link to their upgrade guide as it's technically not a change in Nuxt UI.