linkloom

Connectivity-aware HTTP client for Flutter that never silently drops a request, plus a zero-config offline/online banner — in one package.

Most apps need two separate packages (connectivity_plus + some retry logic you hand-roll) to handle this correctly. linkloom combines both:

• 📡 Auto offline queue — requests made while offline (or that fail) are persisted to disk and retried automatically with exponential backoff as soon as the connection returns — survives app restarts.
• 🎨 Zero-config UI banner — wrap your app once, get an animated "You're offline" / "Back online" banner with no manual StreamBuilder.
• 🧩 Drop-in replacement for basic http GET/POST/PUT/PATCH/DELETE calls.

Built with courier/delivery and field-work apps in mind — where drivers lose signal mid-route and you can't afford to lose an order update.

Install

dependencies:
  linkloom: ^0.1.0

Usage

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await NetPulse.init(); // one-time setup, call before runApp
  runApp(const MyApp());
}

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: NetPulseBanner(       // <- automatic offline banner
        child: const HomePage(),
      ),
    );
  }
}

Making a request:

final client = NetPulseClient();

final result = await client.post(
  'https://example.com/api/orders',
  headers: {'Content-Type': 'application/json'},
  body: '{"orderId": 123}',
);

if (result.queued) {
  // Device was offline (or the request failed) — it's safely
  // queued on disk and will retry automatically.
  print('Queued. Pending: ${NetPulse.pendingCount}');
} else if (result.isSuccess) {
  print('Sent! ${result.statusCode}');
} else {
  print('Failed: ${result.error}');
}

API overview

Customizing the banner

NetPulseBanner(
  offlineMessage: "No internet connection",
  backOnlineMessage: "Connected",
  offlineColor: Colors.red,
  backOnlineColor: Colors.green,
  child: const HomePage(),
)

Contributing

Issues and PRs welcome — see CONTRIBUTING.md.

License

MIT — see LICENSE.