# Arconia — Spring Boot Add-on for Dev UX & Observability

> Arconia is a Spring Boot add-on for DX, Kubernetes readiness, multitenancy, and unified observability (OpenTelemetry + Micrometer), plus GenAI modules.

## Install

Save in your project root:

## Quick Use

1. Open the docs and pick the module you need: https://arconia.io/docs/arconia/latest/index.html
2. Add the BOM (artifact from README badge: `io.arconia:arconia-bom`) and then add modules.

Example (Maven BOM pattern — fill the version from Maven Central):
```xml
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>io.arconia</groupId>
      <artifactId>arconia-bom</artifactId>
      <version><!-- pick latest --></version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>
```

## Intro

Arconia is an add-on framework for Spring Boot that targets modern cloud-native Java apps. The README highlights Dev Services for local DX, unified observability (OpenTelemetry + Micrometer), Kubernetes support, multitenancy, and GenAI-related integrations.

**Best for:** Spring Boot teams who want better local DX and standardized observability without adding many separate frameworks

**Works with:** Spring Boot, Maven/Gradle builds, OpenTelemetry and Micrometer ecosystems, Kubernetes deployments

**Setup time:** 30–60 minutes

### Key facts (verified)

- README explicitly calls out unified observability via OpenTelemetry and Micrometer.
- Maven Central badge indicates a BOM artifact `io.arconia:arconia-bom` for dependency management.
- GitHub: 142 stars · 15 forks; pushed 2026-05-11 (GitHub API verified).

## Main

Treat Arconia as a “curated layer” over Spring Boot:

- Start from one goal (DX or observability).
- Adopt modules incrementally to avoid surprise behaviors.
- In AI-heavy services, capture trace + metrics around model calls and evaluations early.

If you already use Micrometer, validate how OpenTelemetry export is wired in your current stack before turning everything on.

### README excerpt (verbatim)

<p align="center">
  <img src="arconia-logo.png" alt="Arconia" width="200" />
</p>

<h1 align="center">Arconia Framework</h1>

<p align="center">
  An add-on framework for <a href="https://spring.io/projects/spring-boot">Spring Boot</a>, designed to enhance modern enterprise applications built with <a href="https://dev.java">Java</a>.<br/>
  Add Arconia to an existing Spring Boot application to boost developer experience, reduce boilerplate, and seamlessly adopt cloud native patterns.
</p>

<p align="center">
  <a href="https://github.com/arconia-io/arconia/actions/workflows/commit-stage.yml?query=branch%3Amain"><img src="https://img.shields.io/github/actions/workflow/status/arconia-io/arconia/commit-stage.yml?branch=main&logo=GitHub&label=Build" alt="Build" /></a>
  <a href="https://central.sonatype.com/namespace/io.arconia"><img src="https://img.shields.io/maven-central/v/io.arconia/arconia-bom?logo=apache%20maven&label=Maven%20Central&color=blue" alt="Maven Central" /></a>
  <a href="https://scorecard.dev/viewer/?uri=github.com/arconia-io/arconia"><img src="https://api.scorecard.dev/projects/github.com/arconia-io/arconia/badge" alt="OpenSSF Scorecard" /></a>
  <a href="https://www.bestpractices.dev/projects/11241"><img src="https://www.bestpractices.dev/projects/11241/badge" alt="OpenSSF Best Practices" /></a>
  <a href="https://opensource.org/licenses/Apache-2.0"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="Apache 2.0 License" /></a>
  <a href="https://bsky.app/profile/arconia.io"><img src="https://img.shields.io/static/v1?label=Bluesky&message=Follow&color=1DA1F2" alt="Follow us on Bluesky" /></a>
</p>

---

## ✨&nbsp; Features

- **Developer Experience.** First-class support for development and testing modes in Spring Boot applications, making local development easier, more productive, and more fun. Includes Dev Services for automatic provisioning of external services using containers.
- **Generative AI.** Extended integration capabilities for Spring Boot applications, including AI observability and evaluation platforms, AI inference services, and AI document processors.
- **Kubernetes.** Simplified configuration and deployment of Spring Boot applications to Kubernetes, including multi-architecture container images, Service Binding specification support, and automatic generation of Kubernetes manifests.
- **Multitenancy.** Built-in support for multitenant applications, covering web, data, security, and configuration aspects.

### FAQ

**Q: Is Arconia stable?**
A: README notes it’s under active development towards the first stable release.

**Q: Where do I find modules and guides?**
A: Use the docs link in README: arconia.io/docs/arconia/latest.

**Q: What’s the main win?**
A: Developer experience improvements plus unified observability for Spring Boot apps.

## Source & Thanks

> Source: https://github.com/arconia-io/arconia
> License: Apache-2.0
> GitHub stars: 142 · forks: 15

---

<!-- ZH -->

## 快速使用

1. 打开文档并选择所需模块：https://arconia.io/docs/arconia/latest/index.html
2. 先引入 BOM（README 徽章显示 artifact：`io.arconia:arconia-bom`），再按模块添加依赖。

示例（Maven BOM 模式——版本号从 Maven Central 选择）：
```xml
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>io.arconia</groupId>
      <artifactId>arconia-bom</artifactId>
      <version><!-- 选择最新版本 --></version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>
```

## 简介

Arconia 是 Spring Boot 的增强框架，面向现代云原生 Java 应用。README 强调 Dev Services 提升本地开发体验、统一可观测性（OpenTelemetry + Micrometer）、Kubernetes 支持、多租户能力，以及 GenAI 相关集成。

**最适合：** 希望提升本地开发体验并统一可观测性、又不想堆很多独立框架的 Spring Boot 团队

**适配：** Spring Boot、Maven/Gradle 构建、OpenTelemetry/Micrometer 生态、Kubernetes 部署

**配置时间：** 30–60 分钟

### 关键事实（已验证）

- README 明确提到 OpenTelemetry + Micrometer 的统一可观测性支持。
- README 的 Maven Central 徽章显示提供 BOM artifact：`io.arconia:arconia-bom`。
- GitHub：142 stars · 15 forks；最近更新 2026-05-11（GitHub API 验证）。

## 正文

把 Arconia 当作 Spring Boot 的“精选增强层”：

- 从一个目标切入（开发体验或可观测性）。
- 模块化渐进接入，避免行为变化过大。
- AI 服务建议尽早把模型调用与评估的 trace/metrics 打通。

如果你已在用 Micrometer，上线前先确认 OpenTelemetry 的导出链路与现有栈如何衔接，再逐步开启。

### README 原文节选（verbatim）

<p align="center">
  <img src="arconia-logo.png" alt="Arconia" width="200" />
</p>

<h1 align="center">Arconia Framework</h1>

<p align="center">
  An add-on framework for <a href="https://spring.io/projects/spring-boot">Spring Boot</a>, designed to enhance modern enterprise applications built with <a href="https://dev.java">Java</a>.<br/>
  Add Arconia to an existing Spring Boot application to boost developer experience, reduce boilerplate, and seamlessly adopt cloud native patterns.
</p>

<p align="center">
  <a href="https://github.com/arconia-io/arconia/actions/workflows/commit-stage.yml?query=branch%3Amain"><img src="https://img.shields.io/github/actions/workflow/status/arconia-io/arconia/commit-stage.yml?branch=main&logo=GitHub&label=Build" alt="Build" /></a>
  <a href="https://central.sonatype.com/namespace/io.arconia"><img src="https://img.shields.io/maven-central/v/io.arconia/arconia-bom?logo=apache%20maven&label=Maven%20Central&color=blue" alt="Maven Central" /></a>
  <a href="https://scorecard.dev/viewer/?uri=github.com/arconia-io/arconia"><img src="https://api.scorecard.dev/projects/github.com/arconia-io/arconia/badge" alt="OpenSSF Scorecard" /></a>
  <a href="https://www.bestpractices.dev/projects/11241"><img src="https://www.bestpractices.dev/projects/11241/badge" alt="OpenSSF Best Practices" /></a>
  <a href="https://opensource.org/licenses/Apache-2.0"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="Apache 2.0 License" /></a>
  <a href="https://bsky.app/profile/arconia.io"><img src="https://img.shields.io/static/v1?label=Bluesky&message=Follow&color=1DA1F2" alt="Follow us on Bluesky" /></a>
</p>

---

## ✨&nbsp; Features

- **Developer Experience.** First-class support for development and testing modes in Spring Boot applications, making local development easier, more productive, and more fun. Includes Dev Services for automatic provisioning of external services using containers.
- **Generative AI.** Extended integration capabilities for Spring Boot applications, including AI observability and evaluation platforms, AI inference services, and AI document processors.
- **Kubernetes.** Simplified configuration and deployment of Spring Boot applications to Kubernetes, including multi-architecture container images, Service Binding specification support, and automatic generation of Kubernetes manifests.
- **Multitenancy.** Built-in support for multitenant applications, covering web, data, security, and configuration aspects.

### FAQ

**Arconia 稳定了吗？**
答：README 提到仍在积极开发中，朝首个稳定版本推进。

**模块与指南去哪看？**
答：README 给出了文档入口：arconia.io/docs/arconia/latest。

**核心收益是什么？**
答：提升 Spring Boot 的开发体验，并统一可观测性接入。

## 来源与感谢

> Source: https://github.com/arconia-io/arconia
> License: Apache-2.0
> GitHub stars: 142 · forks: 15


---
Source: https://tokrepo.com/en/workflows/arconia-spring-boot-add-on-for-dev-ux-observability
Author: AI Open Source