---
title: "BUILD — Bloom Framework Architecture"
description: "Opinionated application framework for Dart & Flutter featuring Signals, Filesystem Routing, DI, and Continuous Prebuild."
category: "Framework Architecture"
url: "https://bloom-platform-ten.vercel.app/build"
last_updated: "2026-08-15"
---

# Bloom Framework Architecture (BUILD)

> The opinionated application framework bringing deterministic structure, high-speed reactivity, and zero-boilerplate developer experience to Flutter.

---

## 🛠️ Core Framework Subsystems

### 1. Signals State Management
Fine-grained reactivity based on modern signal graphs. When a signal changes, only the widgets observing that exact signal re-render:

```dart
import 'package:bloom_framework/bloom.dart';

class CounterController extends BloomController {
  late final count = createSignal<int>(0, debugLabel: 'counter.count');
  late final isEven = createComputed(() => count.value % 2 == 0);

  void increment() => count.value++;
}
```

### 2. Filesystem Routing
Create files in `lib/routes/` and Bloom automatically compiles them into typed `GoRouter` routes:
- `lib/routes/index.dart` ➔ `/`
- `lib/routes/users/[id].dart` ➔ `/users/:id`
- `lib/routes/(auth)/login.dart` ➔ `/login`
- `lib/routes/_layout.dart` ➔ Shell wrapper

### 3. Hierarchical Dependency Injection
```dart
// Register during onBoot
container.provideSingleton<AuthService>((c) => AuthService());

// Resolve in widgets or controllers
final auth = inject<AuthService>();
```

### 4. Continuous Native Prebuild Engine
Define app metadata in `bloom.yaml`:
```yaml
name: my_app
version: 1.0.0
native:
  ios:
    bundle_id: com.company.myapp
    permissions:
      - camera
      - location_when_in_use
  android:
    package_name: com.company.myapp
```
Run `bloom prebuild` to update `ios/` and `android/` native source code automatically.

---

## 🔗 Related Documentation
- [Quickstart Tutorial](https://bloom-platform-ten.vercel.app/docs/framework/quickstart.md)
- [Boot Lifecycle](https://bloom-platform-ten.vercel.app/docs/runtime/boot-lifecycle.md)
- [Filesystem Routing Guide](https://bloom-platform-ten.vercel.app/docs/runtime/filesystem-routing.md)
- [Data Queries & Cache](https://bloom-platform-ten.vercel.app/docs/data/queries.md)