Running a Ruflet App

Run a project's Ruby entrypoint through Bundler:

bundle exec ruflet run main.rb

Mobile is the default target. Ruflet starts the Ruby server and prints the connection details used by Ruflet Explorer.

Web and desktop

bundle exec ruflet run main.rb --web
bundle exec ruflet run main.rb --desktop

The web command starts a same-origin local web client. The desktop command starts the cached desktop client for the host platform.

Script and port resolution

main and main.rb both resolve to the same entrypoint:

bundle exec ruflet run main
bundle exec ruflet run path/to/app.rb
bundle exec ruflet run main.rb --port 9000

If the requested port is unavailable, Ruflet selects an available port and prints the address it actually uses.

When a Gemfile is found, the run command checks the bundle and runs bundle install if dependencies are missing.

Debug the managed client

Use ruflet debug when you need to run the underlying Flutter client directly:

ruflet debug web
ruflet debug ios
ruflet debug --device-id chrome

Normal Ruby application development should use ruflet run.