47 lines
1.6 KiB
Plaintext
47 lines
1.6 KiB
Plaintext
---
|
|
title: Community Workshop
|
|
sidebar_label: Overview
|
|
tags:
|
|
- Workshop
|
|
- Custom Widgets
|
|
- Custom CSS
|
|
---
|
|
|
|
import { WorkshopFlowDiagram } from "@site/src/components/pages/core-concepts/technical-diagrams";
|
|
|
|
# Community Workshop
|
|
|
|
The [Community Workshop](pathname:///workshop) hosts community Custom Widgets and dashboard CSS.
|
|
|
|
:::warning Experimental
|
|
|
|
Workshop content is community-maintained. Review its source and permissions before installation.
|
|
|
|
:::
|
|
|
|
## Content flow
|
|
|
|
<WorkshopFlowDiagram />
|
|
|
|
Workshop also exposes the [Homarr Assistant provider](./homarr-provider). Its model-routing and quota path is separate
|
|
from Custom Widget and CSS submissions.
|
|
|
|
## Install content
|
|
|
|
- Install a Custom Widget from **Management → Custom Widgets → Import from Workshop**.
|
|
- Import dashboard CSS from **Board settings → Custom CSS → Import from Workshop**.
|
|
|
|
Custom Widget credentials are configured in your Homarr instance and are not part of the Workshop submission.
|
|
|
|
## Publish content
|
|
|
|
Publish a saved Custom Widget from its action menu under **Management → Custom Widgets**. Custom CSS and manual
|
|
submissions can be published from the Workshop website.
|
|
|
|
Sign in to the Workshop and open **Yours** to update or delete submissions and review reports. Signed-in users can vote,
|
|
comment, and report content; Workshop moderators can remove content. Workshop moderation is separate from administration
|
|
of a Homarr instance.
|
|
|
|
See the [Workshop operator guide](/docs/advanced/development/workshop-operator) to host Workshop or
|
|
[Workshop development](/docs/advanced/development/workshop) to run it from the repository.
|