Ruflet

Ruflet is a Ruby framework inspired by Flet for building web, desktop, and mobile apps in Ruby.

Class-based apps are the recommended and documented standard:

• class MyApp < Ruflet::App
• implement def view(page)

Start Here

1. Install mobile client app from releases:

• Ruflet Releases
• Install the latest Android APK or iOS build.

2. Install gems from RubyGems:

gem install ruflet_cli

3. Create and run your first app:

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

4. Open Ruflet mobile client and connect:

• Enter URL manually, or
• Tap Scan QR and scan QR shown by ruflet run ...

Package Split

Ruflet is split into packages:

• ruflet: runtime umbrella package
• ruflet_server: WebSocket runtime
• ruflet_cli: CLI executable (ruflet)
• ruflet_rails: Rails integration

Monorepo folders:

• packages/ruflet
• packages/ruflet_server
• packages/ruflet_cli
• packages/ruflet_rails

New Project Behavior

ruflet new <appname> generates a Gemfile that references ruflet.

It does not add ruflet_cli to app dependencies.

That keeps CLI global/tooling-level and app deps runtime-focused.

App Style (Required in docs/examples)

Use class-based apps:

require "ruflet"

class MyApp < Ruflet::App
  def view(page)
    page.vertical_alignment = Ruflet::MainAxisAlignment::CENTER
    page.horizontal_alignment = Ruflet::CrossAxisAlignment::CENTER
    page.title = "Hello"
    page.add(text(value: "Hello Ruflet"))
  end
end

MyApp.new.run

CLI

ruflet new <appname>
ruflet run [scriptname|path] [--web|--mobile|--desktop]
ruflet build <apk|ios|aab|web|macos|windows|linux>

By default ruflet build ... looks for Flutter client at ./ruflet_client.
Set RUFLET_CLIENT_DIR to override.

Development (Monorepo)

cd /Users/macbookpro/Documents/Izeesoft/FlutterApp/ruflet
/opt/homebrew/opt/ruby/bin/bundle install

Documentation

• Creating New App
• Widgets Guide
• Example apps: main.rb, solitaire.rb, calculator.rb