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.
nimbus dev App.xml
Once the app starts, open your web browser and navigate to:
You can change the port using the --port flag:
nimbus dev App.xml --port 8080
2. Key Features
State Inspector
View all active variables (`count`, `username`, etc.) and their current values in real-time.
Console
Execute handlers, set variables, and run system commands directly from the browser.
Live Logs
Stream application logs (`INFO`, `ERROR`, `DEBUG`) as they happen.
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.
State Variables
Recent Logs
4. DevTools API
The DevTools server exposes a REST API that you can use to build your own tools or integrate with other systems.
| Endpoint | Method | Description |
|---|---|---|
/status | GET | Get engine status, version, and OS info. |
/state | GET | Get a JSON object of all variables. |
/controls | GET | List of all registered UI controls. |
/logs | GET | Get recent log entries. |
/reload | GET | Trigger hot reload. |
/exec | POST | Execute a handler by name. Body: handlerName |
/set | POST | Set 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