## Summary This epic tracks the Vue 3 migration of every page entrypoint owned by `group::project management`, as part of the parent epic gitlab-org&23003. 🗂️ Each entrypoint moves through three states: 1. **Vue 2** 🔴 The page has no `vue3_migration.yml` sibling file. The page builds and serves Vue 2 only. 2. **Rollout** 🟡 The page has `status: rollout`. Both the `<entry>` and `<entry>.vue3` bundles are built. A feature flag decides which one is served at request time. 3. **Migrated** 🟢 The page has `status: migrated`. Vue 3 builds under the original entry name. The feature flag is gone. Migration steps per page are documented in the [Vue 3 migration guide](https://docs.gitlab.com/development/fe_guide/vue3_migration/#option-1-recommended-migrate-your-page-entrypoint-using-a-feature-flag-and-vue3_migrationyml). ## Status at a glance 📊 | State | Count | Share | | --- | --- | --- | | 🟢 Migrated | 0 | 0% | | 🟡 Rollout | 33 | 73% | | 🔴 Vue 2 | 12 | 27% | | Total | 45 | 100% | ## 🟡 On rollout (33) | Group | Entrypoint | Reference | | --- | --- | --- | | Work items and issues | `pages.projects.work_items` | `vue3_migrate_work_items` flag | | Work items and issues | `pages.groups.work_items` | `vue3_migrate_work_items` flag | | Work items and issues | `pages.groups.work_items.show` | `vue3_migrate_work_items` flag | | Work items and issues | `pages.projects.issues.show` | `vue3_migrate_work_items` flag | | Work items and issues | `pages.projects.issues.service_desk` | `vue3_migrate_work_items` flag | | Work items and issues | `pages.projects.saved_views.show` | `vue3_migrate_work_items` flag | | Work items and issues | `pages.groups.saved_views.show` | `vue3_migrate_work_items` flag | | Dashboards | `pages.dashboard.issues` | gitlab-org/gitlab#608106 | | Dashboards | `pages.dashboard.work_items` | gitlab-org/gitlab#608106 | | Dashboards | `pages.dashboard.todos.index` | gitlab-org/gitlab#608106 | | Dashboards | `pages.dashboard.milestones.index` | gitlab-org/gitlab#608106 | | Milestones | `pages.groups.milestones.index` | gitlab-org/gitlab#608109 | | Milestones | `pages.groups.milestones.new` | gitlab-org/gitlab#608109 | | Milestones | `pages.groups.milestones.edit` | gitlab-org/gitlab#608109 | | Milestones | `pages.groups.milestones.show` | gitlab-org/gitlab#608109 | | Milestones | `pages.projects.milestones.index` | gitlab-org/gitlab#608109 | | Milestones | `pages.projects.milestones.new` | gitlab-org/gitlab#608109 | | Milestones | `pages.projects.milestones.edit` | gitlab-org/gitlab#608109 | | Milestones | `pages.projects.milestones.show` | gitlab-org/gitlab#608109 | | Labels | `pages.groups.labels.index` | gitlab-org/gitlab#608107 | | Labels | `pages.groups.labels.new` | gitlab-org/gitlab#608107 | | Labels | `pages.groups.labels.edit` | gitlab-org/gitlab#608107 | | Labels | `pages.projects.labels.index` | gitlab-org/gitlab#608107 | | Labels | `pages.projects.labels.new` | gitlab-org/gitlab#608107 | | Labels | `pages.projects.labels.edit` | gitlab-org/gitlab#608107 | | Labels | `pages.admin.labels.index` | gitlab-org/gitlab#608107 | | Labels | `pages.admin.labels.new` | gitlab-org/gitlab#608107 | | Labels | `pages.admin.labels.edit` | gitlab-org/gitlab#608107 | | Iterations | `pages.groups.iteration_cadences` | gitlab-org/gitlab#608108 | | Iterations | `pages.projects.iteration_cadences` | gitlab-org/gitlab#608108 | | Settings | `pages.groups.settings.work_items.show` | gitlab-org/gitlab#608110 | | Settings | `pages.projects.settings.work_items` | gitlab-org/gitlab#608110 | | Settings | `pages.admin.application_settings.work_item` | gitlab-org/gitlab#608110 | The 7 work items and issues entrypoints all sit behind one flag, `vue3_migrate_work_items`. The flag is defined in `config/feature_flags/beta/vue3_migrate_work_items.yml` with `type: beta` and `default_enabled: false`. It shipped in milestone 18.11, introduced by gitlab-org/gitlab!228419. The rollout issue gitlab-org/gitlab#594426 is still open. ⏳ These pages still serve Vue 2 by default everywhere. Vue 3 is reachable only where the flag has been switched on manually. The other 26 rollout entrypoints reached `status: rollout` through their own child issues, listed above. ## 🟢 Migrated (0) Nothing in this epic has reached `status: migrated` yet. Across the whole codebase, only three entrypoints are migrated. None of them belong to this group: `pages.admin.deploy_keys.new`, `pages.projects.environments.terminal`, and `pages.projects.path_locks`. ## 🔴 Not started (12) ### Jira (5) Child issue: gitlab-org/gitlab#630030. - [ ] `pages.jira_connect.branches.new` - [ ] `pages.jira_connect.oauth_callbacks` - [ ] `pages.projects.import.jira` - [ ] `pages.projects.integrations.jira.issues.index` - [ ] `pages.projects.integrations.jira.issues.show` ### CRM (2) Child issue: gitlab-org/gitlab#630031. - [x] `pages.groups.crm.contacts` - [x] `pages.groups.crm.organizations` ### ZenTao (2) Child issue: gitlab-org/gitlab#630032. - [ ] `pages.projects.integrations.zentao.issues.index` - [ ] `pages.projects.integrations.zentao.issues.show` ### Profile and time tracking (2) Child issue: gitlab-org/gitlab#630033. - [x] `pages.profiles.notifications.show` - [x] `pages.time_tracking.timelogs` ### Dashboard home (1) Not yet tracked in a child issue. - [ ] `pages.dashboard.home` The source file is `app/assets/javascripts/pages/dashboard/home/index.js`. It has about 37 components. A comment on gitlab-org/gitlab#608106 proposes two options. One option is to reopen that issue to cover this page. The other option is to track it in a separate issue. ## Next steps ✅ 1. Finish the rollout of `vue3_migrate_work_items` by following gitlab-org/gitlab#594426. 2. Once each flag is enabled globally and has soaked, flip its `vue3_migration.yml` files to `status: migrated` and remove the flag. This step is tracked in gitlab-org/gitlab#608111, which is open. 3. Work the four new child issues for the 12 Vue 2 entrypoints (gitlab-org/gitlab#630030, gitlab-org/gitlab#630031, gitlab-org/gitlab#630032, gitlab-org/gitlab#630033). Each one adds `vue3_migration.yml` files with `status: rollout`, adds a feature flag, and opens a rollout issue. 4. Decide where `pages.dashboard.home` is tracked. ## Notes 📝 - Scope here is Project Management only. Issue boards (`pages.projects.boards` and `pages.groups.boards`), epic boards, roadmaps, and requirements sit with `group::product planning` in gitlab-org&23089. Wikis sit with `group::knowledge`. - `pages.dashboard.milestones.show` appeared in an earlier version of this list. No such entrypoint exists in the repo. Only `pages.dashboard.milestones.index` exists, so `pages.dashboard.milestones.show` has been removed. - The `pages.groups` entrypoint shows under this stage on the migration dashboard, but it belongs to `group::portfolio planning`. It is tracked in gitlab-org&23089 under gitlab-org/gitlab#630034. - Todos is listed on the assumption that Project Management owns it. Please move it out if that is not correct. 🙏