Developers — Almadar

How It Works

Every Almadar application is composed of Orbital Units. An Entity holds your data, Traits define behavior as state machines, and Pages bind them to routes. Watch the architecture assemble itself.

Orbital Unit = Entity + Traits + Pages

Core Concepts

Three building blocks compose every Almadar application

EntityData shape

Entities define your data model. Fields are typed, can have defaults, and support three persistence modes: runtime (in-memory), persistent (database), and singleton.

{
  "name": "Task",
  "persistence": "runtime",
  "fields": [
    { "name": "title", "type": "string" },
    { "name": "done",  "type": "boolean", "default": false }
  ]
}

TraitState machine + UI

Traits model behavior as state machines with states, events, guards, and effects. Effects can set entity fields, emit events, call services, or render UI patterns.

PageRoute binding

Pages bind Orbitals to routes. They define the URL, the layout, and which Orbitals (groups of Entity + Traits) are mounted. Pages are generated as React route components.

First Schema in 60 Seconds

Install the CLI, create your first schema, and compile it to a running application.

npx @almadar/cli new my-app

1Install the CLI

2Edit your .orb schema

3Run almadar dev my-app.orb to watch and compile

Full Getting Started Guide

hello-world.orb

{
  "name": "HelloWorld",
  "orbitals": [{
    "name": "Greeter",
    "entity": {
      "name": "Greeting",
      "fields": [
        { "name": "message", "type": "string" },
        { "name": "count", "type": "number", "default": 0 }
      ]
    },
    "traits": [{
      "name": "Clickable",
      "stateMachine": {
        "states": [
          { "name": "idle", "isInitial": true },
          { "name": "greeted" }
        ],
        "transitions": [{
          "from": "idle",
          "event": "CLICK",
          "to": "greeted",
          "effects": [
            ["set", "@entity.message", "Hello, World!"],
            ["set", "@entity.count", ["+", "@entity.count", 1]],
            ["render-ui", "main", {
              "type": "stats-card",
              "title": "@entity.message",
              "value": "@entity.count"
            }]
          ]
        }]
      }
    }]
  }]
}

Standard Library Modules

213+ built-in operators across 9 modules — all available as s-expressions in guards and effects

🔢Math16 operatorsNumeric operations for calculations, rounding, clamping, and randomization.📝String27 operatorsText manipulation including formatting, splitting, trimming, and templating.📋Array39 operatorsWork with lists and arrays including filtering, mapping, and aggregation.🔑Object19 operatorsAccess and manipulate object properties safely.⏰Time25 operatorsWork with dates, times, durations, and timestamps.✅Validate23 operatorsValidate user input with common patterns like email, required, length checks.🎨Format9 operatorsDisplay formatting for currency, numbers, dates, and file sizes.⏳Async9 operatorsControl timing with delays, debouncing, retries, and timeouts.🧠Neural Network14 operatorsDefine and compose neural network layers and modules.📊Tensor29 operatorsCreate and manipulate multi-dimensional arrays for numerical computing.🎯Training19 operatorsTraining loops, loss functions, and optimization for neural networks.🎲Probabilistic16 operatorsDistribution sampling, Bayesian inference via rejection sampling, and statistical summaries.🎲Prob16 operatorsDistribution sampling (Gaussian, Beta, Poisson), Bayesian inference via rejection sampling, and statistical summaries.

View full operator reference →

render-ui

Live Component Preview

render-ui turns an s-expression into a real component — no JSX, no template files. Edit the expression and watch the preview update automatically.

Try It in the Browser

Run Almadar s-expressions live — no installation needed

Loading playground...

Tutorial Tracks

Structured paths from zero to production

Beginner

Build your first Orbital Unit, understand state machines, and deploy a working application.

Your first Orbital
Task Manager from Scratch

Start Track →

Intermediate

Work with UI patterns, write guards with s-expressions, and connect multiple Orbitals.

UI Patterns in Depth
Guard Expressions
Cross-Orbital Events

Start Track →

Advanced

Build production apps with integrations, AI generation, and custom skills.

Full Production App
AI Schema Generation

Start Track →