When a new version of Genero Browser Client (GBC) is released, these are the steps you must take to move your existing customization projects to the new GBC. For details, unless noted otherwise, see Set up your GBC build environment.

1. Download the latest GBC project for GBC customization.

   IMPORTANT: To avoid overwriting your existing GBC project, you must unzip the project package in a new directory.

2. Set up your new customization project directory.

   This involves installing the dependencies for node.js within your project directory using npm install and gbc commands.

3. Copy your existing customization projects to the new project directory: For example, you must copy by hand all the contents in your existing gbc-project-dir/customization/ path to gbc-new-project-dir/customization.

4. Compile the customizations.

   Using the gbc command, you recreate the distributable clients for each of your customizations in the gbc-new-project-dir/customization path.

5. Deploy your customization to the Genero Application Server. See Compile & Deploy.

   For a production environment, you must deploy the customization to the GAS.

TIP : To ensure a smooth migration, clear your cache after upgrading. You may also need to clear the local storage.