Introduction

NOTE: The documentation is in progress and expected to cover all CSS and features by december 16th.

****Flutter-view is an open source tool that makes writing reactive Flutter layouts a breeze. It lets you use Pug and Sass (or HTML and CSS if you prefer) to generate the Flutter Dart code that renders the views in your app.

You use it by running the flutter-view command in your terminal to let it monitor your project. When it detects changes in a Pug, HTML, Sass or CSS file, it automatically generates or updates a matching Dart file.

Why views in Flutter

In standard Flutter Dart code, the "state" of your application is mixed in with the presentation. This can make it hard to structure and scale your code.

Flutter-view is about creating views, which are functions that return a widget tree for presenting something. These functions act a bit like components. Flutter-view uses Pug to make layouts more terse and Sass to let you style faster and more easily.

The state part comes into play when you make your view reactive. You can pass models (or streams) into your views. When these models change, the views automatically adapt.

Creating a view

A single flutter-view generates a Dart function that usually returns a widget tree. You can either use Pug or HTML:

{% tabs %} {% tab title="Pug" %} {% code-tabs %} {% code-tabs-item title="hello.pug" %}

hello(flutter-view)
    .greeting Hello world!

{% endcode-tabs-item %} {% endcode-tabs %} {% endtab %}

{% tab title="HTML" %} {% code-tabs %} {% code-tabs-item title="hello.html" %}

<hello flutter-view>
    <div class="greeting">
        Hello world!
    </div>
</hello>

{% endcode-tabs-item %} {% endcode-tabs %} {% endtab %}

{% tab title="Generated Dart" %} {% code-tabs %} {% code-tabs-item title="hello.dart" %}

Container Hello() {
    return Container(
        child: Text("Hello world!")
    );
}

{% endcode-tabs-item %} {% endcode-tabs %} {% endtab %} {% endtabs %}

This generated function can be used like any other Dart code, and will return the code that gives the greeting.

Adding Styling

You can add Sass/CSS to styles to your view. Flutter-view contains plugins that take your CSS properties and convert them into code. For our example, you can easily add a text color, background color, some font properties, and add padding:

{% tabs %} {% tab title="Pug" %} {% code-tabs %} {% code-tabs-item title="hello.pug" %}

hello(flutter-view)
    .greeting Hello world!

{% endcode-tabs-item %} {% endcode-tabs %} {% endtab %}

{% tab title="Sass" %} {% code-tabs %} {% code-tabs-item title="hello.sass" %}

.greeting
    color: red
    background-color: grey[200]
    text-transform: uppercase
    padding: 10 20

{% endcode-tabs-item %} {% endcode-tabs %} {% endtab %}

{% tab title="Generated Dart" %} {% code-tabs %} {% code-tabs-item title="hello.dart" %}

Hello() {
    return DefaultTextStyle.merge(
        style: TextStyle(
            color: Colors.red
        ),
        child: Container(
            decoration: BoxDecoration(
                color: Colors.grey[200]
            ),
            padding: EdgeInsets.only(
                top: 10,
                right: 20,
                bottom: 10,
                left: 20
            ),
            child: Text("Hello world!".toUpperCase),
        )
    );
}

{% endcode-tabs-item %} {% endcode-tabs %} {% endtab %} {% endtabs %}

Flutter-view supports many CSS properties, and makes it easy to change styles and immediately see the effect. Since single CSS rules can apply to many elements, small CSS changes may have big code effects.

You can also fully leverage both Pug and Sass mixin and function support, allowing for some powerful patters, such as different styling based on running Android or iOS.

Making it Reactive

Flutter-view does not force you into any particular Reactive model. For example it works well with streams. However, it comes with native ScopedModel support and a small Dart support library for terse reactive coding:

{% tabs %} {% tab title="user.dart" %} {% code-tabs %} {% code-tabs-item title="user.dart" %}

class User extends Model {
    User({this.name, this.age});

    String name;
    int age;
}

{% endcode-tabs-item %} {% endcode-tabs %} {% endtab %}

{% tab title="hello.pug" %} {% code-tabs %} {% code-tabs-item title="hello.pug" %}

hello(flutter-view :user)
    reactive(watch='user')
        .greeting Hello ${user.name}!

{% endcode-tabs-item %} {% endcode-tabs %} {% endtab %}

{% tab title="generated hello.dart" %} {% code-tabs %} {% code-tabs-item title="hello.dart" %}

Widget Hello({user}) {
    return ReactiveWidget(
        watch: user as Listenable,
        builder: (context, $) {
            return Container(
                child: Text("Hello ${user.name}!")
            )
        },
    );
}

{% endcode-tabs-item %} {% endcode-tabs %} {% endtab %} {% endtabs %}

The view (hello.pug) takes a User (user.dart) as a parameter and watches it for changes. Now when we change the the user name and call user.notifyListeners(), the view will automatically update.