Authorization policies and feature flags for Flutter.

Define who can do what with policies, toggle functionality with feature flags, and wire both into your UI with declarative widgets. Works with vanilla Flutter, Provider, Riverpod, Bloc, and GetX.

• Policy-based authorization — view, create, update, delete, and custom abilities per model
• Feature flags — sync, async, observable, rollout percentage, and runtime overrides
• Declarative widgets — Can, Cannot, FeatureGuard, and BuildContext extensions
• Hooks — global before/after interceptors for admin bypasses and audit logging
• Code generation — auto-register policies and features with build_runner
• State management adapters — Provider, Riverpod, Bloc, GetX
• Pure Dart core — flutter_gate_core has no Flutter dependency

dependencies:
  flutter_gate: ^0.1.1

Optional adapters and generator:

dependencies:
  flutter_gate_riverpod: ^0.1.1

dev_dependencies:
  flutter_gate_generator: ^0.1.1
  build_runner: ^2.4.0

1. Register policies and features at startup:

import 'package:flutter_gate/flutter_gate.dart';

void main() {
  gate.policy<Post>(() => PostPolicy());
  gate.define(const DarkModeFeature());
  runApp(const MyApp());
}

2. Define a policy:

class PostPolicy extends Policy {
  @override
  PolicyResponse update(dynamic user, dynamic model) {
    final post = model as Post;
    return PolicyResponse.fromBool(user == post.authorId);
  }
}

3. Guard UI with Can:

Can(
  ability: 'update',
  user: currentUserId,
  model: post,
  child: IconButton(icon: Icon(Icons.edit), onPressed: onEdit),
)

4. Toggle features with FeatureGuard:

FeatureGuard<DarkModeFeature>(
  child: DarkThemeSettings(),
  fallback: SizedBox.shrink(),
)

See the full example app for end-to-end usage.

# Install melos
dart pub global activate melos

# Bootstrap all packages
melos bootstrap

# Analyze and test
melos run analyze
melos run test

MIT — see LICENSE.