diff --git a/src/components/HomepageFeatures.js b/src/components/HomepageFeatures.js
index fe7f0634..aa9e5df0 100644
--- a/src/components/HomepageFeatures.js
+++ b/src/components/HomepageFeatures.js
@@ -21,8 +21,8 @@ const FeatureList = [
Arguably one of the most important features for any start page is the ability to find
and launch applications as quickly as possible.
- To filter services, just start typing. No need to select the search bar or use any special key.
- You can then use either the tab key or arrow keys to select and move between results,
+ To filter services, in Dashy - just start typing. No need to select the search bar or use any special key.
+ You can then use either the tab key or arrow keys to navigate the results,
and hit enter to launch the currently selected application.
>
),
@@ -34,23 +34,141 @@ const FeatureList = [
<>
Dashy comes with a ton of built-in themes, so you'll easily find one that suits you.
But it's also easy to write you're own. All colors, and most other CSS properties
- make use of CSS variables, which makes customizing the look and feel of Dashy very easy.
+ make use of variables, which make customizing the look and feel of Dashy simple.
You can apply custom styles directly through the UI,
or pass an external stylesheet into the config file
>
),
icon: (),
},
+ {
+ title: 'Icons',
+ description: (
+ <>
+ Both sections and items can have an icon associated with them, and defined under the icon attribute.
+ There are many options for icons, including Font Awesome support, automatic fetching from favicon,
+ programmatically generated icons and direct local or remote URLs.
+
+
+ Favicon: Set icon: favicon to fetch a services icon automatically from the URL of the corresponding application
+
+
+ Font-Awesome: To use any font-awesome icon, specify the category,
+ followed by the icon name, e.g. `fas fa-rocket` or `fab fa-monero`.
+ You can also use Pro icons if you have a license key, just set it under `appConfig.fontAwesomeKey`.
+
+
+ Generative: Setting `icon: generative`, will generate a unique for a given service, based on it's URL or IP.
+
+
+ URL: You can also pass in a URL to an icon asset, hosted either locally or
+ using any CDN service. E.g. icon: `https://i.ibb.co/710B3Yc/space-invader-x256.png`.
+
+
+ Local Image: To use a local image, store it in `./public/item-icons/`
+ (or create a volume in Docker: `-v /local/image/directory:/app/public/item-icons/`) ,
+ and reference it by name and extension - e.g. set `icon: image.png` to use `./public/item-icon/image.png`.
+ You can also use sub-folders here if you have a lot of icons, to keep them organized.
+
+
+ >
+ ),
+ icon: (),
+ },
{
title: 'Customizable Layouts',
description: (
<>
- Extend or customize your website layout by reusing React. Docusaurus can
- be extended while reusing the same header and footer.
+ Structure your dashboard to fit your use case. Choose between multiple different layouts,
+ item sizes and show/ hide components based on what you need. Less frequently used
+ sections can be collapsed, and large sections can be set to span multiple
+ columns or rows.
>
),
icon: (),
},
+ {
+ title: 'Status Indicators',
+ description: (
+ <>
+ Display the status of each service as a small dot, indicating which applications are down or running slowly.
+ This is useful if you are using Dashy to organize your self-hosted services,
+ as it gives a quick overview of the health of your lab. Hovering over the status will show
+ additional data, including response time, host info and status message.
+
+ Status checks are off by default, but can be enabled globally with `appConfig.statusCheck: true`,
+ or turned on or off on a per-item basis with `item[n].statusCheck`. You can also make use of
+ continuous status checking, by specifying `statusCheckInterval` in seconds. If needed, you can
+ call a different URL, by setting it in `statusCheckUrl`, and also pass in custom headers
+ using `statusCheckHeaders`.
+ >
+ ),
+ icon: (),
+ },
+ {
+ title: 'Launching Methods',
+ description: (
+ <>
+ There are several different options for launching services from within Dashy.
+ You can specify the default method with the `target` attribute, or right-click
+ on any item to select an alternate method.
+
+
`sametab` - The app will be launched in the current tab
+
`newtab` - The app will be launched in a new tab
+
`modal` - Launch app in a resizable/ movable popup modal on the current page
+
`workspace` - Changes to Workspace view, and launches app
+
+ >
+ ),
+ icon: (),
+ },
+ {
+ title: 'Authentication',
+ description: (
+ <>
+ Dashy has a built-in login feature, which can be used for basic access control.
+ To enable this feature, add an `auth` attribute under `appConfig`, containing an array of users.
+ Each with a username, SHA-256 hashed password and optional user type.
+ >
+ ),
+ icon: (),
+ },
+ {
+ title: 'Cloud Backup & Sync',
+ description: (
+ <>
+ Dashy has an optional built-in feature for securely backing up your config to
+ a hosted cloud service, and then restoring it on another instance.
+ This feature is totally optional, and is off by default.
+
+ All data is end-to-end encrypted with AES using your password as the key.
+ It is processed with a CF worker, and stored in KV. You can delete your data
+ at any time.
+ >
+ ),
+ icon: (),
+ },
+ {
+ title: 'Configuration through UI',
+ description: (
+ <>
+ Dashy's config is stored in YAML format. It is possible to modify all settings
+ directly through the config editor in the UI, which will then update your YAML file,
+ and rebuild the app automatically.
+ >
+ ),
+ icon: (),
+ },
+ {
+ title: 'Easy Deployment',
+ description: (
+ <>
+ Although Dashy can be easily run on bare metal, the quickest method of getting started is with Docker.
+ Just run `docker run -p 8080:80 lissy93/dashy` to pull, build and and run Dashy.
+ >
+ ),
+ icon: (),
+ },
];
const getColor = (index) => {
@@ -75,7 +193,7 @@ function Feature({ title, description, icon, index }) {