- Auditoría: Inventario de componentes, mixins, filtros, plugins y dependencias
- Build de compatibilidad: Vue 3 tiene un modo
@vue/compatque emula Vue 2 y muestra advertencias - Migración incremental:
- Primero: actualizar el tooling de build (Webpack → Vite)
- Segundo: eliminar las APIs obsoletas (filtros, event bus
$on/$off,$listeners) - Tercero: migrar Options API → Composition API componente a componente
- Cuarto: mixins → composables
- Quinto: Vuex → Pinia (o Vuex 4 como paso intermedio)
- Tests en cada paso: Los tests existentes deben seguir pasando
- Zonas de riesgo: Librerías de terceros, directivas personalizadas, render functions, plugins
El build de compatibilidad permite hacerlo de forma incremental. La clave es no intentar migrar todo a la vez. Componente a componente, con tests en cada paso.