Document Rspack as the GDK frontend bundler

Stanislav Lashmanovrequested to merge
slashmanov/rspack-gdk-docs into master

Summary

Rspack has been the default GDK frontend bundler since Enable Rspack as the default frontend bundler (gitlab-development-kit!6068 - merged) (merged 2026-09-02), and GDK removes Webpack on 19 October 2026 (Migrate all users to Rspack and retire Vite and... (gitlab-development-kit#3349)). The frontend developer docs in this repo still tell people to configure Vite, so the instructions don't work for anyone on the default setup.

This MR updates those docs to Rspack:

  • GDK-in-a-box: the documented docker run command maps -p 3038:3038, the old Vite port. The container exposes 3808, the Rspack dev server port. The MR changes the mapping to 3808.
  • Vue 3 migration guide and doc/development/testing_guide/testing_vue3.md: gdk config set vite.vue_version 3 does nothing under Rspack. Replaced with gdk config set rspack.vue_version 3, which GDK passes to the dev server as VUE_VERSION. Also replaces gdk restart vite, gdk tail vite, and the Vite cache path with their rspack equivalents.
  • Performance, SCSS (Tailwind), and new page guides: remaining Vite mentions updated to Rspack.

Reproduction steps

  1. Follow Configure GDK-in-a-box (https://docs.gitlab.com/development/contributing/first_contribution/configure-dev-env-gdk-in-a-box/) and start the container with the documented docker run command.
  2. Load GitLab in the browser. No frontend assets are served, because only the old Vite port 3038 is forwarded.
  3. On a GDK with default settings, run the Vue 3 steps from https://docs.gitlab.com/development/testing_guide/testing_vue3/ (gdk config set vite.vue_version 3, gdk reconfigure, gdk restart). Pages still run Vue 2, because the Rspack dev server reads rspack.vue_version.

Related

Edited by Stanislav Lashmanov

Merge request reports