Global App Settings

All global application settings are stored in the appconfig.json file at the root of your Git repository. You will need to modify this file with a text editor in order to configure connections, navigation, and branding. An example appconfig.json looks like this:

{
    "connections" : [
        {
            "type" : "sqlite3",
            "db_filename" : "bigfoot_demo.db"
        }
    ],
    "custom_style_filename" : "demo.css",
    "custom_icon_css_url" : "https://use.fontawesome.com/releases/v5.8.1/css/all.css",
    "app_name" : "Insight Reporting",
    "app_logo" : "bf-logo.png",
    "app_logo_height" : "40px",
    "app_logo_width" : "128px",
    "auth0_logo" : "bf-logo-auth.png",
    "app_timeout_minutes" : "60",
    "app_page_sets": [
        {
            "app_page_set_name": "default",
            "app_categories" : [
                {
                    "category_name" : "Sightings",
                    "icon_classes" : "icon fas fa-shoe-prints"
                },
                {
                    "category_name" : "State Info",
                    "icon_classes" : "icon fas fa-map-marker-alt"
                }
            ],
            "app_pages": [
                {
                    "page_type": "html",
                    "nav_category" : "Sightings",
                    "page_name": "overview",
                    "page_title": "Overview",
                    "page_src" : "overview.html",
                    "cache_hours" : 1
                },
                {
                    "page_type": "html",
                    "nav_category" : "Sightings",
                    "page_name": "bydate",
                    "page_title": "By Date",
                    "page_src" : "bydate.html"
                },
                {
                    "page_type": "html",
                    "nav_category" : "State Info",
                    "page_name": "bystate",
                    "page_title": "By State",
                    "page_src" : "bystate.html"
                }
            ]
	}
    ]
}

Setting the application name and timeout

You can give your application a name and configure the timeout.

Option Req’d Example Description
app_name Y “Insights” Name of your data application that appears in the top bar and on the login screen.
app_timeout_minutes Y "60" The number of minutes before an idle user will be timed out and have to login again.

Configuring other settings

The appconfig.json file contains different sections. You can find the specifics for how to configure each section as follows:

For the connections section, see Managing Connections

For logo and style properties, see Configuring Branding

For the app_page_sets section, see Add a Page to the Navigation Menu and Configuring Multiple Page Sets