Infrastructure/verdaccio
0
Fork 0
mirror of https://github.com/verdaccio/verdaccio.git synced 2024-12-16 21:56:25 -05:00
Code Issues Activity
verdaccio/website/versioned_docs/version-6.x/plugin-generator.md
Gweesin Chan d2ef7f1aea
docs: avoid using yo 5.x for plugin developer (#4617) 
* docs: avoid using yo 5.x for plugin developer

* Update v5 and v6

---------

Co-authored-by: Marc Bernard <59966492+mbtools@users.noreply.github.com>
2024-05-11 22:23:56 +02:00

2.7 KiB
Raw Permalink Blame History

id title
plugin-generator Plugin Generator

Installing the Yeoman Generator

Verdaccio is a pluggable application, with the objective to help developers to generate new plugins, we have a custom generator based in Yeoman for generate all sort of plugins.

To install the generator, as first step you must install the yeoman command yo.

npm install -g yo@4

then, install the custom generator running the following in your terminal.

npm i -g generator-verdaccio-plugin

:::caution

generator-verdaccio-plugin is not compatible with yeoman version 5 yet. You must use version 4 for it to function correctly.

:::

Using the generator

Use yeoman is quite straighforward, you can read more information about it here.

After a success install, run yo verdaccio-plugin in your terminal and follow the steps.

➜ yo verdaccio-plugin

Just found a `.yo-rc.json` in a parent directory.
Setting the project root at: /Users/user/verdaccio_yo_generator

     _-----_     ╭──────────────────────────╮
    |       |    │        Welcome to        │
    |--(o)--|    │ generator-verdaccio-plug │
   `---------´   │   in plugin generator!   │
    ( _´U`_ )    ╰──────────────────────────╯
    /___A___\   /
     |  ~  |
   __'.___.'__
 ´   `  |° ´ Y `

? What is the name of your plugin? (customname)

Best practices

  • We recommend using Typescript for developing new plugins, we provide an extense support of Types which help you along the development.
? What is the name of your plugin? my-plugin
? Select Language (Use arrow keys)
❯ typescript
  javascript
  • On describe your plugin, be brief and explicit, remember a good description will increase your chances your pluing to be used.
? Please, describe your plugin (An amazing verdaccio plugin)
  • Don't hesitate to include meaningful keywords, as verdaccio, plugin or your plugin type. Good keywords will help us to find you and future improvement in our collect information about all plugins.
? Key your keywords (comma to split) verdaccio,plugin,storage,minio,verdaccio-plugin
  • Keep your generator updated, don't miss any bug-fixes and performance improvements.

Contributing

Help us to improve the generator, you can contribute in the following repository.

https://github.com/verdaccio/generator-verdaccio-plugin