diagrams-ts

TypeScript-Port of the python library diagrams by mingrammer. Creating architecture diagrams directly from code.

About

Inspired by the nice visuals and easy to read syntax of the original library, this port tries to provide the same for Typescript. Styles and the Nodes are taken from the original library. It also uses graphviz for the final graph rendering.

Disclaimer: This project is still under development, not finished and the api can have breaking changes between versions. Use with care.

Installation and Requirements

In order to create svg, png or webp output you'll need to install graphviz. This package expects dot cli of graphviz to be available in your path. If you used the default installation path of graphviz, you can check this by running:

dot -v

This package is build for ES2015. For developing you'll need a node version >= 14.

Install this package by running:

npm install diagrams-ts

# or when using yarn

yarn add diagram-ts

Getting started

Import the library, choose a provider, write your code and generate your first diagram.

main.ts:

import * as diagrams from "diagrams-ts";

const {
  providers: {
    aws: {
      compute: { Lambda },
      integration: { SQS },
      storage: { S3 },
    },
  },
  createDiagram,
  diagram,
} = diagrams;

const awsFlow = () => {
  const producer = Lambda("Producer");
  const queue = SQS("Queue");
  const consumer = Lambda("Consumer");
  const bucket = S3("My Bucket");

  return diagram`${producer}>>${queue}>>${consumer}>>${bucket}`;
};

(async () => {
  try {
    await createDiagram({
      label: "AWS Flow",
      filename: "./generated-assets/aws-flow.png",
    })(awsFlow());
  } catch (error) {
    console.log(error);
  }
})();

If you'll run it will create the "aws-flow.png" in the output folder:

For more examples of the syntax you can take look at the examples folder. In order to run them, you can use ts-node e.g.:

# In the project root:

yarn ts-node ./examples/diagrams-example.ts