Production-Ready Template

Build Flutter Apps
The Right Way

Fluxter is a scalable Feature-First architecture template with Riverpod, Dio, GoRouter, and Freezed. Install to any Flutter project with a single command.

Terminal
$ curl -sO https://raw.githubusercontent.com/dhotsky/fluxter/main/install.dart && dart run install.dart && rm install.dart
> curl.exe -sO https://raw.githubusercontent.com/dhotsky/fluxter/main/install.dart ; dart run install.dart ; del install.dart

Everything you need,
nothing you don't

A complete architecture foundation with best practices baked in, so you can focus on building features.

🏗️

Feature-First Architecture

Clean separation of concerns with Screen, Controller, and State pattern powered by Riverpod.

🌐

Network Layer

Pre-configured Dio + Retrofit with smart token refresh and automatic request queueing.

🛡️

Auth Guards

Declarative routing with GoRouter, built-in auth guards, and automatic force logout handling.

Code Generation

Freezed models, Retrofit clients, and JSON serialization — all with one command.

🎨

Theme System

Consistent dark/light theming with dynamic color resolver, context extensions, and persistent preference.

🧩

Widget Library

9 production-ready components: multi-variant Button, TextField, Alert, ListView, GridView, Image, InkWell, Loading Overlay, and Empty State.

🌍

Localization

Lightweight dual-language system (EN & ID) with .tr extension, parameterized translations, and persistent locale switching.

🧰

Extensions Library

Rich Dart extensions for DateTime formatting, String validation, numeric spacing, Widget layout wrappers, and BuildContext shortcuts.

Scaffold in seconds

Built-in CLI tools to generate features, models, repositories, and translations — zero boilerplate, maximum speed.

🚀

Feature Generator

Scaffold a complete feature (Screen + Controller + custom Freezed State) in one command.

dart run :fluxter_create profile --stateful --state
❄️

Model Generator

Generate Freezed models from JSON — paste and go. Supports feature targeting.

dart run :fluxter_model user --profile
📦

Repository Generator

Generate repository classes with optional ApiService and LocalStorage flags.

dart run :fluxter_repository payment --api-service --local-storage
🌐

Translation Generator

Add translation keys dynamically into localization files via interactive guide.

dart run :fluxter_translate
🖥️

UI Layer

Screen + Controller + State

📦

Data Layer

Repository + Models + Providers

⚙️

Core Layer

ApiClient, ApiResult, LocalStorage

Clean, layered
and scalable

Fluxter follows Clean Architecture principles with Feature-First + Repository pattern, ensuring your codebase stays maintainable as it grows.

  • Clear separation of concerns
  • Dependency injection via Riverpod
  • Type-safe API results with sealed classes
  • Smart token management with auto-refresh
  • Rapid UI generation with zero boilerplate
  • Built-in localization with .tr extensions
  • Rich extension library to reduce boilerplate

Built on the best

Industry-standard libraries carefully integrated to work together seamlessly.

📱

Riverpod

State Management

🧭

GoRouter

Navigation

🌐

Dio + Retrofit

HTTP & API Client

❄️

Freezed

Immutable Models

💾

SharedPrefs

Local Storage

🔧

BuildRunner

Code Generation

📐

JSON Serializable

Serialization

📅

intl

Date Formatting

🔍

Dio Interceptor

Network Logging

🎯

Flutter 3.44+

SDK

Up and running
in seconds

One command installs the entire architecture into your existing Flutter project.

Installation
$ curl -sO https://raw.githubusercontent.com/dhotsky/fluxter/main/install.dart && dart run install.dart && rm install.dart
> curl.exe -sO https://raw.githubusercontent.com/dhotsky/fluxter/main/install.dart ; dart run install.dart ; del install.dart
1

Run the command

Execute the one-liner in your Flutter project's root directory.

2

Interactive Setup

Configure localization options (EN/ID dual language), merge dependencies, and rename packages.

3

Start building

Generate features, models, repositories, and translation keys with rapid CLI generators.