Skip to main content

Architecture

This section covers the architectural patterns, design principles, and technical implementation details of the Nuraly platform.

Overview​

Nuraly is built on a modern, scalable architecture that emphasizes:

  • Modularity - Independent, composable micro-apps
  • Isolation - Sandboxed execution environments
  • Reactivity - Efficient state management and updates
  • Flexibility - Extensible component system

Core Concepts​

Micro-Apps​

Micro-apps are self-contained, isolated applications that can be embedded and run independently. Each micro-app has:

  • Its own component tree
  • Isolated runtime context
  • Independent state management
  • Sandboxed handler execution

Variable Scopes​

The Variable Scope System provides two-tier state management:

  • LOCAL - Isolated per micro-app instance
  • GLOBAL - Shared across all instances

Component System​

Components are the building blocks of Nuraly applications, featuring:

  • Reactive properties
  • Event handling
  • Custom styling
  • Dynamic rendering

Architecture Sections​

🎯 Micro-Apps

Learn about the micro-app architecture, including variable scopes, component isolation, and runtime contexts.

Variable Scopes

Components

Explore the component system, custom components, and how to build interactive UI elements with input handlers and events.

Component Reference

⚡ Runtime System

Understand handler execution, event dispatching, and the reactive runtime environment.

Coming Soon

🔒 Security

Learn about sandboxing, code validation, and security best practices in Nuraly applications.

Coming Soon

Key Features​

🎨 Component-Based​

Build applications from reusable, composable components with reactive properties and event handling.

🔄 State Management​

Flexible two-tier variable scoping system allowing both isolated and shared state across micro-apps.

🛡️ Sandboxed Execution​

Handler code runs in isolated contexts with controlled access to runtime APIs for enhanced security.

⚡ Performance​

Efficient reactivity system with smart caching, event batching, and optimized component updates.

🔌 Extensible​

Plugin-based architecture supporting custom components, handlers, and runtime extensions.

Getting Started​

  1. Understand Variable Scopes - Start with the Variable Scope System to learn how state management works
  2. Explore Components - Learn about the component system and how to build UI elements
  3. Study Runtime - Deep dive into handler execution and the runtime environment
  4. Apply Security - Implement best practices for secure application development

Architecture Principles​

Isolation​

Each micro-app instance maintains complete isolation from others, preventing unintended side effects and enabling independent development.

Composability​

Components and micro-apps can be freely composed and nested to build complex applications from simple building blocks.

Reactivity​

Changes to variables and properties automatically trigger updates throughout the component tree with minimal manual intervention.

Developer Experience​

Clear APIs, comprehensive documentation, and helpful error messages make building with Nuraly straightforward and productive.

Next Steps​