README.md

@beyond-js/reactive

The Data Intelligence Layer for Modern Applications. 🚀

@beyond-js/reactive is a powerful TypeScript library that centralizes business logic, validation, and reactivity within your data structures. It provides a dedicated layer that handles the "truth" of your application, leaving UI frameworks to focus purely on presentation.

---

✨ Key Benefits

• 🎯 Data-First Design: Business logic belongs to your data, not your UI components.
• 🤖 AI-Ready: Highly structured models that AI agents (Cursor, Copilot) can reason about with zero effort.
• 🔌 Framework Agnostic: Works perfectly with React, Vue, Svelte, or Node.js.
• 🤝 Complements UI State Managers: Co-exists seamlessly with Zustand, Redux, or Pinia.
• ✅ Zod Integration: Native validation for robust data integrity.

---

📚 Documentation

• English Documentation
• Documentación en Español

Quick Navigation (EN)

• Philosophy & Vision | Getting Started
• Integration with React & Zustand
• ReactiveModel | Items | Collections
• ReactiveMap | ReactiveArray | ReactiveTree

---

🚀 Quick Start

npm install @beyond-js/reactive zod

import { ReactiveModel } from '@beyond-js/reactive/model';

class User extends ReactiveModel<IUser> {
  declare name: string;
  constructor(data) {
    super({ properties: ['name'], ...data });
  }
}

const user = new User({ name: 'John' });
user.on('change', () => updateUI());
user.name = 'Jane'; // Triggers reactivity

---

📄 License

MIT © @beyond-js