CLI Reference
Complete documentation for the Uvel command-line interface. Run, debug, and build your applications.
Jump to
Overview
The uvel executable is your entry point for all operations. It must be in your system PATH.
Usage
uvel <command> [options]| Command | Description |
|---|---|
run | Execute an application normally. |
dev | Run with DevTools and Hot Reload enabled. |
build | Compile the application to a standalone EXE. |
new | Create a new project from a template. |
--version | Display the installed version. |
--help | Show help information. |
uvel run
Starts the application in production mode. No debug logs or hot reload.
uvel run App.xmlIf you don't specify a file, it looks for uvel.json or App.xml in the current folder.
uvel dev
Starts the application in development mode. This enables:
- Hot Reload: UI updates on file save.
- DevTools Server: Accessible at http://localhost:9222.
- Console Logs: Output visible in terminal.
uvel dev App.xml [options]Options
| Flag | Description |
|---|---|
-p, --port <number> | Set DevTools HTTP port (default: 9222). |
--no-debug | Disable interactive console (useful for scripts). |
Examples
uvel dev App.xml --port 8080uvel build
Compiles your project into a single, dependency-free executable.
uvel build App.xml [options]Options
| Flag | Description |
|---|---|
-o, --output <dir> | Output directory (default: ./build). |
-n, --name <name> | Name of the executable (e.g., MyApp). |
-i, --icon <path> | Application icon (.ico file). |
--console | Keep console window visible (for debugging). |
--compress | Optimize binary size (removes debug symbols). |
Examples
uvel build App.xml -o ./dist -n Calculator --icon icon.icouvel new
Creates a new project folder with starter files.
uvel new <ProjectName> [template]Templates
| Name | Description |
|---|---|
default | Basic Hello World app (default). |
calculator | A fully functional calculator. |
todo | Todo list application. |
Examples
# Create basic app
uvel new MyAwesomeApp
# Create calculator
uvel new MyCalc calculator