App settings

fliin login
fliin add app-settings

// lib/app_settings_route.dart, next to app_settings_page.dart.
import 'package:go_router/go_router.dart';

import 'app_settings_page.dart';

/// Add appSettingsRoute to the routes of your GoRouter.
final appSettingsRoute = GoRoute(
  path: '/settings',
  builder: (context, state) => AppSettingsPage(
    // Alone in the stack (deep link, go): your app's home.
    onBack: () => context.canPop() ? context.pop() : context.go('/'),
  ),
);

// lib/app_settings_route.dart, next to app_settings_page.dart.
import 'package:flutter/material.dart';

import 'app_settings_page.dart';

/// Opens “App settings”: `Navigator.of(context).push(appSettingsRoute())`.
Route<void> appSettingsRoute() => MaterialPageRoute<void>(
  builder: (context) => AppSettingsPage(
    onBack: () => Navigator.of(context).maybePop(),
  ),
);

// lib/app_settings_page.dart
// Your backend: implement AppSettingsService (app_settings_data.dart) and pass it instead of the sample service.
import 'package:your_app/ui/fliin/screens/app_settings/app_settings_data.dart';
import 'package:your_app/ui/fliin/screens/app_settings/app_settings_screen.dart';
import 'package:flutter/widgets.dart';

class AppSettingsPage extends StatelessWidget {
  const AppSettingsPage({
    super.key,
    required this.onBack,
  });

  final VoidCallback onBack;

  @override
  Widget build(BuildContext context) => AppSettingsScreen.standalone(
    service: const SampleAppSettingsService(),
    onBack: onBack,
  );
}

// lib/app_settings_page.dart
// Your backend: implement AppSettingsService (app_settings_data.dart) and pass it instead of the sample service.
import 'package:your_app/ui/fliin/screens/app_settings/app_settings_controller.dart';
import 'package:your_app/ui/fliin/screens/app_settings/app_settings_data.dart';
import 'package:your_app/ui/fliin/screens/app_settings/app_settings_screen.dart';
import 'package:flutter/widgets.dart';
import 'package:provider/provider.dart';

class AppSettingsPage extends StatelessWidget {
  const AppSettingsPage({
    super.key,
    required this.onBack,
  });

  final VoidCallback onBack;

  @override
  Widget build(BuildContext context) => ChangeNotifierProvider(
    create: (_) => AppSettingsController(service: const SampleAppSettingsService())..load(),
    child: Builder(
      builder: (context) => AppSettingsScreen(
        controller: context.read<AppSettingsController>(),
        onBack: onBack,
      ),
    ),
  );
}

// lib/app_settings_page.dart
// Your backend: implement AppSettingsService (app_settings_data.dart) and pass it instead of the sample service.
import 'package:your_app/ui/fliin/screens/app_settings/app_settings_controller.dart';
import 'package:your_app/ui/fliin/screens/app_settings/app_settings_data.dart';
import 'package:your_app/ui/fliin/screens/app_settings/app_settings_screen.dart';
import 'package:flutter/widgets.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';

final appSettingsProvider = Provider.autoDispose<AppSettingsController>((ref) {
  final controller = AppSettingsController(service: const SampleAppSettingsService())..load();
  ref.onDispose(controller.dispose);
  return controller;
});

class AppSettingsPage extends ConsumerWidget {
  const AppSettingsPage({
    super.key,
    required this.onBack,
  });

  final VoidCallback onBack;

  @override
  Widget build(BuildContext context, WidgetRef ref) => AppSettingsScreen(
    controller: ref.watch(appSettingsProvider),
    onBack: onBack,
  );
}

// lib/app_settings_page.dart
// Your backend: implement AppSettingsService (app_settings_data.dart) and pass it instead of the sample service.
import 'package:your_app/ui/fliin/screens/app_settings/app_settings_controller.dart';
import 'package:your_app/ui/fliin/screens/app_settings/app_settings_data.dart';
import 'package:your_app/ui/fliin/screens/app_settings/app_settings_screen.dart';
import 'package:flutter/widgets.dart';
import 'package:flutter_bloc/flutter_bloc.dart';

/// The screen's controller as a bloc, for your BlocListener and BlocBuilder:
/// one emission per controller notification. `version` tells them apart
/// when `state` does not change (mode, filters, text…, read them on
/// `controller`). The screen listens to the controller itself.
class AppSettingsCubit extends Cubit<({AppSettingsState state, int version})> {
  AppSettingsCubit(this.controller) : super((state: controller.state, version: 0)) {
    controller.addListener(_changed);
  }

  final AppSettingsController controller;

  void _changed() => emit((state: controller.state, version: state.version + 1));

  @override
  Future<void> close() {
    controller
      ..removeListener(_changed)
      ..dispose();
    return super.close();
  }
}

class AppSettingsPage extends StatelessWidget {
  const AppSettingsPage({
    super.key,
    required this.onBack,
  });

  final VoidCallback onBack;

  @override
  Widget build(BuildContext context) => BlocProvider(
    create: (_) => AppSettingsCubit(AppSettingsController(service: const SampleAppSettingsService())..load()),
    child: Builder(
      builder: (context) => AppSettingsScreen(
        controller: context.read<AppSettingsCubit>().controller,
        onBack: onBack,
      ),
    ),
  );
}

AppSettingsScreen: class extends StatefulWidget
AppSettingsScreen.new: const new({super.key, required AppSettingsController controller, VoidCallback? onBack, VoidCallback? onAccount, VoidCallback? onTextSize, VoidCallback? onLicenses, VoidCallback? onLegal, List<Widget> sections, bool showHaptics, bool showStorage})
AppSettingsScreen.standalone: const new({super.key, required AppSettingsService service, AppSettingsState? initial, VoidCallback? onBack, VoidCallback? onAccount, VoidCallback? onTextSize, VoidCallback? onLicenses, VoidCallback? onLegal, List<Widget> sections, bool showHaptics, bool showStorage})
AppSettingsScreen.controller: get AppSettingsController?
AppSettingsScreen.service: get AppSettingsService?
AppSettingsScreen.initial: get AppSettingsState?
AppSettingsScreen.onBack: get VoidCallback?
AppSettingsScreen.onAccount: get VoidCallback?
AppSettingsScreen.onTextSize: get VoidCallback?
AppSettingsScreen.onLicenses: get VoidCallback?
AppSettingsScreen.onLegal: get VoidCallback?
AppSettingsScreen.sections: get List<Widget>
AppSettingsScreen.showHaptics: get bool
AppSettingsScreen.showStorage: get bool
AppSettingsScreen.createState: State<AppSettingsScreen>()
AppSettingsState: sealed class permits {AppSettingsFailed, AppSettingsLoading, AppSettingsReady}
AppSettingsState.new: const new()
AppSettingsLoading: final class extends AppSettingsState
AppSettingsLoading.new: const new()
AppSettingsNotice: enum {saveFailed, clearFailed}
AppSettingsNotice.saveFailed: static final AppSettingsNotice
AppSettingsNotice.clearFailed: static final AppSettingsNotice
AppSettingsReady: final class extends AppSettingsState
AppSettingsReady.new: const new(AppSettingsData data, {bool clearing, AppSettingsNotice? notice})
AppSettingsReady.data: get AppSettingsData
AppSettingsReady.clearing: get bool
AppSettingsReady.notice: get AppSettingsNotice?
AppSettingsFailed: final class extends AppSettingsState
AppSettingsFailed.new: const new()
AppSettingsController: class extends ChangeNotifier
AppSettingsController.new: new({required AppSettingsService service, AppSettingsState initial})
AppSettingsController.service: get AppSettingsService
AppSettingsController.state: get AppSettingsState
AppSettingsController.load: Future<void>()
AppSettingsController.setAppearance: Future<bool>(AppAppearance value)
AppSettingsController.setLanguage: Future<bool>(String code)
AppSettingsController.setHaptics: Future<bool>(bool value)
AppSettingsController.clearCache: Future<bool>()
AppSettingsController.dispose: void()
AppAppearance: enum {system, light, dark}
AppAppearance.system: static final AppAppearance
AppAppearance.light: static final AppAppearance
AppAppearance.dark: static final AppAppearance
AppLanguage: final class
AppLanguage.new: const new(String code, String name)
AppLanguage.code: get String
AppLanguage.name: get String
AppSettingsAccount: final class
AppSettingsAccount.new: const new({required String name, required String email, required String initials, ImageProvider? photo})
AppSettingsAccount.name: get String
AppSettingsAccount.email: get String
AppSettingsAccount.initials: get String
AppSettingsAccount.photo: get ImageProvider?
AppSettingsData: final class
AppSettingsData.new: const new({required AppAppearance appearance, required String language, required List<AppLanguage> languages, required bool haptics, required int cacheBytes, required String version, required AppSettingsAccount? account})
AppSettingsData.appearance: get AppAppearance
AppSettingsData.language: get String
AppSettingsData.languages: get List<AppLanguage>
AppSettingsData.haptics: get bool
AppSettingsData.cacheBytes: get int
AppSettingsData.version: get String
AppSettingsData.account: get AppSettingsAccount?
AppSettingsData.languageName: get String
AppSettingsData.copyWith: AppSettingsData({AppAppearance? appearance, String? language, bool? haptics, int? cacheBytes})
AppSettingsService: abstract interface class
AppSettingsService.new: new()
AppSettingsService.load: abstract Future<AppSettingsData>()
AppSettingsService.save: abstract Future<void>(AppSettingsData settings)
AppSettingsService.clearCache: abstract Future<void>()
sampleAppLanguages: const dynamic
sampleAppSettings: const dynamic
SampleAppSettingsService: final class implements AppSettingsService
SampleAppSettingsService.new: const new({AppSettingsData data, Duration latency})
SampleAppSettingsService.data: get AppSettingsData
SampleAppSettingsService.latency: get Duration
SampleAppSettingsService.load: Future<AppSettingsData>()
SampleAppSettingsService.save: Future<void>(AppSettingsData settings)
SampleAppSettingsService.clearCache: Future<void>()
appSettingsL10n: const Map<String, Map<String, String>>
AppSettingsStrings: final class
AppSettingsStrings.new: const new(String language)
AppSettingsStrings.of: factory new(BuildContext context)
AppSettingsStrings.language: get String
AppSettingsStrings.title: get String
AppSettingsStrings.back: get String
AppSettingsStrings.loading: get String
AppSettingsStrings.display: get String
AppSettingsStrings.appearance: get String
AppSettingsStrings.appearanceSystem: get String
AppSettingsStrings.appearanceLight: get String
AppSettingsStrings.appearanceDark: get String
AppSettingsStrings.textSize: get String
AppSettingsStrings.percent: String(String value)
AppSettingsStrings.general: get String
AppSettingsStrings.languageLabel: get String
AppSettingsStrings.haptics: get String
AppSettingsStrings.storage: get String
AppSettingsStrings.clearCache: get String
AppSettingsStrings.cacheEmpty: get String
AppSettingsStrings.clearTitle: get String
AppSettingsStrings.clearMessage: get String
AppSettingsStrings.clearConfirm: get String
AppSettingsStrings.cancel: get String
AppSettingsStrings.about: get String
AppSettingsStrings.version: get String
AppSettingsStrings.licenses: get String
AppSettingsStrings.legal: get String
AppSettingsStrings.close: get String
AppSettingsStrings.errorTitle: get String
AppSettingsStrings.errorMessage: get String
AppSettingsStrings.retry: get String
AppSettingsStrings.appearanceName: String(AppAppearance value)
AppSettingsStrings.cacheSize: String(int bytes)
AppSettingsStrings.saveFailed: get String
AppSettingsStrings.clearFailed: get String
AppSettingsStrings.textSizeDefault: get String
AppSettingsStrings.clear: get String
AppSettingsStrings.cacheUsed: String(int bytes)
AppSettingsStrings.sampleHelp: get String
AppSettingsStrings.sampleHelpCenter: get String
AppSettingsStrings.sampleContact: get String