What is fish-redux?

alibaba/fish-redux — explained in plain English

Analysis updated 2026-06-24

★ 7,282DartAudience · developerComplexity · 3/5LicenseSetup · moderate

Mindmap

mindmap
  root((fish-redux))
    What it does
      Flutter state management
      Redux pattern
      Component isolation
    Tech stack
      Dart
      Flutter framework
    Key concepts
      State container
      Action dispatcher
      Reducer
      Effect handler
    Tooling
      IDE templates
      Todo list example

mindmap root((fish-redux)) What it does Flutter state management Redux pattern Component isolation Tech stack Dart Flutter framework Key concepts State container Action dispatcher Reducer Effect handler Tooling IDE templates Todo list example

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Build a large Flutter app with many screens that share global state without tangled prop passing

USE CASE 2

Organize Flutter UI into isolated pluggable components that each manage their own slice of data

USE CASE 3

Generate Redux boilerplate automatically using community IDE templates for Android Studio or VS Code

What is it built with?

DartFlutter

How does it compare?

	alibaba/fish-redux	rrousselgit/riverpod	openflutter/flutter-notebook
Stars	7,282	7,256	7,217
Language	Dart	Dart	Dart
Setup difficulty	moderate	moderate	easy
Complexity	3/5	3/5	2/5
Audience	developer	developer	developer

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Flutter SDK and familiarity with the Redux pattern, community IDE templates for Android Studio and VS Code reduce boilerplate setup.

Use freely for any purpose including commercial projects as long as you keep the copyright notice. Apache 2.0 license.

So what is it?

Fish Redux is a framework from Alibaba for building mobile applications using Flutter, which is a toolkit for writing apps that run on both iOS and Android from a single codebase. The framework addresses a common challenge in medium and large apps: keeping the user interface and the underlying data in sync without things getting messy as the app grows. It does this by using a pattern called Redux, which is an approach where all the data that drives the UI lives in one central place called a state container. Any change to the app's data flows through a predictable, one-way process, making it easier to understand what the app is doing at any moment and to track down bugs. Fish Redux adds its own layer on top of this by making it easy to break the app into independent, pluggable components that each manage their own slice of data. The library comes with a simple to-do list example to help new users get started. Developers working in Android Studio or Visual Studio Code can also install community-made templates that generate the required boilerplate code automatically, reducing the repetitive setup work when creating new screens or components. The project was created by the Xianyu team at Alibaba, which was reportedly one of the first teams in China to run Flutter in production at significant scale. The README and additional documentation are available in both English and Chinese. The library is released under the Apache 2.0 open-source license.

Copy-paste prompts

Prompt 1

Generate the Fish Redux component boilerplate, action, reducer, effect, and view files, for a Flutter user profile screen.

Prompt 2

Show me how to connect a Fish Redux global store to a new Flutter page so it can read and dispatch state changes.

Prompt 3

Explain how Fish Redux's Connector links a parent component's state slice to a child widget's local state.

Prompt 4

Write a Fish Redux Effect handler that fetches user data from a REST API and dispatches the result back to the reducer.

Frequently asked questions