Documentation | Workshops | Contribute | Chat

Kaoto is a visual editor for Apache Camel integrations. It offers support in creating and editing Camel Routes, Kamelets and Pipes. Kaoto also has a built-in catalog with available Camel components, Enterprise Integration Patterns and Kamelets provided by the Apache Camel community.

Have a quick look at our online demo instance: https://kaotoio.github.io/kaoto/

• Requirements
• Getting Started
  • Clone the Repository
  • Install Dependencies
• Running kaoto with Docker
• Development
  • Web Application
    • Run
    • Build
  • Public Components
• How to do a release
• Camel Catalog and Supporting Schemas
• Storybook

• NodeJS (v18.x or higher) +info
• Yarn (v3.x or higher) +info
• OpenJDK (v21 or higher) +info

For more information on Vite, check Vite's documentation.

First, clone the repository to your local machine.

git clone https://github.com/KaotoIO/kaoto

Navigate to the cloned directory and install the necessary packages.

cd kaoto
yarn install

Note: By default, @kaoto/camel-catalog will also be built using the mvn wrapper.

For trial purposes, there is a docker image that can be run locally:

docker run --rm -p 8080:8080 --name kaoto quay.io/kaotoio/kaoto-app:main

To start the development server, execute the following command:

yarn workspace @kaoto/kaoto run start

The application will be accessible at http://localhost:5173 by default.

To build the web application, execute:

yarn workspace @kaoto/kaoto run build

To build the public components, execute:

yarn workspace @kaoto/kaoto run build:lib

To build the Camel Catalog and the supporting schemas, run:

yarn workspace @kaoto/camel-catalog run build

Optional: You can update the Camel version in the pom.xml file and then run the build command again.

To view the storybook stories, go to Chromatic. The stories are built for non-Dependabot pull requests and the link to storybook generated for PR is linked once the storybook is published. You can learn more about how to create a story for your UI component here.

To run Storybook locally:

# first build the ui library
yarn workspace @kaoto/kaoto build:lib

# run the storybook
yarn workspace @kaoto/kaoto-tests storybook

To publish to Chromatic: yarn workspace @kaoto/kaoto-tests chromatic