Ktor Plugin Registry

This project contains references to all Ktor plugins available in the web-based Ktor project generator and the IDEA plugin.

Adding a plugin

To add a new plugin, follow these easy steps:

1. Publish your project to Maven.

   • Use the gradle maven publish plugin to publish to Maven Central or some other public Maven repository.
   • We read from repositories listed in Repositories.kt.
   • If you'd like to include another Maven repository for your plugin, include an update to Repositories.kt in your pull request in step 2. It should have public read access.
     
     

2. Fork and clone this repository.
   
   

3. Run ./gradlew createPlugin

   • This will prompt you with a couple questions about the new plugin.
   • After it is completed, you should have some new files in this structure:

   plugins
   └── server
       └── <group>
           ├── group.ktor.yaml
           └── <plugin-id>
               ├── versions.ktor.yaml
               └── 2.0
                   ├── manifest.ktor.yaml
                   ├── install,kt
                   └── documentation.md
   

   • You can include any number of install files for populating new projects. More information under templates/manifest.ktor.yaml. The existing plugin files under the plugins folder can also be useful reference for introducing new plugins.
   • If your plugin artifacts aren't published on Maven Central you may need to add an entry to the allRepositories() function in the Repositories.kt file.
     
     

4. Run ./gradlew --console=plain -q buildRegistry to test the new files.
   
   

5. Create a pull request with the new changes.

   • Once merged, your plugin will be available in the ktor project generator.