flutter_mockkit library

flutter_mockkit — A lightweight dev toolkit for mocking API requests and responses during Flutter development.

Quick Start

import 'package:flutter_mockkit/flutter_mockkit.dart';

void main() {
  // Register a mock
  MockKit.register(
    MockRoute(
      method: HttpMethod.get,
      path: '/users',
      response: MockResponse(body: {'users': []}),
    ),
  );

  // Enable mock mode
  MockKit.enable();

  runApp(MyApp());
}

Classes

MockDataGenerator
A utility class for auto-generating realistic mock payloads.
MockDioInterceptor
A Dio interceptor that short-circuits HTTP requests and returns registered MockResponses when MockKit is enabled.
MockHttpClient
A drop-in replacement for http.Client that intercepts outgoing requests and returns registered MockResponses when MockKit is enabled.
MockKit
The central façade for flutter_mockkit.
MockRequest
Snapshot of an intercepted HTTP request, passed to dynamic-response handlers so they can inspect path, query params, and body before deciding what MockResponse to return.
MockResponse
Represents a simulated HTTP response returned by a registered mock route.
MockRoute
A registered mock route that pairs an HTTP method + path pattern with either a static MockResponse or a dynamic response builder function.

Enums

HttpMethod
Supported HTTP methods for mock route registration.

Extensions

HttpMethodExtension on HttpMethod
Extension to convert HttpMethod to its string representation.

Exceptions / Errors

MockNetworkException
Thrown when a registered mock route has MockResponse.shouldFail set to true, simulating a hard network failure (e.g. no internet connection).