App

​

Example

import 'package:flutter/widgets.dart';
import 'package:neo/neo.dart';
import 'package:hooks_riverpod/hooks_riverpod.dart';

import 'router/neo_router.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  NeoInitializer.initialize().then((_) {
    runApp(
      ProviderScope(
        child: MyApp(),
      ),
    );
  });
}

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

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final neoRouter = ref.watch(routerProvider);

    return NeoApp(
      title: "My Neo App",
      routerConfig: neoRouter.config(),
    );
  }
}

​

Properties

​

Required

​

Theming

​

Config

​

Enums

​

NeoThemeMode

• system: Automatically switches between light and dark themes based on the device’s system setting. Responds to system-level theme changes in real-time.
• light: Always uses the light theme regardless of system settings.
• dark: Always uses the dark theme regardless of system settings.

​

Best Practices

• Riverpod Required: NeoApp requires ProviderScope as an ancestor widget for state management. Wrap your app with ProviderScope in your main() function.
• Seed lightTheme / darkTheme / config on NeoApp so the first frame resolves your intended theme and config without a flash.

​

Integration Notes

• Initialization: NeoApp works with NeoInitializer.initialize() to properly set up the Neo framework before the app starts.
• CupertinoTheme brightness follows the active Neo theme (theme.isDark).