⚡ Quick Links
Learn ARO
Start here if you're new to the language
Getting Started
Build your first ARO application in 5 minutes. Learn the basics of features, feature sets, and contract-first development.
Start tutorial →The FDD Story
Discover the history of Feature-Driven Development—the forgotten methodology that inspired ARO.
Read the story →Tutorial
A hands-on tutorial building a complete ARO application step by step. Learn by doing.
Start tutorial →Core Concepts
Deep dives into ARO's architecture
The Basics
Understand the Action-Result-Object pattern, prepositions, and how ARO statements work.
Learn basics →Feature Sets
How to organize your code into feature sets and manage business capabilities.
Learn feature sets →Actions
The complete guide to ARO actions—Extract, Create, Validate, Store, Return, and more.
Explore actions →Application Lifecycle
Application-Start, Application-End, and how to manage your app's lifecycle.
Learn lifecycle →Packages
Extend ARO with community packages. Install plugins, manage dependencies, and add new capabilities.
Learn packages →Powerful Features
What makes ARO remarkable
Event-Driven Architecture
Simple event dispatch between feature sets. Emit events by name, no subscriptions or complex pub/sub needed.
Learn events →State Transitions
Manage state machines with OpenAPI enums and a simple Accept action. Runtime validates all transitions.
Learn states →Data Pipelines
Filter, transform, and aggregate collections with map/reduce style operations. All results typed via OpenAPI.
Learn pipelines →Native Compilation
Compile ARO to LLVM IR and native binaries. Fast startup, lower memory, single binary deployment.
Learn compilation →Working with Dates
Date and time handling with timezone support, relative offsets, ranges, and recurrence patterns.
Learn dates →Set Operations
Compute intersections, differences, and unions on lists, strings, and objects with polymorphic operations.
Learn set ops →Building APIs
Create powerful HTTP services with ARO
Contract-First Development
How OpenAPI contracts drive your ARO applications. Define your API first, then implement.
Learn contract-first →HTTP Client
Fetch data from external APIs with the Request action. GET, POST, PUT, DELETE and more.
Make HTTP requests →File Operations
Read, write, copy, move, and manage files and directories with cross-platform actions.
Learn file ops →Format-Aware File I/O
Automatic format detection and serialization for JSON, CSV, YAML, XML, TOML, and 8 more formats. Zero boilerplate.
Learn formats →TCP Sockets
Real-time communication with TCP sockets and bidirectional data flow for backend services.
Learn sockets →WebSockets
Real-time bidirectional communication for web apps. Push updates to browsers instantly.
Learn WebSockets →Template Engine
Dynamic HTML generation with variable interpolation, conditionals, loops, and includes.
Learn templates →Terminal UI
Build interactive terminal applications with colors, styling, live updates, and reactive Watch patterns.
Learn Terminal UI →Repositories
In-memory data storage with querying, updates, and change observers for reactive patterns.
Learn repositories →Reference
Detailed specifications and proposals
Language Proposals
29 evolution proposals documenting every aspect of the ARO language design.
Browse proposals →External Services
Integrate with external APIs and libraries using the Call action. Create custom service plugins.
Learn services →Creating Custom Actions
Extend ARO with your own actions. Learn the ActionImplementation protocol and registration.
Create actions →Events Guide
How to use events in ARO applications. Emit, handle, and compose event-driven systems.
Learn events →Writing Extensions
Create your own ARO packages with custom actions and feature sets. Share with the community.
Write extensions →