# @zio.dev/zio-lambda

> ZIO Lambda Documentation

Latest version **1.0.7** (published 2026-11-18) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @zio.dev/zio-lambda
pnpm add @zio.dev/zio-lambda
yarn add @zio.dev/zio-lambda
bun add @zio.dev/zio-lambda
```

## Health

**Score 60/100 (C)** — status: active.

Positive: no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 1.0.7 |
| Published | 2026-11-18 |
| First published | 2022-11-21 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 82.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 43 |
| Maintainers | zio.org |

## Links

- npm: https://www.npmjs.com/package/@zio.dev/zio-lambda
- Repository: https://github.com/zio/zio-lambda
- Homepage: https://github.com/zio/zio-lambda#readme
- Issues: https://github.com/zio/zio-lambda/issues
- npm.io page: https://npm.io/package/@zio.dev/zio-lambda

## Recent versions

- 1.0.7 (latest) — 2026-11-18
- 1.0.5 — 2024-10-08
- 1.0.4 — 2023-06-09
- 1.0.3 — 2023-04-11
- 1.0.2 — 2023-03-08
- 1.0.1 — 2023-01-26
- 1.0.0 — 2023-01-17
- 1.0.0-RC8 — 2022-12-12
- 1.0.0-RC7 — 2022-11-28
- 1.0.0-RC6 — 2022-11-21

## README

[//]: # (This file was autogenerated using `zio-sbt-website` plugin via `sbt generateReadme` command.)
[//]: # (So please do not edit it manually. Instead, change "docs/index.md" file or sbt setting keys)
[//]: # (e.g. "readmeDocumentation" and "readmeSupport".)

# ZIO Lambda

ZIO Lambda is a ZIO-based AWS Custom Runtime compatible with GraalVM Native Image. It lets you write an AWS Lambda function as a ZIO program, with typed JSON events in and typed JSON responses out, and deploy it as a GraalVM native binary.

[![Development](https://img.shields.io/badge/Project%20Stage-Development-green.svg)](https://github.com/zio/zio/wiki/Project-Stages) ![CI Badge](https://github.com/zio/zio-lambda/workflows/CI/badge.svg) [![Sonatype Releases](https://img.shields.io/maven-central/v/dev.zio/zio-lambda_2.13.svg?label=Sonatype%20Release)](https://central.sonatype.com/artifact/dev.zio/zio-lambda_2.13) [![Sonatype Snapshots](https://img.shields.io/maven-metadata/v?metadataUrl=https%3A%2F%2Fcentral.sonatype.com%2Frepository%2Fmaven-snapshots%2Fdev%2Fzio%2Fzio-lambda_2.13%2Fmaven-metadata.xml&label=Sonatype%20Snapshot)](https://central.sonatype.com/repository/maven-snapshots/dev/zio/zio-lambda_2.13/) [![javadoc](https://javadoc.io/badge2/dev.zio/zio-lambda_2.13/javadoc.svg)](https://javadoc.io/doc/dev.zio/zio-lambda_2.13) [![ZIO Lambda](https://img.shields.io/github/stars/zio/zio-lambda?style=social)](https://github.com/zio/zio-lambda)

## Installation

To add ZIO Lambda to an sbt project, declare the core module and, optionally, the event and response modules:

```sbt
libraryDependencies += "dev.zio" %% "zio-lambda" % "1.0.6"

// Optional dependencies
libraryDependencies += "dev.zio" %% "zio-lambda-event"    % "1.0.6"
libraryDependencies += "dev.zio" %% "zio-lambda-response" % "1.0.6"
```

The core module depends on [zio-json](https://github.com/zio/zio-json), so you do not need to declare it yourself. ZIO Lambda uses zio-json to decode the incoming event and to encode the response.

The `zio-lambda-event` module contains Scala types for the events that AWS services send to Lambda, such as API Gateway requests and SQS batches. The `zio-lambda-response` module contains Scala types for the responses that some AWS integrations expect, such as the API Gateway proxy response.

## Where to Go Next

The guides in this section follow the order in which you would build a function:

1. [Getting Started](docs/./getting-started.md) shows how to write a handler with custom event and response types.
2. [Event and Response Types](docs/./event-and-response-types.md) lists the AWS event and response types that the optional modules provide.
3. [Testing Locally](docs/./testing-locally.md) shows how to call a handler from a test without deploying it.
4. [Deployment](docs/./deployment.md) explains how to package a native binary and deploy it to AWS Lambda, directly or in a container image.

## Documentation

Learn more on the [ZIO Lambda homepage](https://zio.dev/zio-lambda/)!

## Contributing

For the general guidelines, see ZIO [contributor's guide](https://zio.dev/contributor-guidelines).

## Code of Conduct

See the [Code of Conduct](https://zio.dev/code-of-conduct)

## Support

Come chat with us on [![Badge-Discord]][Link-Discord].

[Badge-Discord]: https://img.shields.io/discord/629491597070827530?logo=discord "chat on discord"
[Link-Discord]: https://discord.gg/2ccFBr4 "Discord"

## License

[License](LICENSE)

---
_Source: https://npm.io/package/@zio.dev/zio-lambda · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
