2021-09-22 00:47:51 -04:00
package ui
import (
"bytes"
2022-04-25 20:20:32 -04:00
"errors"
2021-09-22 00:47:51 -04:00
"html/template"
2022-10-09 21:33:31 -04:00
2025-05-17 16:10:28 -04:00
"github.com/TwiN/gatus/v5/storage"
2022-12-06 01:41:09 -05:00
static "github.com/TwiN/gatus/v5/web"
2021-09-22 00:47:51 -04:00
)
const (
2022-11-01 05:33:19 +01:00
defaultTitle = "Health Dashboard | Gatus"
defaultDescription = "Gatus is an advanced automated status page that lets you monitor your applications and configure alerts to notify you if there's an issue"
defaultHeader = "Health Status"
defaultLogo = ""
defaultLink = ""
2024-12-26 23:08:16 -05:00
defaultCustomCSS = ""
2021-09-22 00:47:51 -04:00
)
var (
2025-03-08 04:32:05 +03:00
defaultDarkMode = true
2022-04-25 20:20:32 -04:00
ErrButtonValidationFailed = errors . New ( "invalid button configuration: missing required name or link" )
2021-09-22 00:47:51 -04:00
)
// Config is the configuration for the UI of Gatus
type Config struct {
2022-11-01 05:33:19 +01:00
Title string `yaml:"title,omitempty"` // Title of the page
Description string `yaml:"description,omitempty"` // Meta description of the page
Header string `yaml:"header,omitempty"` // Header is the text at the top of the page
Logo string `yaml:"logo,omitempty"` // Logo to display on the page
Link string `yaml:"link,omitempty"` // Link to open when clicking on the logo
Buttons [] Button `yaml:"buttons,omitempty"` // Buttons to display below the header
2024-12-26 23:08:16 -05:00
CustomCSS string `yaml:"custom-css,omitempty"` // Custom CSS to include in the page
2025-03-08 04:32:05 +03:00
DarkMode * bool `yaml:"dark-mode,omitempty"` // DarkMode is a flag to enable dark mode by default
2025-05-17 16:10:28 -04:00
MaximumNumberOfResults int // MaximumNumberOfResults to display on the page, it's not configurable because we're passing it from the storage config
2025-03-08 04:32:05 +03:00
}
func ( cfg * Config ) IsDarkMode () bool {
if cfg . DarkMode != nil {
return * cfg . DarkMode
}
return defaultDarkMode
2022-04-25 20:20:32 -04:00
}
// Button is the configuration for a button on the UI
type Button struct {
Name string `yaml:"name,omitempty"` // Name is the text to display on the button
Link string `yaml:"link,omitempty"` // Link to open when the button is clicked.
}
// Validate validates the button configuration
func ( btn * Button ) Validate () error {
if len ( btn . Name ) == 0 || len ( btn . Link ) == 0 {
return ErrButtonValidationFailed
}
return nil
2021-09-22 00:47:51 -04:00
}
// GetDefaultConfig returns a Config struct with the default values
func GetDefaultConfig () * Config {
return & Config {
2025-05-17 16:10:28 -04:00
Title : defaultTitle ,
Description : defaultDescription ,
Header : defaultHeader ,
Logo : defaultLogo ,
Link : defaultLink ,
CustomCSS : defaultCustomCSS ,
DarkMode : & defaultDarkMode ,
MaximumNumberOfResults : storage . DefaultMaximumNumberOfResults ,
2021-09-22 00:47:51 -04:00
}
}
// ValidateAndSetDefaults validates the UI configuration and sets the default values if necessary.
func ( cfg * Config ) ValidateAndSetDefaults () error {
if len ( cfg . Title ) == 0 {
cfg . Title = defaultTitle
}
2022-11-01 05:33:19 +01:00
if len ( cfg . Description ) == 0 {
cfg . Description = defaultDescription
}
2022-01-08 14:55:40 -05:00
if len ( cfg . Header ) == 0 {
cfg . Header = defaultHeader
}
2024-12-26 23:08:16 -05:00
if len ( cfg . Logo ) == 0 {
cfg . Logo = defaultLogo
}
if len ( cfg . Link ) == 0 {
cfg . Link = defaultLink
}
if len ( cfg . CustomCSS ) == 0 {
cfg . CustomCSS = defaultCustomCSS
2022-01-08 14:55:40 -05:00
}
2025-03-08 04:32:05 +03:00
if cfg . DarkMode == nil {
cfg . DarkMode = & defaultDarkMode
}
2022-04-25 20:20:32 -04:00
for _ , btn := range cfg . Buttons {
if err := btn . Validate (); err != nil {
return err
}
}
// Validate that the template works
2022-10-09 21:33:31 -04:00
t , err := template . ParseFS ( static . FileSystem , static . IndexPath )
2021-09-22 00:47:51 -04:00
if err != nil {
return err
}
var buffer bytes . Buffer
2025-03-08 04:32:05 +03:00
return t . Execute ( & buffer , ViewData { UI : cfg , Theme : "dark" })
}
type ViewData struct {
UI * Config
Theme string
2021-09-22 00:47:51 -04:00
}