/flt

Run Flutter Apps in the terminal

Primary LanguageRustBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

flt

flt is a Flutter Terminal Embedder, implementing the Flutter Engine's Custom Embedder API.

This embedder draws to the current terminal window using ANSI Escape Codes to create a Text-based user interface.

flt.demo.mp4

Why?

Mainly for fun to learn Rust and more about the Flutter Engine. It can also be a quick playground for Flutter without platform-specific or GUI specific dependencies; only a terminal is needed and it can even be used over SSH.

Supported Platforms / Terminals

This was mainly developed on WSL Linux using the Windows Terminal. It also works on Linux and iTerm2 on macOS. YMMV with other terminal emulators, though it might just work as interfacing with the terminal is done through a cross-platform library.

Not working yet:

  • Windows
  • Terminal.app on macOS

Checkout

This project uses submodules, so pass the --recurse-submodules flag.

git clone --recurse-submodules git@github.com:jiahaog/flt.git

Usage

Install Rust first, then at the root of the monorepo, the following command will build the Sample Flutter App, and run it with the terminal embedder.

cargo run

Other Flutter Projects

cargo run -- <path to the root of your flutter project>

More cli help

# See help for `flt-cli`.
cargo run -- --help

# See help for `flt`.
cargo run -- --args=--help

Project Structure

  • flt - The terminal embedder.
  • flt-cli - A small CLI utility to make local development easier. By default, the cargo run command at the root of the repository will run this.
  • flutter-sys - Safe Rust bindings to the Flutter Embedder API.
  • sample_app - A sample Flutter Project used for local development.
  • third_party/flutter - A submodule checkout of the Flutter Framework.

Missing Pieces

  • Windows support
  • Fix Terminal.app support on macOS
  • Keyboard support
  • Slow performance
  • Improve semantic label positions

References