Custom Assets

The dashboard includes built-in placeholder assets located in the /assets directory.

You can override these assets without modifying any application files by placing your own images in /static/images.

If a custom asset is found, it will be used automatically. Otherwise, the built-in placeholder asset is displayed.

Supported assets

Logo

Place a file named:

/static/images/logo-SITECODE.EXT

Examples:

/static/images/logo-blog.png
/static/images/logo-forum.jpg
/static/images/logo-website.svg

You can also place a file without a site code — /static/images/logo.EXT — to override the logo for every tracked site at once. A per-site file, if present, still takes priority over this global one.

Favicon

Place a file named:

/static/images/favicon-SITECODE.EXT

Examples:

/static/images/favicon-blog.png
/static/images/favicon-forum.ico
/static/images/favicon-website.svg

Just like the logo, a site-less /static/images/favicon.EXT overrides the favicon for every tracked site, unless a more specific per-site file exists.

Country flags

You can override individual country flags by placing files in:

/static/images/flags/

Examples:

/static/images/flags/fr.png
/static/images/flags/us.svg
/static/images/flags/jp.webp

Only the specified flags are overridden. All other flags continue using the built-in assets.

Supported file formats

Logo and favicon overrides support:

png
jpg
jpeg
webp
svg
gif
ico

Country flags support the same list except gif.

Notes

• Custom assets are optional.
• Built-in assets are stored in /assets.
• Updating the application will not overwrite your custom assets stored in /static/images.

Do you find this project useful? You can support its development using the buttons in the page footer.