Flutter

dependencies:
  flutter:
    sdk: flutter
  siyak_flutter:
    path: ../vendor/siyak_flutter    # the folder from the downloaded archive

# pub.dev hosting is announced later; until then the archive is the install path.

import 'package:siyak_flutter/siyak_flutter.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();

  final siyak = Siyak.init(
    apiKey: const String.fromEnvironment('SIYAK_API_KEY'),
    endpoint: const String.fromEnvironment('SIYAK_ENDPOINT'),
    target: 'ar-EG',
    source: 'en',
    context: 'home screen',
    onLog: debugPrint,
  );

  unawaited(siyak.preload());   // one request, every approved string
  runApp(MyApp(siyak: siyak));
}

class _HomeState extends State<Home> {
  final siyak = Siyak.shared;

  @override
  void initState() {
    super.initState();
    siyak.translationRevision.addListener(_repaint);
  }

  void _repaint() => setState(() {});

  @override
  void dispose() {
    siyak.translationRevision.removeListener(_repaint);
    super.dispose();
  }

  @override
  Widget build(BuildContext context) => Text(siyak.t('Settings'));
}

if (siyak.isRightToLeft) {            // ar, fa, he, ur, ckb, … (region-insensitive)
  // Flip the whole app, not one Text.
  return Directionality(textDirection: TextDirection.rtl, child: ...);
}

flutter run --dart-define=SIYAK_ENDPOINT=http://10.0.2.2:8787 \
            --dart-define=SIYAK_API_KEY=sk_test_…
// and pass allowInsecureEndpoint: true to Siyak.init — it refuses plain http
// by default, because a release build pointing at http:// is almost always a bug.