Empathetech Flutter UI

Build apps for anyone

EFUI is a holistic foundation for digital accessibility.

EFUI provides a starter kit for every pillar of digital accessibility:

  • Platform availability
    • Thanks to Flutter, EFUI is fully cross platform! EFUI can build apps for Android, iOS, Linux, MacOS, Windows and Web!
      • Thanks to integration with Flutter Platform Widgets, apps built with EFUI will gracefully adapt to Cupertino (Apple) and Material (Android and beyond) styling
  • Screen reader compliance
    • All custom Widgets and the example app have been manually verified with TalkBack and VoiceOver
  • User customization
    • The only way to be truly accessible for ALL customers is to empower them with the freedom of choice.
      EFUI enables you to expose any piece of your app's theme to the user.
      • Users can have full control of theme colors, fonts, styling, spacing, and images.
  • Internationalization
    • All of EFUI's external text has been translated to Spanish. With the infrastructure for internationalization laid out, the only work left are the translations themselves.
      • Moral fiber moment: Remember that LLMs are a tool for acceleration. But, there's a lot more to winning a race than acceleration. If your translations are generated, disclose that. EFUI's translations started with A.H.I. and ended with H.I.
  • Responsive design

When built with EFUI, your apps can truly reach any audience. Let's make the internet a more accessible place together!

Table of Contents


In your app's base directory, run

flutter pub add empathetech_flutter_ui

And add the following import to any files that use EFUI's library!

import 'package:empathetech_flutter_ui/empathetech_flutter_ui.dart';

Beginner tutorials

If you're new to Flutter: welcome! The example app is full of comments to help you on your path.

Here are some (unaffilliated!) videos you might also find helpful.



  1. a) Add any imports you're missing from the header below to your main.dart and
    b) Initialize EzConfig in your void main()
  2. Use an EzAppProvider to build your PlatformApp
    OR use ezThemeData in your existing provider/app
    OR use EzConfig.instance data to build your theme
  3. Migrate all example app screens to your project
  4. Enjoy


Step 1

In your main.dart add any imports you're missing...

import 'utils/utils.dart';
import 'screens/screens.dart';

import 'package:empathetech_flutter_ui/empathetech_flutter_ui.dart';

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:go_router/go_router.dart';
import 'package:shared_preferences/shared_preferences.dart';
import 'package:flutter_platform_Widgets/flutter_platform_Widgets.dart';

...and initialize EzConfig in your void main() Function.

void main() async {

  final SharedPreferences prefs = await SharedPreferences.getInstance();

    // Paths to any locally stored images the app uses
    assetPaths: [],

    preferences: prefs,

    // Your brand colors, custom styling, etc
    customDefaults: {},

  runApp(const EFUIExample());

How it works

EzConfig gathers all the theme data for our apps. It starts with Empathetech's config to make sure every key has a value, then it merges in your customDefaults and the user's saved preferences.

Once complete, EzConfig stores the gathered data in a globally accessible finalized instance.

Step 2

In main.dart, use an EzAppProvider to build your PlatformApp

class EFUIExample extends StatelessWidget {
  final Key? key;

  const EFUIExample({this.key}) : super(key: key);

  Widget build(BuildContext context) {
    return EzAppProvider(
      app: PlatformApp.router(
        debugShowCheckedModeBanner: false,

        // Supported languages
        supportedLocales: Lang.supportedLocales + EFUILang.supportedLocales,

        // Language handlers
            Lang.localizationsDelegates + EFUILang.localizationsDelegates,

        title: "Emapathetech Flutter UI",
        routerConfig: _router,

How it works

EzAppProvider is a PlatformProvider wrapper that uses ezThemeData by default.

You are more than welcome to use your own app/app provider with ezThemeData for the same effect.

Or, with quite a bit more effort, you can even build your own fully custom base theme with EzConfig.instance data.

Step 3

Copy the settings sandbox!

The example app is built to be a drop-in solution for your app's settings section.

Copy/paste all the screen files and routes from main.dart (below)

// Initialize a path based router for web-enabled apps
// Or any other app that requires deep linking
// https://docs.flutter.dev/ui/navigation/deep-linking
final GoRouter _router = GoRouter(
  initialLocation: homeRoute,
  routes: <RouteBase>[
      name: homeRoute,
      path: homeRoute,
      builder: (BuildContext context, GoRouterState state) {
        return const HomeScreen();
      routes: <RouteBase>[
          name: styleSettingsRoute,
          path: styleSettingsRoute,
          builder: (BuildContext context, GoRouterState state) {
            return const StyleSettingsScreen();
          name: colorSettingsRoute,
          path: colorSettingsRoute,
          builder: (BuildContext context, GoRouterState state) {
            return const ColorSettingsScreen();
          name: imageSettingsRoute,
          path: imageSettingsRoute,
          builder: (BuildContext context, GoRouterState state) {
            return const ImageSettingsScreen();

Rename the (just copied) Home.dart file and HomeScreen() class to something more appropriate; like Settings.dart and SettingsScreen(). Then, create a link to SettingsScreen in your app, and boom!

It's that Ez!

How it works

The example app's screens neatly organize all the custom Widgets that enable EFUI's user customization!

By default, every base theme setting is exposed. Any keys provided to customDefaults can be updated with these Widgets. If there are any theme values you wish to stay constant, simply remove the paired setting Widget.

Step 4


The pillars of platform availability and user customization are "set it and forget it"; bar any external libraries that break things.

But, as you grow your apps, the other pillars require continuous development.

Thankfully, EFUI's got you covered there too! Check out the...

  • Responsive Widgets: Widgets that aid in building responsive UI/UXs
  • Accessibility Widgets: Widgets with streamlined semantics and/or Widgets that adapt to accessibilty flags, like EzDominantHandSwitch

and even extension packages, like efui_video_player!

But, this should be plenty to get you started (and avoid overload). Once you're feeling settled, the code has been organized to aid in exploration!


From the example

Platform availability

Android iOS
Home page on Android Home page on iOS
Linux MacOS Windows
Home page on Linux Home page on macOS Home page on Windows
Home page on Web

Screen reader compliance

User customization

Core settings example Style settings example Color settings example
Image settings example Font picker preview Margin setting preview
Circle setting preview Color picker preview Update image preview


Core settings in Spanish Style settings in Spanish Color settings in Spanish Image settings in Spanish

Screen reader semantics are also internationalized!

Responsive design

Checkout the link to our site below. If you're using a monitor, play around with the window size! Using a phone or tablet? Rotate your device!



The vibes!

If you build something with EFUI, let us know! We'd love to have a third-party live section


Please reach out to the community contact about becoming a contributor. Emapthetech LLC doesn't tend to run out of ideas, only time! Here are a few current...

Planned features

  • More languages! If you speak English and a currently unsupported language, please reach out!
  • More EzWidgets with required and/or preconfigured semantics
  • Querying GoogleFonts rather than relying on a predetermined list


Many thanks for any and all donations! We're happy to have helped!




Cash App


Buy Me a Coffee






Thank you to M Ramirez for verifying EFUI's Spanish translations!

Flutter OSS

EFUI wouldn't be as awesome as it is without these other awesome community projects...

And, of course, all the awesome Flutter (Google) devs.


EFUI makes building accessible and user customizable UIs EZ. So anyone can enjoy your great idea!