jala 0.6.0

In-app Flutter network inspector with replay, filter grammar, redaction, throttling, session share, call diff, and cURL/HAR import. Facade over jala_core + jala_ui.

jala

Facade package for Jala, the in-app Flutter network inspector — Jala.initialize() plus JalaOverlay wire up capture, storage, and the inspector UI in two lines.

See the repo README for the full pitch (replay, filter grammar, redaction-by-default, throttling, session share, call diff, import), the comparison vs. alice/chucker_flutter/talker, and the roadmap.

Existing app? Prefer the brownfield guide: docs/ADOPTION.md (multi-Dio, GraphQL double-capture, Alice/Chucker migration, debug bootstrap, PR checklist).

Requirements: Dart ^3.11, Flutter >=3.35. Use lockstep versions with adapters (jala / jala_dio / … all ^0.6.0). Compatibility notes: docs/COMPAT.md.

Quick start

dependencies:
  jala: ^0.6.0
  jala_dio: ^0.6.0   # if you use Dio
  dio: ^5.0.0

import 'package:dio/dio.dart';
import 'package:flutter/material.dart';
import 'package:jala/jala.dart';
import 'package:jala_dio/jala_dio.dart';

void main() {
  Jala.initialize(); // enabled: kDebugMode by default
  final dio = Dio();
  JalaDio.attach(dio);
  runApp(JalaOverlay(child: MyApp(dio: dio)));
}

Tap the floating J bubble (or call Jala.open()) to inspect traffic. enabled defaults to kDebugMode, and JalaOverlay returns child unchanged when disabled — see Production safety below and the repo README.

Other adapters

Client	Package	Setup
package:http	jala_http ^0.6.0	JalaHttp.wrap(http.Client())
GraphQL (gql_link)	jala_graphql ^0.6.0	JalaGraphQLLink(endpoint: uri) before terminating link
WebSocket	jala_websocket ^0.6.0	JalaWebSocketChannel.wrap(channel, uri: uri)

Inspector power tools (v0.5+)

• Throttle (AppBar speed icon): Slow 3G / Fast 3G / Flaky / Offline + custom profiles and host glob.
• Session share (AppBar overflow): export/import a versioned JSON session via clipboard (JalaSessionCodec under the hood).
• Subscriptions: GraphQL payload timeline on the Response tab; filter with is:subscription.

Inspect deeper (v0.6)

• Compare with… on call detail (or pick two calls) → structural status / header / JSON body diff.
• Import cURL… / Import HAR… in the inspector overflow (cURL opens the request composer; HAR loads as an imported session).
• Virtualized JSON tree — large expanded payloads no longer jank.

Production safety

• Off by default in release — Jala.initialize() uses enabled: kDebugMode unless you override it.
• True no-op when disabled — overlay returns child unchanged; adapters skip capture on the hot path.
• Redaction at capture time — default sensitive headers and common JSON/form secret keys (password, access_token, …) are masked before the store; extend JalaRedactor for company-specific names.
• Hard body size caps — default 512 KB per captured body.
• Session export modes — full / no bodies / headers only; import size limited. Treat exports like log dumps.

Leave the dependency wired in release builds; that is intentional and safe. Details: docs/SECURITY.md.

See also

• docs/SECURITY.md — threat model & redaction
• docs/ADOPTION.md — existing apps
• docs/COMPAT.md — 0.x / lockstep policy
• docs/SPEC-v0.1.md — original v0.1 contract