BlocSimple

A simplified approach to using the BLoC pattern in Flutter. Reduce boilerplate, improve readability, and streamline state management with powerful utilities.

✨ Features 🔄 Simplified State Management Pre-defined SimpleState

📉 Minimal Boilerplate Just extend SimpleCubit or SimpleBloc, no extra setup required.

🔌 Repository Integration Easily connect BLoCs and Cubits to external data sources with RepositoryConnector.

⚡ Async Execution Automatically handle async loading, success, and error states using executeAsync.

🧪 Testing Support Built-in testing utilities for unit and widget tests.

🚀 Installation Add this to your pubspec.yaml:

yaml Copy Edit dependencies: bloc_simple: ^1.0.2 📦 Usage 🧮 Counter Cubit Example dart Copy Edit class CounterCubit extends SimpleCubit

void increment() => setSuccess((state.data ?? 0) + 1); void decrement() => setSuccess((state.data ?? 0) - 1); } 🖼️ In UI dart Copy Edit BlocBuilder<CounterCubit, SimpleState

Future

@override void registerEventHandlers() { on

SimpleState.initial() – Initial idle state

SimpleState.loading() – While loading

SimpleState.success(data) – On success

SimpleState.error(message) – On error

🧪 Testing Utilities Easily test your SimpleCubit or SimpleBloc with:

dart Copy Edit testSimpleCubit

Example

Here's a complete example in example/main.dart:

import 'package:bloc_simple/simple_cubit.dart';
import 'package:bloc_simple/state_types.dart';
import 'package:flutter/material.dart';
import 'package:flutter_bloc/flutter_bloc.dart';

void main() {
  runApp(const MyApp());
}

class CounterCubit extends SimpleCubit<int> {
  CounterCubit() {
    setSuccess(0);
  }

  void increment() => setSuccess((state.data ?? 0) + 1);
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'BlocSimple Example',
      home: BlocProvider(
        create: (_) => CounterCubit(),
        child: const CounterScreen(),
      ),
    );
  }
}

class CounterScreen extends StatelessWidget {
  const CounterScreen({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Simple Counter')),
      body: Center(
        child: BlocBuilder<CounterCubit, SimpleState<int>>(
          builder: (context, state) {
            if (state.isLoading) return const CircularProgressIndicator();
            if (state.isError) return Text('Error: ${state.errorMessage}');
            return Text(
              '${state.data ?? 0}',
              style: const TextStyle(fontSize: 40),
            );
          },
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: () => context.read<CounterCubit>().increment(),
        child: const Icon(Icons.add),
      ),
    );
  }
}


📜 License
MIT © Dwaipayan Biswas

Built with ❤️ by [Dwaipayan Biswas](https://github.com/dwaipayan7)