mailofly #

Official Dart / Flutter client for the Mailofly REST API.

Source of truth: developed in the mailofly monorepo under packages/dart. This public repo is mirrored automatically on change.

Requirements #

• Dart 3.0 or newer (Flutter compatible).

Install #

dependencies:
  mailofly: ^0.2.0

dart pub add mailofly

Usage #

Create a client with your API key from User → API keys:

import 'package:mailofly/mailofly.dart';

Future<void> main() async {
  final client = Mailofly(apiKey: 'mf_live_…');

  try {
    final identities = await client.identities.list();
    print(identities['data']);

    await client.emails.send(
      from: 'Acme <onboarding@example.com>',
      to: 'you@example.com',
      subject: 'Hello',
      html: '<p>Thanks for signing up.</p>',
    );
  } on MailoflyException catch (e) {
    print('${e.statusCode} ${e.error} ${e.message}');
  } finally {
    client.close();
  }
}

Discovery (no API key) #

final meta = await Mailofly.discovery();
print(meta['resources']);

Resources #

Request/response JSON matches /api/v1.

Docs #

• SDK overview
• Dart guide
• API reference

Releasing #

1. Bump version in pubspec.yaml (and CHANGELOG.md) in the monorepo PR.
2. Merge to main/master → GitHub Action syncs this folder to teamredevs/mailofly-dart.
3. Publish workflow runs and publishes to pub.flutter-io.cn only when the version is new.

License #

MIT