Skip to content

Build and test custom Flora extensions locally before publishing.

Installation

To build and install your extension into a local Flora extensions folder, run npm run local-install. This will create a folder under your home directory (e.g. ~/.flora/extensions/unknown.myExtensionName-0.0.0) with your compiled extension.

Open the latest version of the Flora desktop app. You should now see myExtensionName in the list of installed extensions in your app settings.

Once installed, you should be able to open the "Add panel" menu and see an option called ExamplePanel. You've successfully loaded your first Flora extension!

To install local extensions on the web app, you must first packaged your extension and then drag-and-drop the .foxe file onto an open visualization page. You can also open .foxe files in the desktop app via drag-and-drop or double clicking.

Development

Each time you make a change to your extension, you must run npm run local-install to build it to your local extensions folder.

Reload or restart Flora to execute the latest version of your extension code in the app. Alternatively, you can confirm your code compiles without installing it locally by simply running npm run build.

Flora is developed on the source code of Foxglove and Lichtblick, adhering to the MPL 2.0 license.