Skip to content

Migration Guide for Templates

Cagatay Civici edited this page Apr 30, 2024 · 2 revisions

This guide covers updating templates up to version 3.x, PrimeVue v4 will have a new theming system.

Migration an application template to a newer version of PrimeVue requires updating the PrimeVue version and the designer folder to align the theme.

1) PrimeVue Version

Open package.json and update the PrimeVue dependency.

"primevue": "x.y.z"

2) SASS Theme

Visit the primevue-sass-theme and download the release that matches the PrimeVue version. Extract the contents of the bundle copy the theme-base folder, and update the theme-base folder at /public/layout/styles/theme/theme-base with the new content. The final structure should be like the following;

  • /public/layout/styles/theme/theme-base
    • _colors.scss
    • _common.scss _ _components.scss
    • _mixins.scss _ components

3) Compile SASS

Final step is compiling the SASS to generate CSS. Install SASS if you do not have sass at command line.

sass --update public/layout/styles:public/layout/styles

If you receive compilation errors, it may be due to missing SASS variables. In this case add the missing variables and compile again.

4) Support

Visit the PrimeVue Templates Forum to create a ticket for assistance.