Sources

Sources provide reusable Plugin definitions packaged as a Git repository.

Adding Sources

Sources are added to the qlty.toml configuration file in your repository using the following syntax:

1
[sources.default]
2
repository = "https://github.com/example/qlty-plugins.git"
3
tag = "v1.2.3"
4
# OR
5
# branch = "main"

Each Source declaration can point to either a tag or a branch. If you target a tag, Qlty will fetch and checkout that tag when it first runs, and will never try to update it. If you target a branch, Qlty will check for updates to the named branch each time it runs.

Default Source

Qlty maintains a default source with linters, formatters, and security scanners which is automaticaly added to qlty.toml when initializing a new project:

1
# ...
2
3
[sources.default]
4
repository = "https://github.com/qltysh/qlty.git"
5
branch = "main"
6
7
# ...

Custom Sources

You are not limited to the default source provided by Qlty. You can create your own custom Sources and reuse them across multiple projects.

To do this, simply create a public Git repository with the following structure:

$
  your-source-repository/
>
  └─ linters/
>
     └─ [linter-name]/
>
        └─ plugin.toml