CLI Workflow

The Ruflet CLI creates projects, runs development clients, prepares Flutter tooling, builds applications, and installs build outputs.

Commands

ruflet --version
ruflet new <appname>
ruflet create <appname>
ruflet run [scriptname|path] [--web|--desktop] [--port PORT] [--no-reload]
ruflet update [web|desktop|all] [--check] [--force] [--platform PLATFORM]
ruflet debug [platform] [--device-id ID]
ruflet build <apk|android|ios|aab|web|macos|windows|linux> [--self] [--verbose]
ruflet install [--device DEVICE_ID] [--verbose]
ruflet devices
ruflet emulators
ruflet doctor [--fix] [--verbose]
ruflet help

Create and run

ruflet new my_app
cd my_app
bundle install
ruflet run main.rb

Mobile is the default run target. Use --web or --desktop to launch a managed local client:

ruflet run main.rb --web
ruflet run main.rb --desktop
ruflet run main.rb --port 9000

The run command resolves main and main.rb, starts the Ruby server, and prints the address used by the selected client.

Hot reload is on by default. While Ruflet is running, press r to rerun the app against the current page or R to restart the Ruby backend. Pass --no-reload when a watcher is not appropriate.

Build and install

ruflet build apk
ruflet build ios
ruflet build web
ruflet build macos

Builds are server-driven by default and require app.backend_url in ruflet.yaml. Add --self to package the Ruby project with the client:

ruflet build android --self
ruflet build ios --self

Install a compatible build on a connected device:

ruflet install
ruflet install --device emulator-5554

Client updates

ruflet update manages cached prebuilt web and desktop clients:

ruflet update all
ruflet update web --check
ruflet update desktop --platform macos
ruflet update all --force

Tooling commands

• ruflet doctor reports Ruby, Flutter, template, and platform-tool status.
• ruflet doctor --fix installs or downloads supported missing tooling.
• ruflet devices lists Flutter-visible devices.
• ruflet emulators lists emulators.
• ruflet emulators --start --emulator ID launches an emulator.
• ruflet debug web runs the managed Flutter client directly for client-side debugging.

See CLI Reference for every command option, alias, default, and exit behavior.