Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »


    RAML Definition System

    Build Status

    This repository contains a set of interfaces that represents a declarative description of the RAML specification.

    IMPORTANT: This is still in development and should be considered alpha.


    From NPM

    npm install raml-definition-system --save

    From Sources

    npm install


    Make sure you executed all necessary installation steps before you try to generate anything. See section From Sources for more information.

    The result files can be found inside the dist/ repository ending with .json.

    Build Sources

    npm run build

    JSON Structure for the Definition System

    One can either use the provided interfaces in TypeScript or a JSON representation of the definition system that can be generated by running either the complete build or npm run generateJSON.


    The raml-definition-system is an open source project and any contribution is always welcome. Please bear in mind that the definition system is a full reflection of the RAML specification and must not contain anything that is not mentioned inside the specification. Therefore, contribution to the actual interfaces should be limited to bug fixes only.

    1. Check for open issues or open a fresh issue to start a discussion around an idea or a bug.
    2. Fork the repository on Github and make your changes on the develop branch (or branch off of it).
    3. Send a pull request (with the develop branch as the target).

    A big thank you goes out to everyone who helped with the project, the contributors and everyone who took the time to report issues and give feedback.

    You can also directly get in touch with us. Simply send us an email to:

    RAML version support

    Currently, the definition system provides interfaces for RAML 0.8 and 1.0 RC1 version.


    Apache License 2.0


    npm i raml-definition-system

    Downloadslast 7 days







    last publish


    • avatar
    • avatar