# 🌌 Argis (RGS) - Reactive Global State: The Final Guide

Welcome to the definitive documentation for **Reactive Global State (RGS)**. If you are here, you're likely tired of endless boilerplate, complex configurations, and state management tools that seem to require a PhD in rocket science.

This documentation is written for everyone: from **easy setup** for those who just want things to work, to **advanced implementation** for those who want to master the engine.

---

## 🗺️ Summary

- **[Introduction](guide/introduction.md)**
  - Reliability and Security as First-Class Citizens.
  - The "Ironclad" Core: Simplicity meets Power.

- **[Installation](guide/installation.md)**
  - Prerequisites and setup instructions.

- **[Quick Start: 30-Second Setup](guide/quick-start.md)**
  - Deploying the RGS Panzer in your React project.

- **[The Magnetar Way: One-Liner Power](guide/the-magnetar-way.md)**
  - Creating stores and hooks simultaneously. Types included.

- **[Core Concepts](guide/core-concepts.md)**
  - Store initialization, reactive state, and namespaces.

- **[API Reference](guide/api-reference.md)**
  - Complete hooks and store functions reference.

- **[Advanced Usage](guide/advanced-usage.md)**
  - Never lose user data again (without localStorage headaches).
  - Native immutability with Immer (Stellar Engine).
  - Transactions, plugins, and persistence.

- **[Local-First Sync Engine](guide/local-first-sync.md)**
  - Offline-by-default with automatic background sync.
  - Conflict resolution strategies (last-write-wins, merge, etc.).
  - IndexedDB and Cloud Sync plugins.

- **[Ecosystem and Plugins](guide/plugins-and-extensibility.md)**
  - DevTools, Cross-Tab Sync, Analytics, and Typed Plugins.

- **[Plugin SDK: Build Your Own Extensions](guide/plugin-sdk.md)**
  - Create custom plugins with lifecycle hooks.
  - Register methods via `store.plugins`.
  - Full API reference and examples.

- **[Security Features](guide/security-features.md)**
  - Advanced XSS prevention and deep cloning reliability.
  - AES-256-GCM, RBAC, Audit Logging, and GDPR.

- **[Case Studies: Real World Strategies](guide/case-studies.md)**
  - **E-commerce**: Cart isolation and atomic updates.
  - **Dashboards**: Multi-store strategies and complex flows.

- **[Architectural Insights (FAQ)](guide/faq.md)**
  - Honest answers on security, performance, and Proxies.

- **[Testing](guide/testing.md)**
  - Unit, integration, and stress testing strategies.

- **[Performance](guide/performance.md)**
  - Optimization tips and benchmarks.

- **[Best Practices](guide/best-practices.md)**
  - Code organization and development guidelines.

- **[Migration Guide](guide/migration-guide.md)**
  - Upgrading from Redux, Context API, and useState.

- **[Troubleshooting](guide/troubleshooting.md)**
  - Common issues and solutions.

---

> *"Make things simple, but not simpler than necessary."* – RGS Team