{"id":13594652,"url":"https://github.com/ossuminc/riddl","last_synced_at":"2026-04-27T01:04:26.483Z","repository":{"id":37238309,"uuid":"436146906","full_name":"ossuminc/riddl","owner":"ossuminc","description":"A compiler for the DDD-based design language RIDDL","archived":false,"fork":false,"pushed_at":"2026-04-02T02:31:17.000Z","size":26252,"stargazers_count":2,"open_issues_count":70,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-03T02:18:39.445Z","etag":null,"topics":["ddd","ddd-architecture","ddd-patterns","design","design-language","design-patterns","fastparse","reactive-architecture","scala"],"latest_commit_sha":null,"homepage":"https://ossum.tech/riddl","language":"Scala","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ossuminc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"ko_fi":"ossuminc","github":["reid-spencer"],"patreon":null,"open_collective":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"custom":null}},"created_at":"2021-12-08T06:54:48.000Z","updated_at":"2026-04-02T02:31:21.000Z","dependencies_parsed_at":"2023-09-25T03:39:20.099Z","dependency_job_id":"26bc066f-5814-48a4-8550-131b9982e03b","html_url":"https://github.com/ossuminc/riddl","commit_stats":null,"previous_names":["ossuminc/riddl","reactific/riddl"],"tags_count":179,"template":false,"template_full_name":null,"purl":"pkg:github/ossuminc/riddl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ossuminc%2Friddl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ossuminc%2Friddl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ossuminc%2Friddl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ossuminc%2Friddl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ossuminc","download_url":"https://codeload.github.com/ossuminc/riddl/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ossuminc%2Friddl/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31420789,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T00:25:07.052Z","status":"ssl_error","status_checked_at":"2026-04-05T00:25:05.923Z","response_time":60,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ddd","ddd-architecture","ddd-patterns","design","design-language","design-patterns","fastparse","reactive-architecture","scala"],"created_at":"2024-08-01T16:01:37.035Z","updated_at":"2026-04-05T01:03:04.462Z","avatar_url":"https://github.com/ossuminc.png","language":"Scala","funding_links":["https://ko-fi.com/ossuminc","https://github.com/sponsors/reid-spencer"],"categories":["Scala"],"sub_categories":[],"readme":"[![Code Build Status](https://github.com/ossuminc/riddl/actions/workflows/scala.yml/badge.svg)](https://github.com/ossuminc/riddl/actions/workflows/scala.yml/badge.svg)\n[![Documentation Build Status](https://github.com/ossuminc/riddl/actions/workflows/hugo.yml/badge.svg)](https://github.com/ossuminc/riddl/actions/workflows/hugo.yml/badge.svg)\n[![Coverage Status](https://coveralls.io/repos/github/ossuminc/riddl/badge.svg?branch=main)](https://coveralls.io/github/ossuminc/riddl?branch=main)\n[![Maven Central](https://img.shields.io/maven-central/v/com.ossuminc/riddlc_3.svg)](https://maven-badges.herokuapp.com/maven-central/com.ossuminc/riddlc_3)\n[![Scala.js](https://www.scala-js.org/assets/badges/scalajs-1.17.0.svg)](https://www.scala-js.org)\n\n[![CLA assistant](https://cla-assistant.io/readme/badge/ossuminc/riddl)](https://cla-assistant.io/ossuminc/riddl)\n[![Scala Steward badge](https://img.shields.io/badge/Scala_Steward-helping-blue.svg?style=flat\u0026logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA4AAAAQCAMAAAARSr4IAAAAVFBMVEUAAACHjojlOy5NWlrKzcYRKjGFjIbp293YycuLa3pYY2LSqql4f3pCUFTgSjNodYRmcXUsPD/NTTbjRS+2jomhgnzNc223cGvZS0HaSD0XLjbaSjElhIr+AAAAAXRSTlMAQObYZgAAAHlJREFUCNdNyosOwyAIhWHAQS1Vt7a77/3fcxxdmv0xwmckutAR1nkm4ggbyEcg/wWmlGLDAA3oL50xi6fk5ffZ3E2E3QfZDCcCN2YtbEWZt+Drc6u6rlqv7Uk0LdKqqr5rk2UCRXOk0vmQKGfc94nOJyQjouF9H/wCc9gECEYfONoAAAAASUVORK5CYII=)](https://scala-steward.org)\n[![License](https://img.shields.io/badge/license-Apache%202-blue.svg)](https://raw.githubusercontent.com/ossuminc/riddl/master/LICENSE)\n\n[![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=ossuminc_riddl\u0026metric=code_smells)](https://sonarcloud.io/summary/new_code?id=ossuminc_riddl)\n[![Bugs](https://sonarcloud.io/api/project_badges/measure?project=ossuminc_riddl\u0026metric=bugs)](https://sonarcloud.io/summary/new_code?id=ossuminc_riddl)\n[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=ossuminc_riddl\u0026metric=vulnerabilities)](https://sonarcloud.io/summary/new_code?id=ossuminc_riddl)\n[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=ossuminc_riddl\u0026metric=security_rating)](https://sonarcloud.io/summary/new_code?id=ossuminc_riddl)\n[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=ossuminc_riddl\u0026metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=ossuminc_riddl)\n[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=ossuminc_riddl\u0026metric=reliability_rating)](https://sonarcloud.io/summary/new_code?id=ossuminc_riddl)\n[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=ossuminc_riddl\u0026metric=ncloc)](https://sonarcloud.io/summary/new_code?id=ossuminc_riddl)\n[![Duplicated Lines (%)](https://sonarcloud.io/api/project_badges/measure?project=ossuminc_riddl\u0026metric=duplicated_lines_density)](https://sonarcloud.io/summary/new_code?id=ossuminc_riddl)\n[![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=ossuminc_riddl\u0026metric=sqale_index)](https://sonarcloud.io/summary/new_code?id=ossuminc_riddl)\n\n\n# RIDDL\n\n## Handy Links\n* Full Documentation: https://riddl.tech\n* Coveralls Code Coverage Report: https://coveralls.io/github/ossuminc/riddl?branch=main\n* SonarCloud Reports: https://sonarcloud.io/project/overview?id=ossuminc_riddl\n\n## Introduction\nRIDDL, the Reactive Interface to Domain Definition Language, is a specification\nlanugage and tooling to help capture requirements and specify designs for the\nclass of systems that can be designed with DDD and utilize a distributed, reactive\ncloud native architecture.  \n\n\nRIDDL allows subject matter experts, business analysts, and system architects to\nwork at a higher level of abstraction than they would if they were coding directly\nin a programming language. RIDDL aims to relieve developers of the burden of \nmaintaining infrastructural code through evolution of the system abstractions.\n\n## Important Documentation Sections\n\n* [Introduction](https://riddl.tech/introduction/) - answer the important initial \n  questions\n* [Concepts](https://riddl.tech/concepts/) - provides a conceptual understanding \n  of RIDDL before diving into the details\n* [Guides](https://riddl.tech/guides/) - four guides for different kinds of RIDDL audiences.\n* [riddlc](https://riddl.tech/tooling/riddlc/) - various ways to obtain the RIDDL compiler\n\n## Install With `brew`\nTBD\n\n## Quickly Building On Your Computer\nTo use `riddlc` locally and be able to update it with new changes, use this approach:\n* `git clone https://github.com/ossuminc/riddl.git`\n* Change the directory to that cloned repository\n* Put the full path to `riddl/riddlc/target/universal/stage/bin` directory in your\n  PATH variable\n* Build the entire package with `sbt compile`\n* Chane directory to the `riddlc` sub-project\n* Run `sbt stage` to build the program into the`riddlc/target/universal/stage/bin` \n  directory\n* To update, run `git pull` from the `riddl` cloned repository and rerun the\n  `sbt stage` command in the `riddlc` sub-project  to rebuild. \n\nThis allows you to both make local changes and pull in changes from others to\nkeep your local copy of `riddlc` up to date. \n\n## Usage\nTo get the most recent options, run `riddlc help`. That command will give you\nthe syntax for doing various things with the riddl compiler (`riddlc`)\n\n## Version / Info\nThe `riddlc` compiler has two commands, `info` and `version` that just print\nout information about the build, and the version number, respectively, and then exit. \n\n## Contributing\n_Contributions are very welcome!_\n\nIf you see an issue that you'd like to see fixed or want us to consider a\nchange, the best way to make it happen is to help by submitting a \npull request implementing it. We welcome contributions from all, even if\nyou are unfamiliar with RIDDL. We will endeavor to guide you \nthrough the process once you've submitted your PR. \n\nPlease refer to the CONTRIBUTING.md file for more details about the workflow \nand general hints on preparing your pull request. You can also ask for\nclarifications or guidance on GitHub issues directly.\n\nThe RIDDL family of repositories is owned by Ossum, Inc., and they require\nthe use of a \n[CLA (Contributor License Agreement)](https://cla-assistant.io/ossuminc/riddl).\nYou can sign at that link or be prompted to do so when you submit your first\nPull Request. \n\n# IntelliJ File Type \u0026 Color Scheme Support\n\nThe `language` directory contains two files that will improve the visual appeal of\nRIDDL source code in your IntelliJ IDEA. To load them, follow the instructions below:\n\n## File Type Support\nThis will provide support for the `.riddl` file type which you should use for\nyour RIDDL files. This is provided in [intellij-idea-riddl-file-type-settings.zip](intellij-idea-riddl-file-type-settings.zip)\n\n* To load into IntelliJ:\n  - Select `File -\u003e Manage IDE Settings -\u003e Import Settings...` from IntelliJ menu\n  - Navigate to your cloned repository in the `language` folder\n  - Select `intellij-idea-riddl-file-type-settings.zip`\n\n## Color Scheme Support\nDifferentiating between keywords, readability words, definitions, punctuation, types, etc.\nis supported through the use of color scheme settings in this file:\n[intellij-idea-riddl-colour-scheme-settings.jar](intellij-idea-riddl-colour-scheme-settings.jar). Note that using this colour scheme\nrequires overriding other themes as only 1 scheme can be used in IDEA at a time. You\ncan switch themes in the Settings under `Editor --\u003e Color Schemes`\n\n* To load into IntelliJ:\n  - Load the IntelliJ Settings dialog (`File -\u003e Settings` or Settings gear on top right)\n  - Navigate to the `Editor -\u003e Color Scheme` settings\n  - Click the `Show Scheme Actions` gear icon to the right of the scheme selector\n  - Choose `Import Scheme...` from the pop up menu\n  - Navigate to your cloned repository in the `language` folder\n  - Select `intellij-idea-riddl-colour-scheme-settings.jar`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fossuminc%2Friddl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fossuminc%2Friddl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fossuminc%2Friddl/lists"}