Yoga.Net 3.2.1

Yoga.Net

A high-performance C# port of Meta's Yoga layout engine — implements Flexbox and CSS Grid layout for .NET.

Yoga enables building UI layouts using Flexbox and CSS Grid on platforms that don't natively support them, including .NET desktop, mobile, and server applications.

Features

• 1:1 C++ port — faithful translation of the original C++ Yoga engine (v3.2)
• Flexbox & CSS Grid — complete Flexbox algorithm and CSS Grid layout support
• High performance — zero reflection, zero LINQ, Span<T> optimizations, AggressiveInlining on hot paths, struct value types for reduced allocations
• AOT/NativeAOT compatible — fully trimming-safe, no runtime code generation
• Multi-target — supports net8.0, net9.0, net10.0
• 864 tests — comprehensive test suite mirroring the original C++ gtest tests 1:1
• Measure callbacks for integrating with text measurement
• Caching for layout performance
• Deterministic layout (no undefined behavior from rounding)

Installation

dotnet add package Yoga.Net

Quick Start

using Facebook.Yoga;
using static Facebook.Yoga.YGNodeAPI;
using static Facebook.Yoga.YGNodeStyleAPI;
using static Facebook.Yoga.YGNodeLayoutAPI;

// Create nodes
var root = YGNodeNew();
var child0 = YGNodeNew();
var child1 = YGNodeNew();

// Build tree
YGNodeInsertChild(root, child0, 0);
YGNodeInsertChild(root, child1, 1);

// Set styles
YGNodeStyleSetWidth(root, 300);
YGNodeStyleSetHeight(root, 200);
YGNodeStyleSetFlexDirection(root, YGFlexDirection.Row);

YGNodeStyleSetFlexGrow(child0, 1);
YGNodeStyleSetFlexGrow(child1, 2);

// Calculate layout
YGNodeCalculateLayout(root, float.NaN, float.NaN, YGDirection.LTR);

// Read results
Console.WriteLine($"Root:   {YGNodeLayoutGetWidth(root)} x {YGNodeLayoutGetHeight(root)}");
Console.WriteLine($"Child0: {YGNodeLayoutGetWidth(child0)} x {YGNodeLayoutGetHeight(child0)} @ ({YGNodeLayoutGetLeft(child0)}, {YGNodeLayoutGetTop(child0)})");
Console.WriteLine($"Child1: {YGNodeLayoutGetWidth(child1)} x {YGNodeLayoutGetHeight(child1)} @ ({YGNodeLayoutGetLeft(child1)}, {YGNodeLayoutGetTop(child1)})");

// Clean up
YGNodeFreeRecursive(root);

Output:

Root:   300 x 200
Child0: 100 x 200 @ (0, 0)
Child1: 200 x 200 @ (100, 0)

Building from Source

# Build
dotnet build

# Run tests (xunit.v3 standalone runner)
dotnet run --project tests/Yoga.Net.Tests/Yoga.Net.Tests.csproj

# Pack NuGet
dotnet pack --configuration Release

Project Structure

The project mirrors the original C++ source layout:

Yoga.Net/
├── src/Yoga.Net/              # Main library (namespace: Facebook.Yoga)
│   ├── algorithm/             # Core layout algorithms (FlexLine, CalculateLayout, PixelGrid...)
│   ├── config/                # Configuration (Config, ExperimentalFeature)
│   ├── debug/                 # Debug/assertion utilities
│   ├── enums/                 # Flexbox & Grid enumerations
│   ├── event/                 # Event system
│   ├── node/                  # Node implementation (Node, LayoutResults, CachedMeasurement)
│   ├── numeric/               # Numeric utilities (FloatOptional, Comparison)
│   ├── style/                 # Style properties (Style, StyleLength, StyleSizeLength)
│   ├── YGNode.cs              # Public C-style Node API
│   ├── YGNodeStyle.cs         # Public C-style Style API
│   ├── YGNodeLayout.cs        # Public C-style Layout API
│   ├── YGConfig.cs            # Public C-style Config API
│   └── YGEnums.cs             # Public YG-prefixed enums
└── tests/Yoga.Net.Tests/      # xUnit v3 tests (1:1 with C++ gtest)

Performance Optimizations

Compared to a naive C# port, Yoga.Net includes the following optimizations:

API Style

The library exposes two layers:

1. C-style API (YGNodeAPI, YGNodeStyleAPI, YGNodeLayoutAPI) — mirrors the original C/C++ Yoga API for 1:1 test compatibility
2. Internal C# types (Node, Config, Style) — use idiomatic C# naming (PascalCase properties, methods, enums)

Acknowledgments

This is a C# port of facebook/yoga by Meta Platforms, Inc.

License

MIT