Skip to content

Contribute to the official plugins

Most plugins should live in their own source — see Use your own plugin source. The official plugins repository, iyulab/filer-official-plugins, is a narrower home for a smaller set of plugins that ship bundled with Filer itself.

A plugin fits the official repository when it’s broadly useful rather than tied to one person’s service — no third-party account of yours required to use it, or it covers a channel (Telegram, Slack, email, and the like) that a wide range of users already reach for. A plugin that talks to your own API, or serves a niche you built it for, belongs in your own source instead — that’s not a lesser path, it’s the right one for that plugin.

This site covers how a plugin is authored — manifests, tools, hooks, permissions. The repository-specific procedure — project structure convention, lint rules, and the pull request checklist — is in CONTRIBUTING.md in that repository. Read it before opening a pull request there; it covers the parts that are specific to landing a change in that repo rather than to writing a plugin in general.