DevTools

DevTools

A powerful browser-based debugger built directly into the Nimbus Engine. Inspect state, view logs, and control your app remotely.


1. How to Access

DevTools are automatically enabled when you run your application in development mode.

Terminal
nimbus dev App.xml

Once the app starts, open your web browser and navigate to:

link
http://localhost:9222

You can change the port using the --port flag:

nimbus dev App.xml --port 8080

2. Key Features

database

State Inspector

View all active variables (`count`, `username`, etc.) and their current values in real-time.

terminal

Console

Execute handlers, set variables, and run system commands directly from the browser.

list_alt

Live Logs

Stream application logs (`INFO`, `ERROR`, `DEBUG`) as they happen.

refresh

Hot Reload

Trigger a UI refresh manually or see file change notifications.


3. Interface Tour

Here is an interactive preview of what the DevTools interface looks like.

http://localhost:9222
📊 Status
📦 State Variables
🎮 Controls
⚡ Handlers
📝 Logs

State Variables

username "Admin"
isLoggedIn true
cartItems 5
appVersion "3.0.0"

Recent Logs

[INFO] Application started
[INFO] Plugin 'MathPlugin' loaded
[ERROR] File 'config.json' not found

4. DevTools API

The DevTools server exposes a REST API that you can use to build your own tools or integrate with other systems.

EndpointMethodDescription
/statusGETGet engine status, version, and OS info.
/stateGETGet a JSON object of all variables.
/controlsGETList of all registered UI controls.
/logsGETGet recent log entries.
/reloadGETTrigger hot reload.
/execPOSTExecute a handler by name. Body: handlerName
/setPOSTSet variable. Body: key=value

Example Request

You can control your app using `curl` or Postman:

# Get all variables
curl http://localhost:9222/state

# Execute a handler
curl -X POST -d "LoginHandler" http://localhost:9222/exec

# Set a variable
curl -X POST -d "theme=dark" http://localhost:9222/set