===============================================================================
 customize/   -   THE ONLY FOLDER YOU EDIT
===============================================================================

Everything about YOUR installation lives in this folder. Everything outside it
belongs to the application and is replaced when a new version is installed.
What you put in here is never touched by an upgrade.

Nothing here is required: with an empty folder the app runs on its built-in
look and its built-in backend path (/shrdbms).


WHAT YOU CAN DO
-------------------------------------------------------------------------------
  Change the look / sign-in wording
      copy  branding-config.sample.json  to  branding-config.json
      and edit the COPY. The full guide is branding-config.help.txt.

  Point the app at a different backend path  (only if it is NOT /shrdbms)
      copy  app-config.sample.js  to  app-config.js
      and change apiBase in the COPY.

  Your logo
      put  logo.svg  (or logo.png)  in the  client-logo  folder.

  Sign-in pictures
      put  login-1.jpg, login-2.jpg ...  in the  login-images  folder.

  Browser-tab icon
      put  favicon.ico  here, in this folder.

Then refresh the browser with Ctrl+Shift+R. No restart, no rebuild.


WHAT IS IN THIS FOLDER
-------------------------------------------------------------------------------
  README.txt                    this page
  branding-config.help.txt      the full guide
  branding-config.sample.json   template  - never edit it, copy it
  app-config.sample.js          template  - never edit it, copy it

  branding-config.json          YOURS (you create it)
  app-config.js                 YOURS (you create it)
  favicon.ico                   YOURS
  client-logo/                  YOURS - your logo
  login-images/                 YOURS - your sign-in pictures


OLDER INSTALLS
-------------------------------------------------------------------------------
If you already have  branding-config.json / app-config.js / favicon.ico  next
to index.html, or a  logos/  or  images/login/  folder, they keep working. A
copy inside this folder takes priority over the old place. To tidy up, move them
in here (logos -> client-logo, images/login -> login-images).
===============================================================================
