Theming

StrataBI ships with a set of bundled UI themes and a light/dark code editor. Both are chosen at deploy time and served entirely from your own runtime — nothing is fetched from a public CDN at request time, which keeps internal or air-gapped deployments self-contained.

App theme

The app's look is a single Bootstrap-style stylesheet selected by the STRATABI_THEME environment variable (set through the Terraform theme variable). Every bundled theme is baked into the container image; STRATABI_THEME just selects which one the app serves at /stratabi-theme.css.

hcl

# terraform.tfvars
theme = "guildmaster"

Available themes

guildmaster is the Shaleio-branded default (a dark theme with teal accents). The rest are standard Bootswatch themes:


`guildmaster` (default, branded)	`brite`	`cerulean`	`cosmo`
`cyborg`	`darkly`	`flatly`	`journal`
`litera`	`lumen`	`lux`	`materia`
`minty`	`morph`	`pulse`	`sandstone`
`simplex`	`slate`	`solar`	`spacelab`
`superhero`	`united`	`yeti`	`zephyr`

Dark themes: guildmaster, cyborg, darkly, slate, solar, superhero. The rest are light.

Why it's served privately

The selected stylesheet is read from the image and returned by the app itself, so a browser only ever talks to your runtime. There is no runtime call to S3 or a public CDN, and no extra IAM or network egress is required. One image carries every theme — you do not rebuild to switch.

Bring your own stylesheet

To override the bundled theme with your own, set theme_url (Terraform) / STRATABI_THEME_URL to a stylesheet URL you control. When set, the app loads the theme from that URL instead of serving one from its own origin.

hcl

theme     = "darkly"            # fallback / editor-theme hint
theme_url = "https://cdn.example.internal/brand.css"

Note

If you point theme_url at a public URL, browsers will fetch it directly from that host. For internal-only or air-gapped deployments, leave theme_url empty and use a bundled theme, or host the override on infrastructure you own.

Code editor (Monaco)

The dashboard builder embeds the Monaco editor, which manages its own styling. It uses Monaco's built-in light (vs) and dark (vs-dark) themes — that's the whole surface; there is no separate editor stylesheet to manage.

By default the editor theme follows the app theme: dark app themes get vs-dark, light themes get vs. To force it, set STRATABI_EDITOR_THEME to vs or vs-dark.

bash

STRATABI_EDITOR_THEME=vs-dark

Variable	Values	Default
`STRATABI_THEME`	any bundled theme name	`guildmaster`
`STRATABI_THEME_URL`	a stylesheet URL you control	(empty — serve bundled)
`STRATABI_EDITOR_THEME`	`vs`, `vs-dark`	derived from `STRATABI_THEME`