The FDD Story Get Started Tutorial Docs Motivation Download GitHub

Download ARO

Get the ARO CLI and IDE extensions to start building feature-driven applications.

📦 ARO Command-Line Interface

The ARO CLI lets you run, build, compile, and test ARO applications. Download the pre-built binary for your platform or build from source.

🍺

Install with Homebrew

Recommended for macOS

The easiest way to install ARO on macOS. Homebrew handles updates and dependencies automatically. 

brew tap arolang/aro
brew install aro

Or download a pre-built binary:

🍎

macOS

Native binary for Apple Silicon Macs

Download for macOS aro-macos-arm64.tar.gz
🐧

Linux

64-bit binary for Ubuntu, Debian, and other distributions

Download for Linux aro-linux-amd64.tar.gz
🪟

Windows

Currently searching for contributors

Help develop ARO for Windows

Build from Source

Alternatively, build ARO from source using Swift:

git clone https://github.com/arolang/aro.git
cd aro
swift build -c release
# Binary is at .build/release/aro

Requires Swift 6.3 or later.

📖 Documentation

Learn ARO with our comprehensive documentation series covering philosophy, syntax, patterns, and practical examples.

📓

Essential Primer

A concise introduction to ARO for developers who want to get up to speed quickly

Download PDF ARO-Essential-Primer.pdf
📘

The Language Guide

Comprehensive guide to ARO: from mental model to native compilation

Download PDF ARO-Language-Guide.pdf
🐞

The Debugging Guide

Step, inspect, replay: a chapter-by-chapter walkthrough of aro debug

Download PDF ARO-Debugging-Guide.pdf
📗

ARO By Example

Learn by doing: practical examples and hands-on tutorials

Download PDF ARO-By-Example.pdf
📙

Construction Studies

Deep dives into ARO internals and advanced implementation patterns

Download PDF ARO-Construction-Studies.pdf
🧩

The Plugin Guide

Build plugins in Swift, Rust, C, and Python to extend ARO

Download PDF ARO-Plugin-Guide.pdf
📓

The Essential Primer

A concise introduction to ARO: business logic as language

Download PDF ARO-Essential-Primer.pdf
🤖

ARO by Hallucination

The story of how ARO was built with an LLM, and how to use aro lm and aro ask day-to-day

Download PDF ARO-by-Hallucination.pdf
📊

ARO for Data Engineers

Medallion pipelines, format-aware I/O and aggregation, end to end

Download PDF ARO-For-Data-Engineers.pdf
🖥

Solaro — The ARO Platform

The full tour of the IDE: canvas, debugger, notebooks, metrics and Ask

Download PDF ARO-Solaro-Platform.pdf

🖥 Solaro — the ARO IDE

Solaro draws your feature sets as a live canvas and lights each statement up as the runtime fires it, with the value it bound printed underneath. It ships with the ARO release for Apple Silicon Macs, signed and notarized. Take the tour →

🍎

Solaro for macOS

Disk image for Apple Silicon. Needs the matching aro CLI on your path.

Download DMG solaro-macos-arm64.dmg

📝 IDE Extensions

Enhance your ARO development experience with syntax highlighting and code snippets.

💻

Visual Studio Code

Full syntax highlighting and smart snippets for VS Code.

  • Syntax highlighting for all ARO elements
  • 40+ code snippets for common patterns
  • Bracket matching and auto-closing
  • Code folding for feature sets
Install from GitHub →
🧠

IntelliJ IDEA

TextMate-based highlighting with live templates for JetBrains IDEs.

  • Syntax highlighting via TextMate
  • Live templates for quick coding
  • Works with all JetBrains IDEs
  • File type association
Install from JetBrains Marketplace →

Manual Installation: Extensions are also available in the Editor directory of the GitHub repository.

🚀 Quick Start

After installing, verify your installation and run your first ARO application:

# Check version
aro --version

# Run an example
aro run ./Examples/HelloWorld

# Run tests
aro test ./Examples/Calculator

# Compile to native binary
aro build ./Examples/HelloWorld

Ready to learn more? Check out the Getting Started Guide or dive into the Tutorial.