Skip to main content

LUAT CLI Reference

The Wolverine CLI (wunder) is Wunderframe's command-line tool for LUAT template development. It supports project initialization, development, and deployment tasks.

Installation​

Install the CLI via npm:

npm install -g @solutas/wunder-cli

Use wunder --help to see the available commands.

Commands​

wunder init​

Initializes a new Wunderframe project.

wunder init my-project
  • my-project: Directory name for the new project

wunder dev​

Starts development mode with file watching and live reloading.

wunder dev
  • Automatically compiles LUAT files and reloads on changes.

wunder build​

Builds frontend assets using the configured toolchain.

wunder build
  • Compiles CSS and JavaScript for production.

wunder bundle​

Bundles and compiles Lua and LUAT files into the dist directory.

wunder bundle

Options:

  • --pattern Glob pattern for source files (default: **/*.{lua,luat})
  • --output Output directory (default: dist)
  • --source Outputs Lua source bundle instead of binary

wunder deploy​

Deploys project files to the server.

wunder deploy
  • Syncs files matching watch patterns to the server.

wunder watch​

Watches files and uploads changes to the server.

wunder watch
  • Monitors file changes and syncs automatically.

wunder sync​

Synchronizes the local project with the server.

wunder sync
  • Updates server with local project changes.

wunder login​

Authenticates the CLI with your Wunderframe account.

wunder login
  • Required for deployments and remote actions.

wunder logout​

Logs out and removes credentials.

wunder logout
  • Ends the authenticated session.

wunder team​

Performs team-related operations (subcommands not shown).

wunder team --help

Best Practices​

Use wunder dev for development​

  • Provides a fast feedback loop with live reloading.

Commit your wunder.toml file​

  • Share consistent project configuration across your team.

Use wunder bundle in CI/CD​

  • Ensure your templates are compiled and ready for production.

Troubleshooting​

Command Not Found​

Ensure wunder is installed and available in your PATH.

npm install -g @solutas/wunder-cli

Permission Denied​

Run commands with appropriate permissions, potentially as an administrator.

Debugging​

Use --debug to enable verbose output for troubleshooting:

wunder bundle --debug