KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

plugins

★ 30 Open GitHub ↗

The core and community plugins for Perses

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Perses Plugins

This repository contains the core plugins for [Perses](https://github.com/perses/perses)

## Development

As prerequisites, you need:

- NodeJS [version 22 or greater](https://nodejs.org/).
- npm [version 10 or greater](https://www.npmjs.com/).

You should first run `npm install` at the root of the repository.

Then in [`perses`](https://github.com/perses/perses) repository:

1. Update the Perses configuration `config.yaml` to use development server for this plugin:

```yaml
   plugin:
     enable_dev: true
   ```

2. Start the backend: `./scripts/api_backend_dev.sh`
3. Login percli to the backend `percli login http://localhost:8080`
4. Start the plugin development server: `percli plugin start /path/to/the/plugin/dir`

### Working with Snapshots

This will allow you to use the updates from perses core in your plugin so you can test the changes.

1. In perses/shared create a [snapshot](https://github.com/perses/perses/blob/30758a963337564ab58c78646a1134e51d74e146/RELEASE.md?plain=1#L109-L146). Snapshots will be released in npm:
- https://www.npmjs.com/package/@perses-dev/components/
- https://www.npmjs.com/package/@perses-dev/plugin-system
- https://www.npmjs.com/package/@perses-dev/dashboards
- https://www.npmjs.com/package/@perses-dev/explore

2. Copy the name of your snapshot, for example `v0.0.0-snapshot-panel-actions-520389b`.

3. In perses/plugin, navigate to the plugin you are changing and install the snapshot npm packages, this should be installed as "dependencies" NOT "peerDependencies" for example:

```
# perses/plugins/timeserieschart/package.json

"dependencies": {
    "color-hash": "^2.0.2"
+   "@perses-dev/components": "v0.0.0-snapshot-panel-actions-520389b",
+   "@perses-dev/core": "v0.0.0-snapshot-panel-actions-520389b",
+   "@perses-dev/plugin-system": "v0.0.0-snapshot-panel-actions-520389b"
  },
  "peerDependencies": {
    "@emotion/react": "^11.7.1",
    "@emotion/styled": "^11.6.0",
    "@hookform/resolvers": "^3.2.0",
-   "@perses-dev/components": "^0.51.0-rc.1",
-   "@perses-dev/core": "^0.51.0-rc.1",
-   "@perses-dev/plugin-system": "^0.51.0-rc.1",
    "date-fns": "^4.1.0",
    "date-fns-tz": "^3.2.0",
    "echarts": "5.5.0",
    "lodash": "^4.17.21",
    "react": "^17.0.2 || ^18.0.0",
    "react-dom": "^17.0.2 || ^18.0.0",
    "use-resize-observer": "^9.0.0",
    "immer": "^10.1.1"
  }
```

4. Then run `npm install` on the plugin folder to update the dependencies of your plugin (e.g., `cd perses/plugins/timeserieschart && npm install`).

plugins

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README