airframe

[![Gitter Chat][gitter-badge]][gitter-link] [![CI Status][gha-badge]][gha-link] [![codecov](https://codecov.io/gh/wvlet/airframe/branch/main/graph/badge.svg)](https://codecov.io/gh/wvlet/airframe) [![scala-index][sindex-badge]][sindex-link] [![maven central][central-badge]][central-link] [![Scala.js](https://www.scala-js.org/assets/badges/scalajs-1.0.0.svg)](https://www.scala-js.org)

[circleci-badge]: https://circleci.com/gh/wvlet/airframe.svg?style=svg
[circleci-link]: https://circleci.com/gh/wvlet/airframe
[gha-badge]: https://github.com/wvlet/airframe/workflows/CI/badge.svg
[gha-link]: https://github.com/wvlet/airframe/actions?workflow=CI
[gitter-badge]: https://badges.gitter.im/Join%20Chat.svg
[gitter-link]: https://gitter.im/wvlet/airframe?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
[coverall-badge]: https://coveralls.io/repos/github/wvlet/airframe/badge.svg?branch=main
[coverall-link]: https://coveralls.io/github/wvlet/airframe?branch=main
[sindex-badge]: https://index.scala-lang.org/wvlet/airframe/airframe/latest.svg?color=orange
[sindex-link]: https://index.scala-lang.org/wvlet/airframe
[central-badge]: https://img.shields.io/maven-central/v/org.wvlet.airframe/airframe_2.12.svg?label=maven%20central
[central-link]: https://search.maven.org/search?q=g:%22org.wvlet.airframe%22%20AND%20a:%22airframe_2.12%22


<p>
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="logos/airframe-logo-dark.svg">
    <img src="logos/airframe-logo-light.svg" alt="Airframe" width="300px">
  </picture>
</p>

Airframe https://wvlet.org/airframe is essential building blocks for developing applications in Scala, including logging, object serialization using JSON or MessagePack, object wiring with lifecycle management (`airframe-di`), http server/client with RPC support, functional testing with AirSpec, etc. 

> [!TIP]
> **For new Scala 3 projects, use Uni.** [Uni](https://github.com/wvlet/uni) is the Scala 3 successor of Airframe, providing object wiring, logging, JSON/MessagePack codecs, and more. Airframe continues to be maintained for existing Scala 2 and Scala 3 users.
> [Uni documentation](https://wvlet.org/uni/) · [Airframe → Uni migration guide](https://wvlet.org/uni/guide/for-ai-agents#how-do-i-migrate-from-airframe) · [llms.txt](https://wvlet.org/uni/llms.txt)

## Resources

- [Airframe Home](https://wvlet.org/airframe/)
- [Documentation](https://wvlet.org/airframe/docs)
- [Release Notes](https://wvlet.org/airframe/docs/release-notes.html)

### Framework

- [Airframe DI: A Dependency Injection Library Tailored to Scala](https://wvlet.org/airframe/docs/airframe-di.html)
- [AirSpec: A Functional Testing Library](https://wvlet.org/airframe/docs/airspec.html)

- [Airframe RPC: A Framework for Using Scala Both for Frontend and Backend Programming](https://wvlet.org/airframe/docs/airframe-rpc.html)
<p><img src="https://github.com/wvlet/airframe/raw/main/website/static/img/airframe-rpc/rpc-overview.png" alt="rpc" wid