Local Project Setup
Before developing a WMX Widget, you need to set up your project locally, so you can add the component directly into the WaveMaker project files. Once added, you can push your changes back to Studio and start using the new WMX Widget in your app.
1. Set Up the Project Locally
- In WaveMaker Studio, go to: Settings → Export → Export Project as Sources (ZIP)
- Download and extract the ZIP file to your local system.
- Open the extracted folder in your preferred an Editor/IDE (e.g., Visual Studio Code).
- You can now create or edit WMX Widgets and make other custom modifications locally.
2. Enable Project Sync
To push your local changes to Studio (and pull updates from Studio), you need to set up Project Sync.
Prerequisites
Following software must be installed and configured on your system.
Initialize WaveMaker Workspace Sync
- Open a terminal in your project’s root directory.
- Run:
- Press
y
when prompted. - When prompted, provide:
- WaveMaker Studio Host URL
- Your login credentials using Email & Password or a Token (Token can be generated at
https://<WaveMaker_Studio_Host>/studio/services/auth/token
)
- When prompted, select the correct project number.
note
- Host URL is the domain of your WaveMaker Studio.
- You must keep your WaveMaker Studio session open until the sync completes.
3. Sync Commands
- Pull changes from Studio:
- Push changes to Studio:
Once your custom component is added, use the push
command to upload it to Studio and start using it in your project.