Why Luna?

Luna is not just another JavaScript framework. It's a fundamentally different approach to building web UIs, born from frustration with existing solutions.

The Problem with Existing Frameworks

• React - Too large. The runtime overhead is unacceptable for performance-critical applications.

• Qwik / Solid - Compile-time expansion gets in the way. The magic makes debugging harder.

• No WebComponents-first framework - Existing frameworks treat Web Components as second-class citizens.

Luna addresses these gaps directly.

Design Philosophy

So Small That Compile-Time Optimization Is Unnecessary

Luna is intentionally minimal. When your framework is this small, you don't need sophisticated compile-time optimizations to achieve good performance. The overhead is already negligible.

WebComponents First (World's First SSR + Hydration)

Luna is the first framework to support WebComponents SSR + Hydration.

• Native browser standards over framework abstractions

• Shadow DOM for style encapsulation

• Declarative Shadow DOM for server rendering

• Islands that work with any framework

Runtime Performance That Matters

Fine-grained reactivity without Virtual DOM diffing delivers 5x better performance in real-world scenarios.

Written in MoonBit

Luna is written in MoonBit - a language designed for cloud and edge computing.

Fine-Grained Reactivity

Unlike Virtual DOM frameworks, Luna updates only what changed - at the DOM node level.

Virtual DOM: State → Create Tree → Diff → Patch (O(n))
Luna:        Signal → Direct DOM Update (O(1))

Islands + Fine-Grained

Luna combines Islands Architecture with fine-grained reactivity:

• Partial hydration - Only interactive parts load JavaScript

• Minimal runtime - ~3KB loader

• Fast updates - Direct DOM manipulation within islands

Architecture

┌─────────────────────────────────────────────────────────────┐
│                     Your Application                         │
├─────────────────────────────────────────────────────────────┤
│  Sol SSG (SSG)          │  Sol (SSR Framework)                 │
│  Static docs sites    │  Full-stack apps with islands        │
├─────────────────────────────────────────────────────────────┤
│                       Luna (Core)                            │
│           Signals, Islands, Hydration, Components            │
├─────────────────────────────────────────────────────────────┤
│                      MoonBit / JavaScript                    │
└─────────────────────────────────────────────────────────────┘