Bloom class

The core Bloom framework controller and global entrypoint.

Manages application bootstrapping, runtime configuration, dependency injection, feature flags, observability/crash telemetry, and test lifecycle resetting.

Example:

void main() async {
  await Bloom.boot(
    bootstrapper: const AppBootstrapper(),
  );
}

Constructors

Bloom()

Properties

hashCode → int

The hash code for this object.

no setter, inherited

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

Methods

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

toString() → String

A string representation of this object.

inherited

Operators

operator ==(Object other) → bool

The equality operator.

inherited

Static Properties

activeFlavor → String?

Currently active build flavor (e.g. 'development', 'staging', 'production'), if specified.

no setter

config → BloomConfig

Active configuration instance loaded during boot.

no setter

container → BloomContainer

Global dependency injection container.

no setter

features → BloomFeatureFlags

Dynamic feature flags management service.

no setter

isBooted → bool

Whether Bloom has completed its boot sequence.

no setter

Static Methods

addBreadcrumb({required String category, required String message, BloomBreadcrumbLevel level = BloomBreadcrumbLevel.info, Map<String, dynamic>? data}) → void

Records a chronological breadcrumb in the observability buffer.

boot({String? flavor, BloomBootstrapper? bootstrapper, String? envContent, String? configYaml, BloomObservabilityConfig? observability, BloomEnvironmentSchema? environmentSchema}) → Future<void>

Main boot pipeline for Bloom applications.

captureException(dynamic exception, {dynamic stackTrace, Map<String, dynamic>? context, List<String>? fingerprint, String? exceptionType, BloomErrorLevel level = BloomErrorLevel.error}) → Future<BloomTelemetryEvent?>

Manually captures an exception with structured context and stack trace.

captureMessage(String message, {BloomErrorLevel level = BloomErrorLevel.info, Map<String, dynamic>? context, List<String>? fingerprint}) → Future<BloomTelemetryEvent?>

Manually captures a message telemetry event.

createTestScope({List<BloomTestOverride>? overrides}) → BloomTestScope

Create an isolated test scope for unit and widget testing with optional dependency overrides.

reset() → Future<void>

Reset Bloom runtime state to a pristine baseline (useful between tests).