Almadar
The Physics of Software: Declare your application, compile to production
Welcome to the Almadar programming language documentation. Almadar is a declarative approach to building full-stack applications through state machines, entities, and traits.
Quick Navigation
Getting Started
- Introduction - What is Almadar and why should you use it?
- Installation - Get the Almadar CLI on your system
- Your First Schema - Build a task manager in 10 minutes
- Core Concepts - Entities, traits, and state machines
Language Reference
- Specification - Complete language specification
- Entities - Data structures and persistence
- Traits - Behavior as state machines
- S-Expressions - Guards and effects syntax
- Effects - Server and client effects
- Patterns - UI pattern library
Guides
Technical
Business
Tutorials
Beginner
Intermediate
Advanced
Reference
The Almadar Philosophy
The Closed Circuit Pattern
Every user interaction in Almadar follows a guaranteed flow:
Event (User Action)
↓
Guard Evaluation (Permission Check)
↓
State Transition (Behavior Logic)
↓
Effects Execution
↓
Response to UI
This pattern ensures:
- Security by design - Guards enforce permissions at the transition level
- Predictable behavior - State machines can only exist in valid states
- Testability - Every path is enumerable and testable
Three Pillars
- Entities - What your application manages (data)
- Traits - How your application behaves (state machines)
- Pages - Where your application appears (routes)
Why "Almadar"?
Like planets in orbit around a star, application components in Almadar follow predictable, law-governed paths. The laws of physics ensure stability; Almadar's state machines ensure application consistency.
Community
- Discord - Real-time chat and support
- GitHub Discussions - Technical discussions
- Twitter @OrbitalLang - Updates and announcements
Built with passion by Almadar