Project directory

Before you can customize your GBC Web client, you need to unzip the GBC runtime package to a directory.

A project directory (gbc-project-dir) serves as the GBC project root directory. Amongst its directories and files you will find the following:

Table 1. Directories
Directory or file Description
gbc-project-dir/archive Created when you first package a customization for deployment. Each package contained within is saved as a compressed file and is named (by default) to include a reference to the project directory, a build number comprised of a timestamp, and the customization name.
gbc-project-dir/customization The root directory to your customization projects. You can have as many customization projects as you wish within this directory. Each customization project has its own customization project directory (customization-project-dir). For details, see Customization directory.
gbc-project-dir/customization/sample Sample customization. At installation, the customization directory contains this single customization directory.
gbc-project-dir/dist/customization Created when you first build any customization project. It contains the generated deliverables, organized by customization. A directory is created for each built customization project. The name of the directory is taken from the name of the customization project, resulting in dist/customization/customization-project-dir. See Deliverables.
gbc-project-dir/dist/customization/sample The generated deliverables for the sample customization. This directory is created the first time you build the sample customization.
gbc-project-dir/doc Contains the GBC API reference documentation you are reading. This is intended to help you with the advanced GBC customization of the front-end. You can launch it by opening the /doc/index.html file in your browser.
gbc-project-dir/license Contains text documents with the end user license agreement.
gbc-project-dir/node_modules

The contents of this folder are used by npm and gbc when building a customization project.

Important:

Do not modify the contents of this folder.

gbc-project-dir/release Contains text documents with copyright information and the release notes.
gbc-project-dir/src

Contains all the core source files that make up the default GBC front-end, to include JavaScript, HTML, CSS, and locale files. Examine the source files to familiarize yourself with how the front-end is implemented.

Important:

We recommend that you leave the core sources untouched.

gbc-project-dir/theme Contains the default global theme parts, such as the highcontrast theme. While you can create new theme parts at a global level, it is recommended that you create your theme parts at the local level. This will ease migration efforts for new releases of the GBC. See Default themes and Working with themes.
gbc-project-dir/custom.json This file contains the default build and theme instructions. For more information, see Configure your build.

There are other files located at the root of gbc-project-dir. However, you will never be asked to modify these files.