You have completed customizations, and a new version of the GBC is released. What steps do you take to move your customizations to the latest version?

First, you must download and set up the project directory for the latest version, as documented in the section "Setup your customization project" from Set up your GBC build environment. Then you will need to move your theme parts and customizations from the old project into the new project.

Steps summarized

Extract the GBC project package to a directory. This becomes the gbc-project-dir.

Complete the following:

$ cd gbc-project-dir
$ npm install
$ gbc build

Copy the customization directories from the previous GBC project and add them to gbc-project-dir/customization.

If you added global theme parts in the previous GBC project, you must move those global theme parts into your new project. To keep them global, copy those theme part directories and add them to gbc-project-dir/theme. Alternatively, you can use this opportunity to move them into a local theme parts directory.

TIP: To ease migration, it is recommended that you use local theme parts. Using local theme parts avoids the need to manage changes to the global theme parts directory during a migration.

IMPORTANT: Prior to 1.00.52, all theme parts were stored in the global directory gbc-project-dir/theme. As part of the migration, it is recommended that you move those theme parts into the local theme parts folder for the customization, gbc-project-dir/customization/customization-project-dir/theme.

If you modified any of the default global theme part directories, you may want to examine any changes to the most recent default theme parts, and merge your changes accordingly.