Welcome to the official NucliOS VS Code UAIC Extension - a complete, integrated development environment for the NucliOS platform.
This extension brings the entire UIAC development lifecycle directly into your editor. Move seamlessly from browsing remote applications to editing, testing, merging, and deploying your code without ever leaving VS Code.
Features
Multi-Instance Management: Securely connect to, switch between, and manage multiple NucliOS environments (e.g., Development, Staging, Production).
Dynamic SSO Authentication: Supports both standard Username/Password and instance-aware Single Sign-On (OIDC) for any client environment.
Remote Code Browser: Intuitively navigate an application's hierarchical structure of screens, widgets, filters, and actions.
Full CRUD for App Variables: Create, read, update, and delete App Variables directly from the sidebar.
Safe Push/Merge Workflow:
Initiate a push to open a side-by-side diff view.
The server's code is presented in a read-only pane for safety.
Use merge arrows to pull incoming changes from the server into your local file.
Confirm the push to deploy your final, merged code, preventing accidental overwrites.
Remote Code Execution: Test your widget logic on the server using your local code and custom json test filters before deploying.
In VS Code, open the Extensions view (Ctrl+Shift+X).
Search for NucliOS Extension.
Click Install.
2. Open a Workspace
The extension requires a local folder to function. This is where you will save your UIAC files.
Go to File > Open Folder... and select or create a dedicated project folder. The UIAC icon will appear in the Activity Bar on the left, confirming the extension is active.
3. Add Your First NucliOS Instance
Connect the extension to your NucliOS server.
Open the UIAC Browser view from the Activity Bar.
Click the Add New Instance link (or run the UIAC: Add New Instance command from the Command Palette).
Follow the prompts at the top of the screen:
Instance Name: A friendly name for the connection (e.g., "Development Server").
Base URL: The backend URL of your NucliOS instance.
Authentication Method: Choose between Username/Password and SSO.
If you choose SSO, you must provide the Client ID and Tenant ID from your NucliOS administrator.
Core Workflow
Select an Application: Use the Code Browser to select the application you want to work with.
Fetch a File: Navigate the file tree and click a widget or other code file. It will open in a new, temporary "untitled" tab.
Save to Workspace: Before you can edit or test, you must save the file. Click the $(save-all) (Save to Workspace) icon in the editor's title bar.
Edit and Test:
Make changes to your saved file.
Click the $(filter) icon to configure test inputs.
Click the $(run-all) icon to execute the code on the server and see the results.
Push & Merge:
Click the $(repo-push) icon to start the push workflow.
A Diff View will open (SERVER (Read-Only) ↔️ LOCAL).
Use the -> arrow to merge any necessary changes from the server into your local file.
Click the $(send) Confirm Push button in the Status Bar to deploy your final code.
Commands
All commands are accessible via the Command Palette (Ctrl+Shift+P). Simply type UIAC: to see a full list.
Command
Description
UIAC: Add New Instance
Connect to a new NucliOS server.
UIAC: Switch Active Instance
Switch between your saved connections.
UIAC: Remove an Instance
Delete a saved connection.
UIAC: Login / UIAC: Logout
Authenticate with the currently active instance.
UIAC: Reload Connection
A shortcut to refresh your session token.
UIAC: Push Code to Server
Starts the safe push/merge workflow for a code file.
UIAC: Create App Variable
Creates a new App Variable for the current application.
Troubleshooting
SSO Error AADSTS50011: This means the http://localhost:3001 redirect URI is missing from your NucliOS application registration in Azure AD. Please contact your administrator and ask them to add it under the "Mobile and desktop applications" platform configuration.
Push button is missing: This button only appears for saved UIAC files and for users with the appropriate admin permissions on the server.
App list is empty after login: Your session may have expired. Run the UIAC: Reload Connection command to force a fresh login.
If any other queries contact: nuclios_support@mathco.com or net@mathco.com
