packages/docs/plugins/plugin-store.md
Nuclear has a built-in plugin store. Open Preferences from the sidebar, and go to Plugins, and you'll see two tabs: Installed and Store.
The Store tab lists plugins from the official plugin registry hosted at github.com/NuclearPlayer/plugin-registry.
You can search by name, description, or author, and filter by category.
Click the Install button on any plugin. Nuclear downloads the latest release from the plugin's GitHub repository, extracts it, and loads it automatically. The button shows a spinner during installation and a checkmark when done.
After installation, the plugin appears in the Installed tab. Toggle it on to enable it.
<figure><figcaption></figcaption></figure>You can also install plugins from a local folder. In the Installed tab, click "Add Plugin" and select a folder containing a plugin (a directory with a package.json and an entry file).
Manually installed plugins have one extra feature: a reload button. Click it to re-read the plugin source from the original folder, recompile, and reload. This is useful during development. Store-installed plugins don't support reload; remove and reinstall to get a new version. Auto-update is planned for the future.
Toggle the switch on any installed plugin. Disabling a plugin disables its functionalities. Toggle it back on to re-enable.
Click the remove button to fully uninstall a plugin. This deletes its files and removes it from Nuclear.
Dev plugins show a reload button that re-reads the source from the original folder and reloads the plugin. Store plugins don't have this option.
There's no automatic update mechanism yet, but it's planned for the future. To update a store-installed plugin, remove it and reinstall from the store. Nuclear always fetches the latest GitHub release, so reinstalling picks up any new version the developer has published.
Nuclear copies all plugins (both store and dev) into a managed directory inside your app data folder at plugins/{id}/{version}/. The running code always comes from this managed copy.
For dev plugins, the original source folder is preserved and used when you click reload.