diff --git a/architecture.svg b/architecture.svg
new file mode 100644
index 0000000..3ed4140
--- /dev/null
+++ b/architecture.svg
@@ -0,0 +1,79 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="1200" height="200" viewBox="0 0 600 100" version="1.1" xmlns="http://www.w3.org/2000/svg">
+	<title>db-rest architecture</title>
+	<style>
+		.box {
+			fill: #f0f0f0;
+			stroke-width: 1px;
+			stroke: #777;
+		}
+		.arrow {
+			fill: none;
+			stroke-width: 1px;
+			stroke: #555;
+			stroke-linecap: square;
+		}
+		.monospace-text {
+			font-family: FiraCode-Retina, Fira Code, monospace;
+			font-size: 10px;
+			font-weight: 500;
+			fill: #000;
+		}
+		.normal-text {
+			font-family: HelveticaNeue-Light, Helvetica Neue, sans-serif;
+			font-size: 10px;
+			font-weight: 300;
+			fill: #000;
+		}
+		.small-text {
+			font-size: 8px;
+		}
+	</style>
+	<!-- <g transform="translate(16, 20)">
+		<rect class="box" x="0" y="0" width="70" height="20" />
+		<text class="monospace-text" x="7" y="14">db-client</text>
+	</g>
+	<g transform="translate(91, 16)">
+		<path class="arrow" d="M0,14 L66,14" />
+		<path class="arrow" d="M66,14 L55.7,11 L55.7,17 L66,14 Z" />
+		<text class="normal-text" x="11.35" y="10">queries</text>
+	</g> -->
+	<g transform="translate(164, 20)">
+		<rect class="box" x="0" y="0" width="100" height="41" />
+		<text class="monospace-text" x="26.2" y="13">db-rest</text>
+		<text class="normal-text small-text" x="4" y="26">deployed at</text>
+		<text class="monospace-text small-text" x="4" y="36">2.db.transport.rest</text>
+	</g>
+	<g transform="translate(269, 14)">
+		<path class="arrow" d="M0,14 L50,14" />
+		<path class="arrow" d="M50,14 L39.7,11 L39.7,17 L50,14 Z" />
+		<text class="normal-text" x="9.41" y="10">uses</text>
+	</g>
+	<g transform="translate(327, 20)">
+		<rect class="box" x="0" y="0" width="93" height="20" />
+		<text class="monospace-text" x="5" y="14">hafas-rest-api</text>
+	</g>
+	<g transform="translate(269, 39)">
+		<path class="arrow" d="M0,14 L50,14" />
+		<path class="arrow" d="M50,14 L39.7,11 L39.7,17 L50,14 Z" />
+		<text class="normal-text" x="1.445" y="10">exposes</text>
+	</g>
+	<g transform="translate(327, 45)">
+		<rect class="box" x="0" y="0" width="59" height="20" />
+		<text class="monospace-text" x="5" y="14">db-hafas</text>
+	</g>
+	<g transform="translate(425, 14)">
+		<path class="arrow" d="M0,14 L63,14" />
+		<path class="arrow" d="M63,14 L52.7,11 L52.7,17 L63,14 Z" />
+		<text class="normal-text" x="6.445" y="10">exposes</text>
+	</g>
+	<g transform="translate(391, 44)">
+		<text class="normal-text" x="38.465" y="10">extends</text>
+		<path class="arrow" d="M0,14 L114,14 L114,0" />
+		<path class="arrow" d="M114,0 L111,10.8 L117,10.8 L114,0 Z" />
+	</g>
+	<g transform="translate(494, 20)">
+		<rect class="box" x="0" y="0" width="81" height="20" />
+		<text class="monospace-text" x="5" y="14">hafas-client</text>
+	</g>
+</svg>
diff --git a/package.json b/package.json
index cd71537..63a161a 100644
--- a/package.json
+++ b/package.json
@@ -31,7 +31,7 @@
 		"db-hafas": "^2.0.0-alpha.2",
 		"db-stations": "^1.24.0",
 		"db-stations-autocomplete": "^1.0.0",
-		"hafas-rest-api": "0.1.0-alpha.2",
+		"hafas-rest-api": "0.1.0-alpha.10",
 		"hsts": "^2.1.0",
 		"ndjson": "^1.5.0",
 		"stream-filter": "^2.1.0"
diff --git a/readme.md b/readme.md
index d31771b..ed95a13 100644
--- a/readme.md
+++ b/readme.md
@@ -4,6 +4,8 @@
 
 [API Documentation](docs/index.md) | [Why?](docs/why.md)
 
+![db-rest architecture diagram](https://rawgit.com/derhuerst/db-rest/hafas-rest-api/architecture.svg)
+
 [![dependency status](https://img.shields.io/david/derhuerst/db-rest.svg)](https://david-dm.org/derhuerst/db-rest)
 ![ISC-licensed](https://img.shields.io/github/license/derhuerst/db-rest.svg)
 [![gitter channel](https://badges.gitter.im/derhuerst/db-rest.svg)](https://gitter.im/derhuerst/db-rest)