blob: f07b8f870eeacde6bb59eebdd9e9fa56bcd62249 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
|
---
title: Marketplace
description: Publish and share Herdr plugins, and get listed when the marketplace launches.
---
The Herdr plugin marketplace is a discoverable index of installable plugins. It
is not live yet. This page is how to be ready for it.
## Share a plugin today
The marketplace adds discovery on top of installation; it does not replace it.
Anyone can already install your plugin straight from GitHub:
```bash
herdr plugin install owner/repo[/subdir...]
```
Publish a normal public GitHub repository with a `herdr-plugin.toml` manifest at
its root, or in a subdirectory, and that command works now. See
[Plugins](/docs/plugins/) for the manifest and authoring reference.
## Get listed when it launches
If you want your plugin to appear in the website marketplace when discovery
launches, add the GitHub topic `herdr-plugin` to your repository now. That
topic is the signal the future index will use for discovery, so tagging a
public plugin today means it can be listed when the marketplace goes live.
## What a listing will show
A marketplace card will surface your plugin's `id`, `name`, `description`,
declared `platforms`, and a link back to the source repository. Getting that
manifest metadata right today is what makes your listing accurate later. Declare
`platforms` honestly, because the index will use it to show where a plugin runs.
Plugins stay ordinary GitHub repositories. The marketplace is a discovery layer
on top of the same `herdr plugin install` path you can use now. A listing makes a
plugin easier to find; it does not mean Herdr has reviewed it, so the
[trust guidance](/docs/plugins/#trust-and-security) still applies.
|