Settings.json

The settings.json file exists primarily to allow configurable settings that don't require a full rebuild of a frontend - also some visual elements can be controlled by these settings like headings, positions, icons, and colors etc. Some of the configurable settings include:
Composer settings, like domain, protocol, and auth method.
Basic App-level visuals; title, meta details, logos, etc.
Top-level menu listings
Banner child element organisation and appearance.
Page routes and titles.
Bookings - granular conditional settings
The settings.json file can become monolithic but this, for the moment, allows backend devs, or anyone not frontend-familiar with git repo access, the ability to change visuals and other aspects of an app easily.
When approaching an existing frontend first check to see if the change can be made in the settings.json file; it might save some headache.
Overview
Composer config
1
{
2
    ...
3
​
4
    "composer": {
5
        "domain": "",
6
        "route": "",
7
        "protocol": "http:",
8
        "use_domain": true,
9
        "local_login": false
10
    }
11
​
12
    ...
13
}
Copied!
The default composer config is setup for simple local development, if you require your app to work in conjunction with a local Engine instance then the domain setting will have to match the corresponding domain listing in the admin panel of the instance (Backoffice).
For example:
1
{
2
    ...
3
​
4
    "composer": {
5
        "domain": "localhost:4200",
6
        "route": "",
7
        "protocol": "http:",
8
        "use_domain": true,
9
        "local_login": false
10
    }
11
​
12
    ...
13
}
Copied!
NB: This assumes the app is being served with default settings with the gulp serve terminal command - i.e. utilizing port 4200. A production settings.json file will be created from this with modified settings at compile time. These production values overrides will exist within /config/default.ts.
Cosmetics/Supplementary Details
1
{
2
    ...
3
​
4
    "app": {
5
        "title": "ACA Staff App",
6
        "name": "Staff App",
7
        "description": "ACA Projects Staff Application made in Angular",
8
        "short_name": "ACA",
9
        "code": "ACA",
10
        "login": {
11
            "forgot": false
12
        },
13
        "analytics": {
14
            "enabled": false,
15
            "tracking_id": "UA-123456789"
16
        },
17
        "logo": {
18
            "type": "img",
19
            "src": "assets/img/logo.svg",
20
            "inverse": "assets/img/logo-inverse.svg",
21
            "background": ""
22
        },
23
        "banner": {
24
            "enabled": true,
25
            "header": true,
26
            "home": false,
27
            "type": "color",
28
            "full": true,
29
            "allow_image_on_home": false,
30
            "src": "assets/img/background-hero.jpg"
31
        },
32
        "copyright": "Copyright 2020 ACA Projects",
33
​
34
        ...
35
    }
36
​
37
    ...
38
}
Copied!
In this example basic app-wide details are specified; these include page-wide titles/meta data details, logos, GA code, and toggles for when to show hero banners. All things that can be configured post build.
Granular Configurations for Sections
This snippet shows the configuration options for room booking on the default ACA Staff App.
1
{
2
    ...
3
​
4
    "booking": {
5
            "min_attendees": 0,
6
            "external_visitors": false,
7
            "recurrence": false,
8
            "max_days_ahead": 180,
9
            "max_length": 480,
10
            "default_length": 30,
11
            "min_length": 30,
12
            "multi_room": false,
13
            "title_prefix": "",
14
            "charge": false,
15
            "terms": false,
16
            "old_filters": false,
17
            "select_room_first": true,
18
            "privacy": false,
19
            "control": false,
20
            "lock_cancel": 0,
21
            "external_floors": [],
22
            "return_id": "",
23
            "fields": [
24
                {
25
                    "key": "date",
26
                    "label": "Date",
27
                    "icon": {
28
                        "class": "material-icons",
29
                        "value": "event"
30
                    },
31
                    "simple": true,
32
                    "description": "",
33
                    "control_type": "custom",
34
                    "required": true
35
                },
36
                {
37
                    "key": "start",
38
                    "label": "Start",
39
                    "icon": {
40
                        "class": "material-icons",
41
                        "value": "access_time"
42
                    },
43
                    "refs": [
44
                        "date"
45
                    ],
46
                    "simple": true,
47
                    "description": "",
48
                    "control_type": "custom",
49
                    "required": true
50
                },
51
                {
52
                    "key": "duration",
53
                    "label": "End",
54
                    "icon": {
55
                        "class": "material-icons",
56
                        "value": "access_time"
57
                    },
58
                    "refs": [
59
                        "date"
60
                    ],
61
                    "simple": true,
62
                    "description": "",
63
                    "control_type": "custom",
64
                    "required": true
65
                }
66
​
67
                ...
68
​
69
            ],
70
            "banner": {
71
                "enabled": true,
72
                "links": [
73
                    {
74
                        "id": "book",
75
                        "name": "Book Space"
76
                    },
77
                    {
78
                        "id": "book/visitor",
79
                        "name": "Book Visitor"
80
                    }
81
                ]
82
            }
83
        }
84
​
85
    ...
86
}
Copied!
Widgets
Next - API
Authentication
Last modified 1yr ago
Copy link
Contents
Overview
Composer config
Cosmetics/Supplementary Details
Granular Configurations for Sections