README.md

February 5, 2026 · View on GitHub


Alien Signals on pub.dev testing status Ask DeepWiki

🎊 Get Started Today!

// Your reactive journey starts here
import 'package:alien_signals/alien_signals.dart';

final welcome = signal('🎉 Welcome to Alien Signals!');
effect(() => print(welcome()));

🌟 What is Alien Signals?

Alien Signals is a reactive core for Dart built around a generic ReactiveSystem. It includes a high-performance signals preset and a small, ergonomic surface API. Inspired by StackBlitz's alien-signals, the Dart implementation provides:

  • 🪶 Ultra Lightweight: Minimal overhead, maximum efficiency
  • 🎯 Simple API: Intuitive signal(), computed(), and effect() functions
  • 🔧 Production Ready: Battle-tested through comprehensive beta releases

🧭 Core Layers

  • System: A reusable reactive graph and propagation engine (system).
  • Preset: A complete signals implementation on top of the system (preset).
  • Surface API: Convenience signal/computed/effect wrappers built on the preset.

🚀 Key Features

Core Reactive Primitives

import 'package:alien_signals/alien_signals.dart';

void main() {
  // Create reactive state
  final count = signal(0);

  // Create derived state
  final doubled = computed((_) => count() * 2);

  // Create side effects
  effect(() {
    print('Count: ${count()}, Doubled: ${doubled()}');
  });

  // Update state - triggers all dependencies
  count.set(1); // Output: Count: 1, Doubled: 2
}

Advanced Features

  • Effect Scopes: Group and manage effects together
  • Batch Operations: Control when reactivity updates occur
  • Flexible API: Build your own surface APIs on top of the core system or use the preset implementation

📦 Installation

To install Alien Signals, add the following to your pubspec.yaml:

dependencies:
  alien_signals: ^2.1.1

Alternatively, you can run the following command:

dart pub add alien_signals

📖 Documentation

  • Guide: Layers (system/preset/surface) and core concepts. See docs/guide.md.
  • API Reference: System, preset, and surface APIs. See docs/api.md.
  • Recipes: Practical patterns and pitfalls. See docs/recipes.md.

🌍 Community & Ecosystem

Adoptions

  • Solidart - Signals for Flutter inspired by SolidJS
  • Oref - Magical reactive state management for Flutter
  • flutter_compositions - Vue-inspired reactive building blocks for Flutter
  • ZenBus - A high-performance, flexible event bus for Flutter applications

Growing Ecosystem

Join our thriving community of developers building reactive applications with Alien Signals!

📚 Resources