Styles page creator is an internal tool created by Igloo to easily and efficiently create common enhancement instruction for customers in their digital workplaces. The reason why we need to document these is because some of the enhancements and customization require specific process to work, so we need to provide the customer instructions on how to create / edit / reapply the enhancements we provide. 

The instructions belong in the "/styles" page in the digital workplace. With brand new implementations, this page will not be present in the digital workplace, so it is up to the developer to set this up with all the instructions.

Our styles page generator tool makes this process easy for the developer. Follow the instructions below to setup the styles page instructions for customers. 

Sign into BitBucket with your Igloo account

1. Go into projects and select “Services Tools”.
2. Click on the “Styles Page Creator” repository.
3. Clone this repository to a folder on your computer
4. Navigate into the project directory via the Terminal/Command promp and run npm install
5. Once npm install has comleted, you can run `npm start` and it will launch an electron app

To be able to create a session, you need an app-id and an app-pass which you can get by contacting support@igloosoftware.com. Each tenant has its own app-id and app-pass so if the customer you are implementing is on an SST, you will require separate app-id and app-pass for that tenant. (Multi tenant can use the same app-id and app-pass found in the session-config.json file inside of _shell_. 

Creating the styles page:

1. Click "change tenant" and input your app-id and app-pass
2. Enter in the digital workplace URL which you will be creating the styles page for
3. Enter in your credentials to log into the community
4. Click "select templates" and select the template that apply to your implementation

Note: In this "select template" area, you can change the location of the page and the title for each page. If the digital workplace already has a page called styles in the root site structure, then the app will fail to generate the styles page for you. In that case, simply de-select the styles page from the "select templates" section. 

After selecting your templates, click "done" to back out of the template select area, and then click "create". 

Log into the digital workplace afterwards to ensure that the /styles page and the sub pages are all created. Go through each styles pages and change any URLs, classes, html structure to match your implementation. For example if you added a custom class, you would document that in the /styles/custom-widgets page.