a startpage for your server and / or new tab page
Find a file
Joshua M. Boniface d91c447c7a Support relative paths for index.html loads
Allows SUI to work at arbitrary path names rather than relying on fixed
root-level paths.
2020-05-07 22:36:44 -04:00
assets Added URL handling in search box 2019-06-03 19:38:23 +02:00
apps.json first commit 2019-04-03 15:47:12 +02:00
docker-compose.yml first commit 2019-04-03 15:47:12 +02:00
Dockerfile first commit 2019-04-03 15:47:12 +02:00
index.html Support relative paths for index.html loads 2020-05-07 22:36:44 -04:00
LICENSE Create LICENSE 2019-04-05 05:02:53 +02:00
License.md Create License.md 2019-04-05 05:00:40 +02:00
links.json first commit 2019-04-03 15:47:12 +02:00
providers.json first commit 2019-04-03 15:47:12 +02:00
README.md Update README.md 2019-04-10 12:25:52 +02:00

SUI

a startpage for your server and / or new tab page

screenshot

More screenshots

Deploy with Docker compose

Prerequisites:

Install:

  • git clone this repository
  • Build and bring up with docker-compose up -d
  • The page should be available at http://localhost:4000

To run at a different port open edit docker-compose.yml:

ports:
      - 4000:80

Customization

Changing color themes

  • Click the options button on the left bottom

Apps

Add your apps by editing apps.json:

{
    "apps" : [
	    {"name":"Name of app 1","url":"sub1.example.com","icon":"icon-name"},
	    {"name":"Name of app 2","url":"sub2.example.com","icon":"icon-name"}
    ]
}

Please note:

  • No http:// in the URL
  • No , at the end of the last app's line
  • Find the names of icons to use at Material Design Icons

Bookmarks

Add your bookmarks by editing links.json:

{  
   "bookmarks":[  
      {  
         "category":"Category1",
         "links":[  
            {  
               "name":"Link1",
               "url":"http://example.com"
            },
            {  
               "name":"Link2",
               "url":"http://example.com"
            }
         ]
      },
      {  
         "category":"Category2",
         "links":[  
            {  
               "name":"Link1",
               "url":"http://example.com"
            },
            {  
               "name":"Link2",
               "url":"http://example.com"
            }
         ]
      }
   ]
}

Add names for the categories you wish to define and add the bookmarks for each category.

Please note:

  • No http:// in the URL
  • No , at the end of the last bookmark in a category and at the end of the last category

Color themes

These can be added or customized in the themer.js file. When changing the name of a theme or adding one, make sure to edit this section in index.html accordingly:

    <section  class="themes">

I might add a simpler way to edit themes at some point, but adding the current ones should be pretty straight forward.