Skip to main content
Call NeoInitializer.initialize() from main.dart as part of installing Neo. An agent can do the same with /create-neo-project.

Example

What Gets Initialized

NeoInitializer sets up essential Neo framework components and systems required for your app to function properly. The initialization process automatically detects your platform and configures the appropriate features.

Methods

NeoInitializer.initialize()

Required Setup: You must call WidgetsFlutterBinding.ensureInitialized() before calling NeoInitializer.initialize(). This ensures Flutter’s binding is properly initialized before Neo’s systems start up.
Initializes all core Neo framework systems asynchronously. This method must be called before your app starts.

Return Value

Future<void>
A Future that completes when all Neo systems have been successfully initialized. Always await this Future or use .then() before calling runApp().

Best Practices

  • Call NeoInitializer.initialize() in main(), after WidgetsFlutterBinding.ensureInitialized() and before runApp(). Await it.

Behavior

  • Unsupported platform features are skipped.
Last modified on September 30, 2026