Important

This feature is currently in Early Availability (EA) status. For more information, see our product lifecycle phases.

Local Extension Development

Developing and testing your extension locally is required before publishing it to the marketplace. This guide describes how to run your extension on your local machine.

Before you begin, ensure the following:

• The UI Toolkit has been installed
• An extension has been created

Enable Developer Mode

The first step is to enable developer mode. This mode lets you run your extension on your local machine and test it before publishing. You can enable it on the extensions listing page. Once enabled, you have 8 hours to work on your extension from that computer; after 8 hours, you must re-enable it.

Here are the steps to enable developer mode:

1. Go to /admin/extensions in your marketplace.
2. Locate the extension you want to modify and click on the three dots, then select "Enable Developer Mode".
3. A message will confirm that developer mode has been enabled.

caution

The developer mode will be enabled for 8 hours and for this user only. Each developer must log in and enable developer mode for themselves to work on extensions locally.

Start the UI Toolkit

With developer mode enabled for your extension, it's time to start the UI Toolkit and work on your extension locally.

Follow these steps:

1. Open a command-line window (terminal or command prompt).

2. Navigate to the workspace folder you created with the UI Toolkit's setup command.

3. cd to your extension in the extensions directory. For example, if your extension is called my-extension, you'll find it at <your-workspace-name>/extensions/my-extension.

4. Run the command npm run start

5. The console should display a message indicating that the toolkit is running and the URL to access your extension locally.

   Welcome to your extension development environment!
   You can view  access your extension local version using the following URL:
   https://engage19billing.test.devappdirect.me/app/desiredPath?devMode=true&appName=microuits

6. Open this URL in your marketplace to see your extension running locally.

7. Changes you make to your extension will automatically update in the browser.

You can now work on your extension locally.