Open Source

RIDDL Compiler

The Reactive Interface to Domain Definition Language. Specify large, distributed, reactive systems in a language that both business experts and developers can understand.

What is RIDDL?

RIDDL is an open source specification language designed for large, distributed, reactive systems - the kind needed for modern internet-scale applications and corporate back-office infrastructure.

Unlike traditional programming languages, RIDDL specifications read like requirements documentation. Domain experts can understand and contribute to them directly, bridging the communication gap between business and technical teams.

domain OnlineRetail is {
  user Customer is "a person who shops online"

  epic Shopping is {
    user Customer wants to "browse and purchase products"
      so that "I can get items delivered to my home"

    case AddToCart is {
      user Customer wants to "add a product to my cart"
        so that "I can purchase it later"

      step for user Customer is "views a product they like"
      step for user Customer is "clicks Add to Cart"
      step for user Customer is "sees the updated cart total"
    }
  }
}

This specification reads like requirements documentation yet compiles, validates, and can be translated to implementation code.

Key Features

Validation

Every definition has specific types and containment rules. References are validated across the entire model. The compiler catches inconsistencies automatically.

Documentation Generation

The specification IS the documentation. Generate always-in-sync docs from your models with briefly and described by clauses.

AI-Ready

Structured enough for AI to understand context. The prompt statement explicitly captures implementation intent for code generation.

Technology-Agnostic

Not tied to any programming language, cloud vendor, or specific technology. A single source of truth that evolves through every stage of development.

Iterative Refinement

Start with high-level concepts and progressively add detail. RIDDL supports the natural evolution of understanding.

Team Collaboration

Business-readable specifications that domain experts can review and contribute to, reducing miscommunication and rework.

Get Started with RIDDL

RIDDL is open source and free to use. Check out the documentation to learn the language, or try Synapify for a visual editing experience.