Simple and fast dashboard with a go backend and a mostly HTML+CSS frontend with a small amount of JS.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Arsen Musayelyan 61ed6e1872 Change variable name to prevent conflicts 1 month ago
bulma Remove unnecessary resources, add bulma, and add AdvMakefile 2 months ago
resources Change variable name to prevent conflicts 1 month ago
.gitignore Initial Commit 2 months ago
.gitm.toml Change variable name to prevent conflicts 1 month ago
AdvMakefile Remove unnecessary resources, add bulma, and add AdvMakefile 2 months ago
LICENSE Initial commit 2 months ago
README.md Use random ID values to prevent ID conflicts 2 months ago
config.go Add Apache-2.0 copyright headers 2 months ago
extra.go Add Apache-2.0 copyright headers 2 months ago
go.mod Initial Commit 2 months ago
go.sum Initial Commit 2 months ago
main.go Add Apache-2.0 copyright headers 2 months ago
routes.go Change variable name to prevent conflicts 1 month ago
simpledash-sample.toml Fix sample config 2 months ago
template.go Add Apache-2.0 copyright headers 2 months ago

README.md

simpledash

Simple and fast dashboard with a go backend and a mostly HTML+CSS frontend with a small amount of JS.

Building

Dependencies:

  • sqlite3 (and sqlite3-dev if on debian/ubuntu)
  • golang (1.14+)

To build, simply run go build in the repo.


Configuration

Configuration is done in the simpledash.toml file.

Root

The root section is the one not under any header.

It contains the following fields:

  • title: Title used for whole site
  • theme: Theme used for site, can be light or dark.
  • loginRequired: Boolean denoting whether login is required to see public cards
  • allowProxy: Array containing all sites allowed to be proxied by the integrated HTTP proxy

Users

A user can be added under the [users] section like so:

[users]
    [users.admin]
    passwordHash = "$2a$10$w00dzQ1PP6nwXLhuzV2pFOUU6m8bcZXtDX3UVxpOYq3fTSwVMqPge"
    showPublic = true

passwordHash should be a bcrypt hash of the desired password with a cost of 10 (default). simpledash --hash <password> can be used to get a suitable hash

showPublic should be a boolean denoting whether public cards should be displayed while signed in

Cards

A card can either be public or belong to a user. A public card should be added under [users] like so:

[users]
    [[users._public_.card]]
        type = "weather"
        title = "Weather"
        data = {"woeid" = "2442047"}

A card belonging to a user should be added under that user, like so:

 [users.admin]
    passwordHash = "$2a$10$w00dzQ1PP6nwXLhuzV2pFOUU6m8bcZXtDX3UVxpOYq3fTSwVMqPge"
    showPublic = true

    [[users.admin.card]]
      type = "status"
      title = "Google"
      icon = "ion:logo-google"
      desc = "Google search engine. Status card example."
      url = "https://www.google.com"

The configuration for a card consists of up to six things:

  • Type: Type of card to display
  • Title: Title to show above card
  • Icon: Icon to display on card
  • Description: Description for card
  • URL: URL to be used inside card
  • Data: Extra data for anything not listed

Icons can be anything found on Iconify

There are currently five types of cards included:

  • Simple: Simplest type of card, displays title, icon, description, and URL
  • Status: Same as simple but also checks and displays status of URL
  • Collection: A card containing multiple links to different sites. Links provided in data field.
  • Weather: Display weather using data from Metaweather. Gets location via WOEIDs
  • API: Gets JSON data from URL and formats according to format field in data. At least part of URL must be inside allowedProxy array.

Examples for each card are included in simpledash-sample.toml

Session

The session cookie name can be set under [session] like so:

[session]
    name = "simpledash-session"