 
  Provides a structured workflow for configuring devices, developing custom services, and managing product customization through a unified platform.
The low-code development approach uses the Shelly extension for Visual Studio Code, integrating features from the Shelly X portal directly into Visual Studio Code. This allows you and your developers to access device configuration tools, firmware settings, and cloud integration options from within their code editor.
You can:
Shelly extension for Visual Studio Code enables seamless provisioning, testing, and deployment of device logic, making it easy to build and maintain products tailored to your hardware — all without switching tools.
The solution supports visual configuration of hardware features, combined with the ability to define custom logic using structured scripting.
You can try the No-code approach first and decide what works best.
Step 1:
Set up your workspace
Install the Shelly extension for Visual Studio Code and sign in with your OEM account if you have one. Access the embedded portal features and start a new project.
Install and configure Visual Studio Code.
Download the Shelly extension for Visual Studio Code from the official Shelly X website.
You can install the Shelly Extension for Visual Studio Code and begin developing your service without registering in the portal. Later, an active OEM account is required to apply configuration tokens and to access product management and collaboration tools.
When you are ready to define your product, manage configurations, or apply tokens to a Shelly module, sign in to the portal.
In the Shelly extension for Visual Studio Code, you can:
A firmware service is a modular extension that runs directly on the device, providing core functions such as telemetry, connectivity, and data processing, while implementing the specific features required by your product.
If you need help with using the Shelly X portal, the Shelly extension for Visual Studio Code, selecting compatible modules, or have any general questions, please refer to the documentation or contact our technical support team directly.
Step 2:
Define your product
Log in and start a new product entry in the portal by specifying the name, type, and preferred development method.
Note: The development method cannot be changed later.
Add branding details such as the product image for the Shelly mobile app, a URL with product information, and a short description.
or
Start with your firmware service, and configure the product entity later.
Choose a compatible Shelly module based on your hardware design and required features.
The selection of a module is required before proceeding with service development or token provisioning.
Step 3:
Develop your custom firmware service
Write a JavaScript-based service to define your product’s behavior. Build the local UI interface to control the product.
The Shelly extension for Visual Studio Code allows you to declare and set up components, parameters, and logic in a standardized format. Ensure the structure is valid - this manifest governs how your device operates and interacts with the UI.
The service executes in parallel with the main firmware and interacts with the device hardware using predefined APIs. You can define device behavior, automation logic, and custom handling of inputs/outputs here.
The main entry point is a dynamically loaded Svelte file that defines the layout, user interactions, and components for the device’s local web interface. This file is injected into the core Shelly UI and serves as the foundation for how users interact with your custom service.
Component - represents a logical interface to a feature (e.g., sensor, UART).
It can either map directly to physical hardware or simulate behavior for testing and abstraction.
Step 4:
Apply, test, and prepare for production
Download the configuration token or apply it directly to your Shelly X module via Bluetooth.
Power on your product, verify that it loads the correct settings, and test all configured features.
Make adjustments if the behavior does not match your expectations, then reapply the updated configuration as needed.
From your product’s detail page in the Shelly X portal, use the dedicated dialog to apply the configuration token. The process includes a progress indicator and log output for troubleshooting and verification.
You can also apply the configuration token via the device’s local web interface.
First, download or copy the token from the same dialog.
Connect to the Shelly X device’s Wi-Fi Access Point.
Open http://192.168.33.1 in your browser.
Go to Settings → Shelly X → Apply Configuration.
Paste or upload the token, and click Save.
Connect your Shelly X module to the target hardware.
Validate key behaviors such as relay operation, button responses, and LED indicators.
Confirm Wi-Fi connectivity, cloud access, or local-only functionality based on your setup.
Review the user interaction and make adjustments if needed.
Step 5:
Manufacture, release, and analyze the results
Place your manufacturing order, launch your product, and track results through the dashboard and customizable reports in the Shelly X portal.
Indicate the number of modules you need and choose your preferred shipping options. The modules will be shipped with your configuration, ready for integration into your product.
Use the Shelly X portal dashboard to view detailed device activation reports and customize reports to fit your needs.
Monitor firmware versions, analyze regional usage patterns, and track connectivity data to optimize your product’s performance.
After launching your current product, start planning your next innovation. Collaborate with us to develop new ideas, improve features, and bring the next generation of smart devices to market faster and more efficiently.
Congratulations! Now your product is
