This is an automated email from the ASF dual-hosted git repository. davsclaus pushed a commit to branch feature/1607-tooling-page in repository https://gitbox.apache.org/repos/asf/camel-website.git
commit 7982d316f433c7951c846d3f78ee88be8390de7a Author: Claus Ibsen <[email protected]> AuthorDate: Fri Jun 5 07:58:55 2026 +0200 #1607: Create dedicated Camel Tooling page Co-Authored-By: Claude Opus 4.6 <[email protected]> --- antora-ui-camel/public/_/data/rev-manifest.json | 1 + .../public/_/img/tooling-9f893843e8.svg | 3 + antora-ui-camel/src/img/tooling.svg | 3 + config.toml | 11 +- content/community/user-stories.md | 11 -- content/tooling/_index.md | 112 +++++++++++++++++++++ 6 files changed, 128 insertions(+), 13 deletions(-) diff --git a/antora-ui-camel/public/_/data/rev-manifest.json b/antora-ui-camel/public/_/data/rev-manifest.json index 9e95d8a1..99de7882 100644 --- a/antora-ui-camel/public/_/data/rev-manifest.json +++ b/antora-ui-camel/public/_/data/rev-manifest.json @@ -38,6 +38,7 @@ "img/spring-boot.svg": "img/spring-boot-0a7cb95564.svg", "img/support.svg": "img/support-7219bb2f58.svg", "img/team.svg": "img/team-899f1050c2.svg", + "img/tooling.svg": "img/tooling-9f893843e8.svg", "img/user-stories.svg": "img/user-stories-cccc5f7c8f.svg", "js/site.js": "js/site-0eeb09d476.js", "js/vendor/algoliasearch.js": "js/vendor/algoliasearch-c7d08807d6.js", diff --git a/antora-ui-camel/public/_/img/tooling-9f893843e8.svg b/antora-ui-camel/public/_/img/tooling-9f893843e8.svg new file mode 100644 index 00000000..32bc0452 --- /dev/null +++ b/antora-ui-camel/public/_/img/tooling-9f893843e8.svg @@ -0,0 +1,3 @@ +<svg xmlns="http://www.w3.org/2000/svg"; viewBox="0 0 24 24"> +<path d="M0 0h24v24H0z" fill="none"/><path fill="#fff" d="M22.7 19l-9.1-9.1c.9-2.3.4-5-1.5-6.9-2-2-5-2.4-7.4-1.3L9 6 6 9 1.6 4.7C.4 7.1.9 10.1 2.9 12.1c1.9 1.9 4.6 2.4 6.9 1.5l9.1 9.1c.4.4 1 .4 1.4 0l2.3-2.3c.5-.4.5-1.1.1-1.4z"/> +</svg> diff --git a/antora-ui-camel/src/img/tooling.svg b/antora-ui-camel/src/img/tooling.svg new file mode 100644 index 00000000..32bc0452 --- /dev/null +++ b/antora-ui-camel/src/img/tooling.svg @@ -0,0 +1,3 @@ +<svg xmlns="http://www.w3.org/2000/svg"; viewBox="0 0 24 24"> +<path d="M0 0h24v24H0z" fill="none"/><path fill="#fff" d="M22.7 19l-9.1-9.1c.9-2.3.4-5-1.5-6.9-2-2-5-2.4-7.4-1.3L9 6 6 9 1.6 4.7C.4 7.1.9 10.1 2.9 12.1c1.9 1.9 4.6 2.4 6.9 1.5l9.1 9.1c.4.4 1 .4 1.4 0l2.3-2.3c.5-.4.5-1.1.1-1.4z"/> +</svg> diff --git a/config.toml b/config.toml index a8ec58b2..46b007da 100644 --- a/config.toml +++ b/config.toml @@ -62,15 +62,22 @@ defaultMarkdownHandler = "goldmark" pre = "img/community.svg" [[menu.main]] - name = "Download" + name = "Tooling" weight = 5 + identifier = "tooling" + url = "/tooling/" + pre = "img/tooling.svg" + +[[menu.main]] + name = "Download" + weight = 6 identifier = "download" url = "/download/" pre = "img/download.svg" [[menu.main]] name = "Security" - weight = 6 + weight = 7 identifier = "security" url = "/security/" pre = "img/security.svg" diff --git a/content/community/user-stories.md b/content/community/user-stories.md index 481e9362..0166469b 100644 --- a/content/community/user-stories.md +++ b/content/community/user-stories.md @@ -146,14 +146,3 @@ This page is intended as a place to collect user stories and feedback on Apache |[Red Hat Build of Apache Camel](https://www.redhat.com/en/technologies/jboss-middleware/fuse)|Red Hat provides a commercial distribution of Apache Camel with enterprise support.| {{< /table >}} -## Developer Tooling -{{< table >}} -| Project | Description | -|---------|-------------| -|[Apache Camel IDEA Plugin](https://github.com/camel-idea-plugin/camel-idea-plugin)|Plugin for Intellij IDEA to provide a set of Apache Camel related editing capabilities to the code editor. It also provides Camel textual route debugging capabilities.| -|[Camel Debug Adapter](https://github.com/camel-tooling/camel-debug-adapter)|A server implementation of the [Debug Adapter Protocol](https://microsoft.github.io/debug-adapter-protocol/) that provides Camel textual route debugging capabilities. It is packaged for [VS Code](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-debug-adapter-apache-camel) and [Eclipse Desktop IDE](https://marketplace.eclipse.org/content/textual-debugging-apache-camel).| -|[Camel Language Server](https://github.com/camel-tooling/camel-language-server)|A server implementation of the [Language Server protocol](https://github.com/Microsoft/language-server-protocol) that provides Camel DSL smartness (completion, validation, hover, outline). It is packaged for [VS Code](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-apache-camel) and [Eclipse Desktop IDE](https://marketplace.eclipse.org/content/language-support-apache-camel).| -|[Kaoto](https://kaoto.io/)|Kaoto is an integration editor to create and deploy workflows in a visual, low-code way; with developer-friendly features like a code editor and deployments to the cloud.| -|[VS Code extension pack for Camel](https://marketplace.visualstudio.com/items?itemName=redhat.apache-camel-extension-pack)|It provides a set of tools to develop Camel applications.| -|[hawt.io](http://hawt.io)|hawt.io is an open source HTML5 web application for visualizing, managing and tracing Camel routes & endpoints, ActiveMQ brokers, JMX, and much more.| -{{< /table >}} diff --git a/content/tooling/_index.md b/content/tooling/_index.md new file mode 100644 index 00000000..6de943ff --- /dev/null +++ b/content/tooling/_index.md @@ -0,0 +1,112 @@ +--- +title: "Tooling" +--- + +Apache Camel ships with a rich set of built-in developer tools and is supported by a growing ecosystem of third-party tooling. Whether you prefer the command line, an IDE, a visual editor, or AI-assisted development — there is tooling to help you build, test, debug, and manage your Camel integrations. + +## Camel CLI + +The Camel CLI, powered by [JBang](https://www.jbang.dev/), lets you get started with Camel instantly — no project setup, no build tool configuration. Install it once, then use the `camel` command to develop, run, test, and export your integrations. + +{{< table >}} +| Command | Description | +|---------|-------------| +|`camel run`|Run Camel routes from source files (Java, YAML, XML, etc.) with automatic classpath management| +|`camel dev`|Run in developer mode with hot-reload — changes are picked up automatically without restarting| +|`camel trace`|Live message tracing, step by step through your routes to see how messages are processed| +|`camel send`|Send test messages to running Camel routes for quick testing and debugging| +|`camel test`|Run tests for your Camel routes| +|`camel export`|Export your Camel project to Spring Boot, Quarkus, or standalone Java for production deployment| +{{< /table >}} + +See the [Camel CLI documentation](/manual/camel-jbang.html) for installation instructions and detailed usage. + +### Camel TUI + +The `camel tui` command launches a full terminal-based UI that provides fast, real-time feedback during development — a natural fit for CLI-first and AI-assisted workflows. It gives you route status, message flow, and tracing all in a single terminal view, so you can stay in the flow without switching tools. Ideal for low-code and AI-assisted development where quick iteration matters. + +## Camel MCP Server + +The [Camel MCP Server](https://github.com/apache/camel-mcp-server) connects Apache Camel to AI coding assistants through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/). It gives AI tools access to Camel's component catalog, DSL documentation, and integration patterns — so they can help you write, debug, and optimize Camel routes with full context. + +Supported AI tools include Claude Code, GitHub Copilot, Gemini CLI, Cursor, Windsurf, and any MCP-compatible assistant. + +## AI-Assisted Development + +{{< table >}} +| Tool | Description | +|------|-------------| +|[Camel Kit](https://github.com/luigidemasi/camel-kit)|A set of structured slash commands for AI coding assistants that guide you through the complete integration lifecycle — from design and planning to implementation and verification. Supports Claude Code, Gemini CLI, and more.| +{{< /table >}} + +## Maven Plugins + +For production projects, Camel provides a set of Maven plugins that integrate with your existing build workflow: + +{{< table >}} +| Plugin | Description | +|--------|-------------| +|[Camel Maven Plugin](/manual/camel-maven-plugin.html)|The main plugin for running and developing Camel applications from Maven. Goals: `camel:run` (run routes), `camel:dev` (developer mode with hot-reload), `camel:debug` (debug mode for textual route debugging), `camel:prepare-fatjar` (prepare for fat-jar packaging).| +|[Camel Report Maven Plugin](/manual/camel-report-maven-plugin.html)|Validates source code for invalid Camel endpoint URIs, Simple expressions, duplicate route IDs, and generates route coverage reports after unit testing.| +|[Camel YAML DSL Validator Maven Plugin](/manual/camel-yaml-dsl-validator-maven-plugin.html)|Validates YAML DSL route files for syntax errors according to the spec, without needing to run Camel.| +|[Camel Component Maven Plugin](/manual/camel-component-maven-plugin.html)|Assists third-party component developers in generating all necessary metadata and configuration Java classes for custom Camel components.| +|[Camel REST DSL OpenAPI Plugin](/manual/rest-dsl-openapi.html)|Generates REST DSL routes and DTOs from OpenAPI v3 specification files for a contract-first approach.| +{{< /table >}} + +A [Camel Gradle Plugin](https://github.com/apache/camel/tree/main/tooling/camel-gradle-plugin) is also available for Gradle users. + +## Maven Archetypes + +Camel provides [Maven Archetypes](/manual/camel-maven-archetypes.html) to quickly scaffold new projects: + +{{< table >}} +| Archetype | Description | +|-----------|-------------| +|camel-archetype-java|Creates a new Camel project using Java DSL| +|camel-archetype-main|Creates a new Camel project using standalone Camel Main| +|camel-archetype-spring|Creates a new Camel project with Spring DSL support| +|camel-archetype-component|Creates a new Camel component| +|camel-archetype-dataformat|Creates a new Camel data format| +|camel-archetype-api-component|Creates a new Camel component that wraps one or more API proxies| +{{< /table >}} + +## Libraries + +{{< table >}} +| Tool | Description | +|------|-------------| +|[Forage](https://kaotoio.github.io/forage/)|Opinionated bean factories for Apache Camel — configure data sources, connection factories, AI models, transaction managers, and more via properties instead of Java code. Works with Camel JBang, Spring Boot, and Quarkus.| +{{< /table >}} + +## IDE Plugins and Extensions + +{{< table >}} +| Tool | Description | +|------|-------------| +|[Apache Camel IDEA Plugin](https://github.com/camel-idea-plugin/camel-idea-plugin)|Plugin for IntelliJ IDEA to provide a set of Apache Camel related editing capabilities to the code editor. It also provides Camel textual route debugging capabilities.| +|[VS Code Extension Pack for Camel](https://marketplace.visualstudio.com/items?itemName=redhat.apache-camel-extension-pack)|A set of VS Code extensions for developing Camel applications — includes language support, debugging, and more.| +|[Camel Language Server](https://github.com/camel-tooling/camel-language-server)|A [Language Server Protocol](https://github.com/Microsoft/language-server-protocol) implementation that provides Camel DSL smartness (completion, validation, hover, outline). Packaged for [VS Code](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-apache-camel) and [Eclipse Desktop](https://marketplace.eclipse.org/content/language-support-apache-camel).| +|[Camel Debug Adapter](https://github.com/camel-tooling/camel-debug-adapter)|A [Debug Adapter Protocol](https://microsoft.github.io/debug-adapter-protocol/) implementation that provides Camel textual route debugging capabilities. Packaged for [VS Code](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-debug-adapter-apache-camel) and [Eclipse Desktop](https://marketplace.eclipse.org/content/textual-debugging-apache-camel).| +{{< /table >}} + +## Visual Editing + +{{< table >}} +| Tool | Description | +|------|-------------| +|[Camel Karavan](https://karavan.space/)|Camel Karavan is a visual development tool for Apache Camel that provides a rich graphical editor for designing and deploying integration routes.| +|[Kaoto](https://kaoto.io/)|Kaoto is an integration editor to create and deploy workflows in a visual, low-code way; with developer-friendly features like a code editor and deployments to the cloud.| +{{< /table >}} + +## Monitoring and Management + +{{< table >}} +| Tool | Description | +|------|-------------| +|[Camel Monitor Operator](https://camel-tooling.github.io/camel-dashboard/docs/installation-guide/advanced/operator/)|A Kubernetes operator that discovers and monitors Camel applications running in the cloud. Provides a lightweight monitoring layer with a GUI dashboard and integrates with advanced monitoring systems like Prometheus.| +|[hawt.io](http://hawt.io)|hawt.io is an open source HTML5 web application for visualizing, managing and tracing Camel routes & endpoints, ActiveMQ brokers, JMX, and much more.| +{{< /table >}} + +--- + +If you are using or have developed tooling for Apache Camel please add an entry via a [pull request](https://github.com/apache/camel-website); or post to the [mailing list](/community/mailing-list/).
