🎊 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

Growing Ecosystem

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

📚 Resources

• API Documentation - Complete API reference
• Examples - Code examples and demos
• Migration Guide - Upgrade instructions