Customize the index page

The GWA allows customization of index.html using custom CSS and HTML files.

The index.html file is the source for the GWA loading and ending pages. The file is generated by the gwabuildtool from the index_tpl.html file in the gwa-install-dir/lib/gwa directory. It is then stored in the root of the gwa_dist directory.

It is not recommended to modify the index.html file directly; however, you can can specify modifications for the look and feel of the index.html, by either of these methods:
  1. Custom CSS file: Use a custom CSS file to modify the visual appearance and layout of HTML elements.
    1. Create a custom CSS file. The custom CSS file must be named gwa_custom.css and placed in your programdir/gwa directory.
    2. Update the gwa_custom.css file. For most visual changes—such as colors, fonts, spacing, and button styles—CSS is the ideal place to make modifications. For example, you can alter the visual appearance and layout of HTML elements on the index page by defining or creating CSS classes.
      <!-- GWA custom css injection -->
body {background-color: green}
  2. Custom HTML template file: This option is only necessary if customizing the CSS is not sufficient, meaning you explicitly want to add elements to the existing index_tpl.html page. For details of customizing the template, go to index_tpl.html file.

By choosing either option, you can effectively tailor the user experience to your requirements.