README
NATS Architecture And Design
This repository captures Architecture, Design Specifications and Feature Guidance for the NATS ecosystem.
2.11
| Index | Tags | Description |
|---|---|---|
| ADR-31 | jetstream, client, server, 2.11 | JetStream Direct Get |
| ADR-41 | observability, server, 2.11 | NATS Message Path Tracing |
| ADR-42 | jetstream, server, 2.11 | Pull Consumer Priority Groups |
| ADR-43 | jetstream, client, server, 2.11 | JetStream Per-Message TTL |
| ADR-44 | jetstream, server, 2.11, 2.12 | Versioning for JetStream Assets |
| ADR-48 | jetstream, client, kv, refinement, 2.11 | TTL Support for Key-Value Buckets (updating ADR-8) |
2.12
| Index | Tags | Description |
|---|---|---|
| ADR-44 | jetstream, server, 2.11, 2.12 | Versioning for JetStream Assets |
| ADR-49 | jetstream, spec, 2.12 | JetStream Distributed Counter CRDT |
| ADR-50 | jetstream, server, client, 2.12, 2.14 | JetStream Batch Publishing |
| ADR-51 | jetstream, 2.12, 2.14 | JetStream Message Scheduler |
| ADR-55 | server, 2.12 | Trusted Protocol Aware Proxies |
| ADR-56 | server, 2.12 | JetStream Consistency Models |
2.14
| Index | Tags | Description |
|---|---|---|
| ADR-50 | jetstream, server, client, 2.12, 2.14 | JetStream Batch Publishing |
| ADR-51 | jetstream, 2.12, 2.14 | JetStream Message Scheduler |
| ADR-60 | jetstream, client, server, 2.14, refinement | JetStream reliable stream sourcing/mirroring on WQ/Interest streams (updating ADR-59) |
2.15
| Index | Tags | Description |
|---|---|---|
| ADR-61 | server, jetstream, 2.15 | Unsafe meta group quorum rescue for disaster recovery |
| ADR-62 | server, jetstream, 2.15 | JetStream desired state reconciliation |
| ADR-63 | jetstream, server, client, 2.15 | JetStream Stream Backup and Restore V2 |
Client
| Index | Tags | Description |
|---|---|---|
| ADR-1 | jetstream, client, server | JetStream JSON API Design |
| ADR-2 | jetstream, server, client | NATS Typed Messages |
| ADR-4 | server, client | NATS Message Headers |
| ADR-5 | server, client | Lame Duck Notification |
| ADR-6 | server, client | Naming Rules |
| ADR-7 | server, client, jetstream | NATS Server Error Codes |
| ADR-8 | jetstream, client, kv, spec | JetStream based Key-Value Stores |
| ADR-9 | server, client, jetstream | JetStream Consumer Idle Heartbeats |
| ADR-10 | server, client, jetstream | JetStream Extended Purge |
| ADR-11 | client | Hostname resolution |
| ADR-13 | jetstream, client | Pull Subscribe internals |
| ADR-14 | client, security | JWT library free jwt user generation |
| ADR-17 | jetstream, client | Ordered Consumer |
| ADR-19 | jetstream, client, kv, objectstore | API prefixes for materialized JetStream views |
| ADR-20 | jetstream, client, objectstore, spec | JetStream based Object Stores |
| ADR-21 | client | NATS Configuration Contexts |
| ADR-22 | jetstream, client | JetStream Publish Retries on No Responders |
| ADR-31 | jetstream, client, server, 2.11 | JetStream Direct Get |
| ADR-32 | client, spec | Service API |
| ADR-33 | jetstream, client, server | Metadata for Stream and Consumer |
| ADR-34 | jetstream, client, server | JetStream Consumers Multiple Filters |
| ADR-35 | jetstream, client, server | JetStream Filestore Compression |
| ADR-36 | jetstream, client, server | Subject Mapping Transforms in Streams |
| ADR-37 | jetstream, client, spec | JetStream Simplification |
| ADR-40 | client, server, spec | NATS Connection |
| ADR-43 | jetstream, client, server, 2.11 | JetStream Per-Message TTL |
| ADR-47 | client, spec, orbit | Request Many |
| ADR-48 | jetstream, client, kv, refinement, 2.11 | TTL Support for Key-Value Buckets (updating ADR-8) |
| ADR-50 | jetstream, server, client, 2.12, 2.14 | JetStream Batch Publishing |
| ADR-54 | jetstream, client, spec, orbit, kv, refinement | KV Codecs (updating ADR-8) |
| ADR-57 | jetstream, client, spec, kv, refinement | KV Subject Transforms (updating ADR-8) |
| ADR-58 | jetstream, client, kv | Key-Value Store Roadmap and future considerations (updating ADR-8) |
| ADR-60 | jetstream, client, server, 2.14, refinement | JetStream reliable stream sourcing/mirroring on WQ/Interest streams (updating ADR-59) |
| ADR-63 | jetstream, server, client, 2.15 | JetStream Stream Backup and Restore V2 |
Jetstream
| Index | Tags | Description |
|---|---|---|
| ADR-1 | jetstream, client, server | JetStream JSON API Design |
| ADR-2 | jetstream, server, client | NATS Typed Messages |
| ADR-7 | server, client, jetstream | NATS Server Error Codes |
| ADR-8 | jetstream, client, kv, spec | JetStream based Key-Value Stores |
| ADR-9 | server, client, jetstream | JetStream Consumer Idle Heartbeats |
| ADR-10 | server, client, jetstream | JetStream Extended Purge |
| ADR-12 | jetstream | JetStream Encryption At Rest |
| ADR-13 | jetstream, client | Pull Subscribe internals |
| ADR-17 | jetstream, client | Ordered Consumer |
| ADR-19 | jetstream, client, kv, objectstore | API prefixes for materialized JetStream views |
| ADR-20 | jetstream, client, objectstore, spec | JetStream based Object Stores |
| ADR-22 | jetstream, client | JetStream Publish Retries on No Responders |
| ADR-28 | jetstream, server | JetStream RePublish |
| ADR-31 | jetstream, client, server, 2.11 | JetStream Direct Get |
| ADR-33 | jetstream, client, server | Metadata for Stream and Consumer |
| ADR-34 | jetstream, client, server | JetStream Consumers Multiple Filters |
| ADR-35 | jetstream, client, server | JetStream Filestore Compression |
| ADR-36 | jetstream, client, server | Subject Mapping Transforms in Streams |
| ADR-37 | jetstream, client, spec | JetStream Simplification |
| ADR-42 | jetstream, server, 2.11 | Pull Consumer Priority Groups |
| ADR-43 | jetstream, client, server, 2.11 | JetStream Per-Message TTL |
| ADR-44 | jetstream, server, 2.11, 2.12 | Versioning for JetStream Assets |
| ADR-48 | jetstream, client, kv, refinement, 2.11 | TTL Support for Key-Value Buckets (updating ADR-8) |
| ADR-49 | jetstream, spec, 2.12 | JetStream Distributed Counter CRDT |
| ADR-50 | jetstream, server, client, 2.12, 2.14 | JetStream Batch Publishing |
| ADR-51 | jetstream, 2.12, 2.14 | JetStream Message Scheduler |
| ADR-54 | jetstream, client, spec, orbit, kv, refinement | KV Codecs (updating ADR-8) |
| ADR-57 | jetstream, client, spec, kv, refinement | KV Subject Transforms (updating ADR-8) |
| ADR-58 | jetstream, client, kv | Key-Value Store Roadmap and future considerations (updating ADR-8) |
| ADR-59 | server, jetstream, spec | JetStream Stream Sourcing and Mirroring |
| ADR-60 | jetstream, client, server, 2.14, refinement | JetStream reliable stream sourcing/mirroring on WQ/Interest streams (updating ADR-59) |
| ADR-61 | server, jetstream, 2.15 | Unsafe meta group quorum rescue for disaster recovery |
| ADR-62 | server, jetstream, 2.15 | JetStream desired state reconciliation |
| ADR-63 | jetstream, server, client, 2.15 | JetStream Stream Backup and Restore V2 |
Kv
| Index | Tags | Description |
|---|---|---|
| ADR-8 | jetstream, client, kv, spec | JetStream based Key-Value Stores |
| ADR-19 | jetstream, client, kv, objectstore | API prefixes for materialized JetStream views |
| ADR-48 | jetstream, client, kv, refinement, 2.11 | TTL Support for Key-Value Buckets (updating ADR-8) |
| ADR-54 | jetstream, client, spec, orbit, kv, refinement | KV Codecs (updating ADR-8) |
| ADR-57 | jetstream, client, spec, kv, refinement | KV Subject Transforms (updating ADR-8) |
| ADR-58 | jetstream, client, kv | Key-Value Store Roadmap and future considerations (updating ADR-8) |
Objectstore
| Index | Tags | Description |
|---|---|---|
| ADR-19 | jetstream, client, kv, objectstore | API prefixes for materialized JetStream views |
| ADR-20 | jetstream, client, objectstore, spec | JetStream based Object Stores |
Observability
| Index | Tags | Description |
|---|---|---|
| ADR-3 | observability, server | NATS Service Latency Distributed Tracing Interoperability |
| ADR-41 | observability, server, 2.11 | NATS Message Path Tracing |
Orbit
| Index | Tags | Description |
|---|---|---|
| ADR-47 | client, spec, orbit | Request Many |
| ADR-54 | jetstream, client, spec, orbit, kv, refinement | KV Codecs (updating ADR-8) |
Refinement
| Index | Tags | Description |
|---|---|---|
| ADR-48 | jetstream, client, kv, refinement, 2.11 | TTL Support for Key-Value Buckets (updating ADR-8) |
| ADR-54 | jetstream, client, spec, orbit, kv, refinement | KV Codecs (updating ADR-8) |
| ADR-57 | jetstream, client, spec, kv, refinement | KV Subject Transforms (updating ADR-8) |
| ADR-60 | jetstream, client, server, 2.14, refinement | JetStream reliable stream sourcing/mirroring on WQ/Interest streams (updating ADR-59) |
Security
| Index | Tags | Description |
|---|---|---|
| ADR-14 | client, security | JWT library free jwt user generation |
| ADR-38 | server, security | OCSP Peer Verification |
| ADR-39 | server, security | Certificate Store |
Server
| Index | Tags | Description |
|---|---|---|
| ADR-1 | jetstream, client, server | JetStream JSON API Design |
| ADR-2 | jetstream, server, client | NATS Typed Messages |
| ADR-3 | observability, server | NATS Service Latency Distributed Tracing Interoperability |
| ADR-4 | server, client | NATS Message Headers |
| ADR-5 | server, client | Lame Duck Notification |
| ADR-6 | server, client | Naming Rules |
| ADR-7 | server, client, jetstream | NATS Server Error Codes |
| ADR-9 | server, client, jetstream | JetStream Consumer Idle Heartbeats |
| ADR-10 | server, client, jetstream | JetStream Extended Purge |
| ADR-26 | server | NATS Authorization Callouts |
| ADR-28 | jetstream, server | JetStream RePublish |
| ADR-30 | server | Subject Transform |
| ADR-31 | jetstream, client, server, 2.11 | JetStream Direct Get |
| ADR-33 | jetstream, client, server | Metadata for Stream and Consumer |
| ADR-34 | jetstream, client, server | JetStream Consumers Multiple Filters |
| ADR-35 | jetstream, client, server | JetStream Filestore Compression |
| ADR-36 | jetstream, client, server | Subject Mapping Transforms in Streams |
| ADR-38 | server, security | OCSP Peer Verification |
| ADR-39 | server, security | Certificate Store |
| ADR-40 | client, server, spec | NATS Connection |
| ADR-41 | observability, server, 2.11 | NATS Message Path Tracing |
| ADR-42 | jetstream, server, 2.11 | Pull Consumer Priority Groups |
| ADR-43 | jetstream, client, server, 2.11 | JetStream Per-Message TTL |
| ADR-44 | jetstream, server, 2.11, 2.12 | Versioning for JetStream Assets |
| ADR-50 | jetstream, server, client, 2.12, 2.14 | JetStream Batch Publishing |
| ADR-53 | server | Feature flags |
| ADR-55 | server, 2.12 | Trusted Protocol Aware Proxies |
| ADR-56 | server, 2.12 | JetStream Consistency Models |
| ADR-59 | server, jetstream, spec | JetStream Stream Sourcing and Mirroring |
| ADR-60 | jetstream, client, server, 2.14, refinement | JetStream reliable stream sourcing/mirroring on WQ/Interest streams (updating ADR-59) |
| ADR-61 | server, jetstream, 2.15 | Unsafe meta group quorum rescue for disaster recovery |
| ADR-62 | server, jetstream, 2.15 | JetStream desired state reconciliation |
| ADR-63 | jetstream, server, client, 2.15 | JetStream Stream Backup and Restore V2 |
Spec
| Index | Tags | Description |
|---|---|---|
| ADR-8 | jetstream, client, kv, spec | JetStream based Key-Value Stores |
| ADR-20 | jetstream, client, objectstore, spec | JetStream based Object Stores |
| ADR-32 | client, spec | Service API |
| ADR-37 | jetstream, client, spec | JetStream Simplification |
| ADR-40 | client, server, spec | NATS Connection |
| ADR-47 | client, spec, orbit | Request Many |
| ADR-49 | jetstream, spec, 2.12 | JetStream Distributed Counter CRDT |
| ADR-54 | jetstream, client, spec, orbit, kv, refinement | KV Codecs (updating ADR-8) |
| ADR-57 | jetstream, client, spec, kv, refinement | KV Subject Transforms (updating ADR-8) |
| ADR-59 | server, jetstream, spec | JetStream Stream Sourcing and Mirroring |
Deprecated
| Index | Tags | Description |
|---|---|---|
| ADR-15 | deprecated | JetStream Subscribe Workflow |
| ADR-18 | deprecated | URL support for all client options |
| ADR-52 | deprecated | No Headers support for Direct Get |
When to write an ADR
We use this repository in a few ways:
- Design specifications where a single document captures everything about a feature, examples are ADR-8, ADR-32, ADR-37 and ADR-40
- Guidance on conventions and design such as ADR-6 which documents all the valid naming rules
- Capturing design that might impact many areas of the system such as ADR-2
We want to move away from using these to document individual minor decisions, moving instead to spec like documents that are living documents and can change over time. Each capturing revisions and history.
Template
Please see the template. The template body is a guideline. Feel free to add sections as you feel appropriate. Look at the other ADRs for examples. However, the initial Table of metadata and header format is required to match.
After editing / adding a ADR please run go run main.go > README.md to update the embedded index. This will also validate the header part of your ADR.
Significant stargazers
Feng Lee
429 followers · starred Jun 2026
Karl Skewes
14 followers · starred Feb 2024
Sandro Martini
19 followers · starred Feb 2024
John Taylor
62 followers · starred Nov 2025
Similar repos
Languages
Go
80.6%
templ
19.4%
README
NATS Architecture And Design
This repository captures Architecture, Design Specifications and Feature Guidance for the NATS ecosystem.
2.11
| Index | Tags | Description |
|---|---|---|
| ADR-31 | jetstream, client, server, 2.11 | JetStream Direct Get |
| ADR-41 | observability, server, 2.11 | NATS Message Path Tracing |
| ADR-42 | jetstream, server, 2.11 | Pull Consumer Priority Groups |
| ADR-43 | jetstream, client, server, 2.11 | JetStream Per-Message TTL |
| ADR-44 | jetstream, server, 2.11, 2.12 | Versioning for JetStream Assets |
| ADR-48 | jetstream, client, kv, refinement, 2.11 | TTL Support for Key-Value Buckets (updating ADR-8) |
2.12
| Index | Tags | Description |
|---|---|---|
| ADR-44 | jetstream, server, 2.11, 2.12 | Versioning for JetStream Assets |
| ADR-49 | jetstream, spec, 2.12 | JetStream Distributed Counter CRDT |
| ADR-50 | jetstream, server, client, 2.12, 2.14 | JetStream Batch Publishing |
| ADR-51 | jetstream, 2.12, 2.14 | JetStream Message Scheduler |
| ADR-55 | server, 2.12 | Trusted Protocol Aware Proxies |
| ADR-56 | server, 2.12 | JetStream Consistency Models |
2.14
| Index | Tags | Description |
|---|---|---|
| ADR-50 | jetstream, server, client, 2.12, 2.14 | JetStream Batch Publishing |
| ADR-51 | jetstream, 2.12, 2.14 | JetStream Message Scheduler |
| ADR-60 | jetstream, client, server, 2.14, refinement | JetStream reliable stream sourcing/mirroring on WQ/Interest streams (updating ADR-59) |
2.15
| Index | Tags | Description |
|---|---|---|
| ADR-61 | server, jetstream, 2.15 | Unsafe meta group quorum rescue for disaster recovery |
| ADR-62 | server, jetstream, 2.15 | JetStream desired state reconciliation |
| ADR-63 | jetstream, server, client, 2.15 | JetStream Stream Backup and Restore V2 |
Client
| Index | Tags | Description |
|---|---|---|
| ADR-1 | jetstream, client, server | JetStream JSON API Design |
| ADR-2 | jetstream, server, client | NATS Typed Messages |
| ADR-4 | server, client | NATS Message Headers |
| ADR-5 | server, client | Lame Duck Notification |
| ADR-6 | server, client | Naming Rules |
| ADR-7 | server, client, jetstream | NATS Server Error Codes |
| ADR-8 | jetstream, client, kv, spec | JetStream based Key-Value Stores |
| ADR-9 | server, client, jetstream | JetStream Consumer Idle Heartbeats |
| ADR-10 | server, client, jetstream | JetStream Extended Purge |
| ADR-11 | client | Hostname resolution |
| ADR-13 | jetstream, client | Pull Subscribe internals |
| ADR-14 | client, security | JWT library free jwt user generation |
| ADR-17 | jetstream, client | Ordered Consumer |
| ADR-19 | jetstream, client, kv, objectstore | API prefixes for materialized JetStream views |
| ADR-20 | jetstream, client, objectstore, spec | JetStream based Object Stores |
| ADR-21 | client | NATS Configuration Contexts |
| ADR-22 | jetstream, client | JetStream Publish Retries on No Responders |
| ADR-31 | jetstream, client, server, 2.11 | JetStream Direct Get |
| ADR-32 | client, spec | Service API |
| ADR-33 | jetstream, client, server | Metadata for Stream and Consumer |
| ADR-34 | jetstream, client, server | JetStream Consumers Multiple Filters |
| ADR-35 | jetstream, client, server | JetStream Filestore Compression |
| ADR-36 | jetstream, client, server | Subject Mapping Transforms in Streams |
| ADR-37 | jetstream, client, spec | JetStream Simplification |
| ADR-40 | client, server, spec | NATS Connection |
| ADR-43 | jetstream, client, server, 2.11 | JetStream Per-Message TTL |
| ADR-47 | client, spec, orbit | Request Many |
| ADR-48 | jetstream, client, kv, refinement, 2.11 | TTL Support for Key-Value Buckets (updating ADR-8) |
| ADR-50 | jetstream, server, client, 2.12, 2.14 | JetStream Batch Publishing |
| ADR-54 | jetstream, client, spec, orbit, kv, refinement | KV Codecs (updating ADR-8) |
| ADR-57 | jetstream, client, spec, kv, refinement | KV Subject Transforms (updating ADR-8) |
| ADR-58 | jetstream, client, kv | Key-Value Store Roadmap and future considerations (updating ADR-8) |
| ADR-60 | jetstream, client, server, 2.14, refinement | JetStream reliable stream sourcing/mirroring on WQ/Interest streams (updating ADR-59) |
| ADR-63 | jetstream, server, client, 2.15 | JetStream Stream Backup and Restore V2 |
Jetstream
| Index | Tags | Description |
|---|---|---|
| ADR-1 | jetstream, client, server | JetStream JSON API Design |
| ADR-2 | jetstream, server, client | NATS Typed Messages |
| ADR-7 | server, client, jetstream | NATS Server Error Codes |
| ADR-8 | jetstream, client, kv, spec | JetStream based Key-Value Stores |
| ADR-9 | server, client, jetstream | JetStream Consumer Idle Heartbeats |
| ADR-10 | server, client, jetstream | JetStream Extended Purge |
| ADR-12 | jetstream | JetStream Encryption At Rest |
| ADR-13 | jetstream, client | Pull Subscribe internals |
| ADR-17 | jetstream, client | Ordered Consumer |
| ADR-19 | jetstream, client, kv, objectstore | API prefixes for materialized JetStream views |
| ADR-20 | jetstream, client, objectstore, spec | JetStream based Object Stores |
| ADR-22 | jetstream, client | JetStream Publish Retries on No Responders |
| ADR-28 | jetstream, server | JetStream RePublish |
| ADR-31 | jetstream, client, server, 2.11 | JetStream Direct Get |
| ADR-33 | jetstream, client, server | Metadata for Stream and Consumer |
| ADR-34 | jetstream, client, server | JetStream Consumers Multiple Filters |
| ADR-35 | jetstream, client, server | JetStream Filestore Compression |
| ADR-36 | jetstream, client, server | Subject Mapping Transforms in Streams |
| ADR-37 | jetstream, client, spec | JetStream Simplification |
| ADR-42 | jetstream, server, 2.11 | Pull Consumer Priority Groups |
| ADR-43 | jetstream, client, server, 2.11 | JetStream Per-Message TTL |
| ADR-44 | jetstream, server, 2.11, 2.12 | Versioning for JetStream Assets |
| ADR-48 | jetstream, client, kv, refinement, 2.11 | TTL Support for Key-Value Buckets (updating ADR-8) |
| ADR-49 | jetstream, spec, 2.12 | JetStream Distributed Counter CRDT |
| ADR-50 | jetstream, server, client, 2.12, 2.14 | JetStream Batch Publishing |
| ADR-51 | jetstream, 2.12, 2.14 | JetStream Message Scheduler |
| ADR-54 | jetstream, client, spec, orbit, kv, refinement | KV Codecs (updating ADR-8) |
| ADR-57 | jetstream, client, spec, kv, refinement | KV Subject Transforms (updating ADR-8) |
| ADR-58 | jetstream, client, kv | Key-Value Store Roadmap and future considerations (updating ADR-8) |
| ADR-59 | server, jetstream, spec | JetStream Stream Sourcing and Mirroring |
| ADR-60 | jetstream, client, server, 2.14, refinement | JetStream reliable stream sourcing/mirroring on WQ/Interest streams (updating ADR-59) |
| ADR-61 | server, jetstream, 2.15 | Unsafe meta group quorum rescue for disaster recovery |
| ADR-62 | server, jetstream, 2.15 | JetStream desired state reconciliation |
| ADR-63 | jetstream, server, client, 2.15 | JetStream Stream Backup and Restore V2 |
Kv
| Index | Tags | Description |
|---|---|---|
| ADR-8 | jetstream, client, kv, spec | JetStream based Key-Value Stores |
| ADR-19 | jetstream, client, kv, objectstore | API prefixes for materialized JetStream views |
| ADR-48 | jetstream, client, kv, refinement, 2.11 | TTL Support for Key-Value Buckets (updating ADR-8) |
| ADR-54 | jetstream, client, spec, orbit, kv, refinement | KV Codecs (updating ADR-8) |
| ADR-57 | jetstream, client, spec, kv, refinement | KV Subject Transforms (updating ADR-8) |
| ADR-58 | jetstream, client, kv | Key-Value Store Roadmap and future considerations (updating ADR-8) |
Objectstore
| Index | Tags | Description |
|---|---|---|
| ADR-19 | jetstream, client, kv, objectstore | API prefixes for materialized JetStream views |
| ADR-20 | jetstream, client, objectstore, spec | JetStream based Object Stores |
Observability
| Index | Tags | Description |
|---|---|---|
| ADR-3 | observability, server | NATS Service Latency Distributed Tracing Interoperability |
| ADR-41 | observability, server, 2.11 | NATS Message Path Tracing |
Orbit
| Index | Tags | Description |
|---|---|---|
| ADR-47 | client, spec, orbit | Request Many |
| ADR-54 | jetstream, client, spec, orbit, kv, refinement | KV Codecs (updating ADR-8) |
Refinement
| Index | Tags | Description |
|---|---|---|
| ADR-48 | jetstream, client, kv, refinement, 2.11 | TTL Support for Key-Value Buckets (updating ADR-8) |
| ADR-54 | jetstream, client, spec, orbit, kv, refinement | KV Codecs (updating ADR-8) |
| ADR-57 | jetstream, client, spec, kv, refinement | KV Subject Transforms (updating ADR-8) |
| ADR-60 | jetstream, client, server, 2.14, refinement | JetStream reliable stream sourcing/mirroring on WQ/Interest streams (updating ADR-59) |
Security
| Index | Tags | Description |
|---|---|---|
| ADR-14 | client, security | JWT library free jwt user generation |
| ADR-38 | server, security | OCSP Peer Verification |
| ADR-39 | server, security | Certificate Store |
Server
| Index | Tags | Description |
|---|---|---|
| ADR-1 | jetstream, client, server | JetStream JSON API Design |
| ADR-2 | jetstream, server, client | NATS Typed Messages |
| ADR-3 | observability, server | NATS Service Latency Distributed Tracing Interoperability |
| ADR-4 | server, client | NATS Message Headers |
| ADR-5 | server, client | Lame Duck Notification |
| ADR-6 | server, client | Naming Rules |
| ADR-7 | server, client, jetstream | NATS Server Error Codes |
| ADR-9 | server, client, jetstream | JetStream Consumer Idle Heartbeats |
| ADR-10 | server, client, jetstream | JetStream Extended Purge |
| ADR-26 | server | NATS Authorization Callouts |
| ADR-28 | jetstream, server | JetStream RePublish |
| ADR-30 | server | Subject Transform |
| ADR-31 | jetstream, client, server, 2.11 | JetStream Direct Get |
| ADR-33 | jetstream, client, server | Metadata for Stream and Consumer |
| ADR-34 | jetstream, client, server | JetStream Consumers Multiple Filters |
| ADR-35 | jetstream, client, server | JetStream Filestore Compression |
| ADR-36 | jetstream, client, server | Subject Mapping Transforms in Streams |
| ADR-38 | server, security | OCSP Peer Verification |
| ADR-39 | server, security | Certificate Store |
| ADR-40 | client, server, spec | NATS Connection |
| ADR-41 | observability, server, 2.11 | NATS Message Path Tracing |
| ADR-42 | jetstream, server, 2.11 | Pull Consumer Priority Groups |
| ADR-43 | jetstream, client, server, 2.11 | JetStream Per-Message TTL |
| ADR-44 | jetstream, server, 2.11, 2.12 | Versioning for JetStream Assets |
| ADR-50 | jetstream, server, client, 2.12, 2.14 | JetStream Batch Publishing |
| ADR-53 | server | Feature flags |
| ADR-55 | server, 2.12 | Trusted Protocol Aware Proxies |
| ADR-56 | server, 2.12 | JetStream Consistency Models |
| ADR-59 | server, jetstream, spec | JetStream Stream Sourcing and Mirroring |
| ADR-60 | jetstream, client, server, 2.14, refinement | JetStream reliable stream sourcing/mirroring on WQ/Interest streams (updating ADR-59) |
| ADR-61 | server, jetstream, 2.15 | Unsafe meta group quorum rescue for disaster recovery |
| ADR-62 | server, jetstream, 2.15 | JetStream desired state reconciliation |
| ADR-63 | jetstream, server, client, 2.15 | JetStream Stream Backup and Restore V2 |
Spec
| Index | Tags | Description |
|---|---|---|
| ADR-8 | jetstream, client, kv, spec | JetStream based Key-Value Stores |
| ADR-20 | jetstream, client, objectstore, spec | JetStream based Object Stores |
| ADR-32 | client, spec | Service API |
| ADR-37 | jetstream, client, spec | JetStream Simplification |
| ADR-40 | client, server, spec | NATS Connection |
| ADR-47 | client, spec, orbit | Request Many |
| ADR-49 | jetstream, spec, 2.12 | JetStream Distributed Counter CRDT |
| ADR-54 | jetstream, client, spec, orbit, kv, refinement | KV Codecs (updating ADR-8) |
| ADR-57 | jetstream, client, spec, kv, refinement | KV Subject Transforms (updating ADR-8) |
| ADR-59 | server, jetstream, spec | JetStream Stream Sourcing and Mirroring |
Deprecated
| Index | Tags | Description |
|---|---|---|
| ADR-15 | deprecated | JetStream Subscribe Workflow |
| ADR-18 | deprecated | URL support for all client options |
| ADR-52 | deprecated | No Headers support for Direct Get |
When to write an ADR
We use this repository in a few ways:
- Design specifications where a single document captures everything about a feature, examples are ADR-8, ADR-32, ADR-37 and ADR-40
- Guidance on conventions and design such as ADR-6 which documents all the valid naming rules
- Capturing design that might impact many areas of the system such as ADR-2
We want to move away from using these to document individual minor decisions, moving instead to spec like documents that are living documents and can change over time. Each capturing revisions and history.
Template
Please see the template. The template body is a guideline. Feel free to add sections as you feel appropriate. Look at the other ADRs for examples. However, the initial Table of metadata and header format is required to match.
After editing / adding a ADR please run go run main.go > README.md to update the embedded index. This will also validate the header part of your ADR.
Similar repos
Significant stargazers
Feng Lee
429 followers · starred Jun 2026
Karl Skewes
14 followers · starred Feb 2024
Sandro Martini
19 followers · starred Feb 2024
John Taylor
62 followers · starred Nov 2025
Languages
Go
80.6%
templ
19.4%