This is an Beta version

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

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_core
• packages/ruflet_server
• packages/ruflet
• packages/ruflet_rails

New Project Behavior

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

It does not add ruflet 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

What's Changed

• Dev by @AdamMusa in #1
• remove the hard coded icons by @AdamMusa in #2
• push new version to rubygem by @AdamMusa in #3
• Prebuild by @AdamMusa in #4
• try to fix the linux and ios buikd by @AdamMusa in #5
• try to fix the linux and ios build by @AdamMusa in #6
• Prebuild by @AdamMusa in #7
• Ruflet studio by @AdamMusa in #8
• make it self contain ruflet_rails by @AdamMusa in #9
• update the docs for ruflet_rails by @AdamMusa in #10
• Ruflet studio by @AdamMusa in #11
• set prebuiold by @AdamMusa in #12
• Prebuild by @AdamMusa in #13
• Dev by @AdamMusa in #15
• Dev by @AdamMusa in #16

Full Changelog: https://github.com/AdamMusa/ruflet/commits/prebuild-main