📝 Writes docs for new icon features

README.md

@@ -53,6 +53,12 @@
 
 You will need [Docker](https://docs.docker.com/get-docker/) installed on your system
 
+```
+docker run -p 8080:80 lissy93/dashy
+```
+
+Or
+
 ```docker
 docker run -d \
   -p 4000:80 \
@@ -123,6 +129,20 @@ You can also apply custom CSS overrides directly through the UI (Under Config me
 
 ---
 
+## Icons 🧸
+
+> For full iconography documentation, see: [**Icons**](./docs/icons.md)
+
+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 of course URLs. 
+
+<p align="center">
+  <img width="400" src="https://i.ibb.co/GTVmZnc/dashy-example-icons.png" />
+</p>
+
+If icon is set to `favicon`, then it will be automatically fetched from the URL of the corresponding application. To use any font-awesome icon, specify the category, followed by the icon name, e.g. `fas fa-rocket`, `fab fa-monero` or `fas fa-unicorn`, you can also use Pro icons, by setting your API key under `appConfig.fontAwesomeKey`. If the icon is set to `generative`, then a unique icon is generated from the apps URL or IP. You can also host an icon either locally or using any CDN service, and pass it's URL into the `icon` attribute, e.g. `https://i.ibb.co/710B3Yc/space-invader-x256.png`. To use a local image, store it in `./public/item-icons/` (or `-v /app/public/item-icons/` in Docker) , 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 organised.
+
+---
+
 ## Cloud Backup & Sync ☁
 
 > For full backup documentation, see: [**Cloud Backup & Sync**](./docs/backup-restore.md)
@@ -231,6 +251,7 @@ For more general questions about any of the technologies used, [StackOverflow](h
 - [Troubleshooting](/docs/troubleshooting.md)
 - [Backup & Restore](/docs/backup-restore.md)
 - [Theming](/docs/theming.md)
+- [Icons](/docs/icons.md)
 - [Authentication](/docs/authentication.md)
 
 **[⬆️ Back to Top](#dashy)**