README.md

    Screenshots

    Responsive Framework

    Flutter Responsive Pub release GitHub Release Date GitHub issues GitHub top language GitHub code size in bytes Awesome Flutter Libraries.io for GitHub License

    Screenshots

    Responsiveness made simple

    Responsive Framework adapts your UI to different screen sizes automatically. Create your UI once and have it display pixel perfect on mobile, tablet, and desktop!

    The Problem

    Supporting multiple display sizes often means recreating the same layout multiple times. Under the traditional Bootstrap approach, building responsive UI is time consuming, frustrating and repetitive. Furthermore, getting everything pixel perfect is near impossible and simple edits take hours.

    Screenshots

    The Solution

    Use Responsive Framework to automatically scale your UI.

    ResponsiveBreakpoint.autoScale(600);

    Demo

    Minimal Website

    A demo website built with the Responsive Framework. View Code

    Flutter Website

    The flutter.dev website recreated in Flutter. View Code

    Pub.dev Website

    The pub.dev website recreated in Flutter. View Code

    Quick Start

    Pub release

    Import this library into your project:

    responsive_framework: ^latest_version

    Add ResponsiveWrapper.builder to your MaterialApp or CupertinoApp.

    import 'package:responsive_framework/responsive_framework.dart';
    
    class MyApp extends StatelessWidget {
      @override
      Widget build(BuildContext context) {
        return MaterialApp(
          builder: (context, child) => ResponsiveWrapper.builder(
              child,
              maxWidth: 1200,
              minWidth: 480,
              defaultScale: true,
              breakpoints: [
                ResponsiveBreakpoint.resize(480, name: MOBILE),
                ResponsiveBreakpoint.autoScale(800, name: TABLET),
                ResponsiveBreakpoint.resize(1000, name: DESKTOP),
              ],
              background: Container(color: Color(0xFFF5F5F5))),
          initialRoute: "/",
        );
      }
    }

    That's it!

    AutoScale

    Screenshots

    AutoScale shrinks and expands your layout proportionally, preserving the exact look of your UI. This eliminates the need to manually adapt layouts to mobile, tablet, and desktop.

    ResponsiveBreakpoint.autoScale(600);

    Flutter's default behavior is resize which Responsive Framework respects. AutoScale is off by default and can be enabled at breakpoints by setting autoScale to true.

    Breakpoints

    Screenshots

    Breakpoints control responsive behavior at different screen sizes.

    ResponsiveWrapper(
        child,
        breakpoints: [
            ResponsiveBreakpoint.resize(600, name: MOBILE),
            ResponsiveBreakpoint.autoScale(800, name: TABLET),
            ResponsiveBreakpoint.autoScale(1200, name: DESKTOP),
        ],
    )

    Breakpoints give you fine-grained control over how your UI displays.

    Introductory Concepts

    These concepts helps you start using the Responsive Framework and build an responsive app quickly.

    Scale vs Resize

    Flutter's default behavior is to resize your layout when the screen dimensions change. Resizing a layout stretches it in the direction of an unconstrained width or height. Any constrained dimension stays fixed which is why mobile app UIs look tiny on desktop. The following example illustrates the difference between resizing and scaling.

    Screenshots

    An AppBar widget looks correct on a phone. When viewed on a desktop however, the AppBar is too short and the title looks too small. Here is what happens under each behavior:

    1. Resizing (default) - the AppBar's width is double.infinity so it stretches to fill the available width. The Toolbar height is fixed and stays 56dp.
    2. Scaling - the AppBar's width stretches to fill the available width. The height scales proportionally using an aspect ratio automatically calculated from the nearest ResponsiveBreakpoint. As the width increases, the height increases proportionally.

    When scaled, the AppBar looks correct on desktop, up to a certain size. Once the screen becomes too wide, the AppBar starts to appear too large. This is where breakpoints come in.

    Breakpoint Configuration

    To adapt to a wide variety of screen sizes, set breakpoints to control responsive behavior.

    ResponsiveWrapper(
        child,
        maxWidth: 1200,
        minWidth: 480,
        defaultScale: true,
        breakpoints: [
            ResponsiveBreakpoint.resize(480, name: MOBILE),
            ResponsiveBreakpoint.autoScale(800, name: TABLET),
            ResponsiveBreakpoint.resize(1000, name: DESKTOP),
            ResponsiveBreakpoint.autoScale(2460, name: '4K'),
        ],
    )

    An arbitrary number of breakpoints can be set. Resizing/scaling behavior can be mixed and matched.

    • below 480: resize on small screens to avoid cramp and overflow errors.
    • 480-800: resize on phones for native widget sizes.
    • 800-1000: scale on tablets to avoid elements appearing too small.
    • 1000+: resize on desktops to use available space.
    • 2460+: scale on extra large 4K displays so text is still legible and widgets are not spaced too far apart.

    Additional Resources

    Resocoder Tutorial

    The wonderful people at Resocoder created a great tutorial video and article walking through the usage of the Responsive Framework at the link below.

    View Responsive Framework Tutorial

    Project Wiki

    No project wiki exists yet unfortunately. That means this is an opportunity for you to create and maintain the wiki for one of the most popular Flutter packages. This package needs your help with documentation!

    Please reach out via the contact links below if you are interested.

    About

    Responsive Framework was created out of a desire for a better way to manage responsiveness. The ability to automatically adapt UI to different sizes opens up a world of possibilities. Here at Codelessly, we're building a Flutter app UI and website builder, development tools, and UI templates to increase productivity. If that sounds interesting, you'll want to subscribe to updates below 😎

    Responsive Framework is licensed under Zero-Clause BSD and released as Emailware. If you like this project or it helped you, please subscribe to updates. Although it is not required, you might miss the goodies we share!

    Badges 🏆

    Now you can proudly display the time and headache saved by using Responsive Framework with a supporter's badge.

    Pub release

    [![Flutter Responsive](https://img.shields.io/badge/flutter-responsive-brightgreen.svg?style=flat-square)](https://github.com/Codelessly/ResponsiveFramework)
    Built Responsive
    <a href="https://github.com/Codelessly/ResponsiveFramework">
      <img alt="Built Responsive"
           src="https://raw.githubusercontent.com/Codelessly/ResponsiveFramework/master/packages/Built%20Responsive%20Badge.png"/>
    </a>
    Built with Responsive Framework
    <a href="https://github.com/Codelessly/ResponsiveFramework">
      <img alt="Built with Responsive Framework"
           src="https://raw.githubusercontent.com/Codelessly/ResponsiveFramework/master/packages/Built%20with%20Responsive%20Badge.png"/>
    </a>

    Contributors

    Design:

    Development:

    Sponsor: Codelessly - Flutter App UI and Website Builder

    Codelessly Email Codelessly Website Codelessly Twitter Codelessly GitHub

    Flutter is a game-changing technology that will revolutionize not just development, but software itself. A big thank you to the Flutter team for building such an amazing platform 💙

    Flutter

    License

    BSD Zero Clause License
    
    Copyright © 2020 Codelessly
    
    Permission to use, copy, modify, and/or distribute this software for any
    purpose with or without fee is hereby granted.
    
    THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
    REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
    AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
    INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
    LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
    OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
    PERFORMANCE OF THIS SOFTWARE.

    项目简介

    Easily make Flutter apps responsive. Automatically adapt UI to different screen sizes. Responsiveness made simple. Demo: https://gallery.codelessly.com/flutterwebsites/minimal/

    🚀 Github 镜像仓库 🚀

    源项目地址

    https://github.com/Codelessly/ResponsiveFramework

    发行版本 24

    v0.2.0

    全部发行版

    贡献者 6

    G Guo Zhang @Guo Zhang
    V Vinzent @Vinzent
    A Alexander Chapliuk @Alexander Chapliuk
    S Spencer Lindemuth @Spencer Lindemuth

    开发语言

    • Dart 100.0 %