diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..84e29cf
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,31 @@
+# Changelog
+
+## 1.0.0 — 2026-04-22
+
+Initial public release of the example scripts, aligned to the 1.0
+DongLoRa stack (`donglora` 1.0 / `donglora-mux` 1.0 /
+`donglora-protocol` 1.0).
+
+### Added
+
+- `_common.py`: the shared MeshCore US preset (910.525 MHz /
+  BW 62.5 / SF 7 / CR 4/5 / sync 0x1424 / 20 dBm) plus small helpers,
+  imported by every script so the scripts themselves stay short.
+- `explore.py`: print device capabilities then run one TX + RX
+  roundtrip. Useful as a first-run hardware sanity check.
+- `simple_rx.py`, `simple_tx.py`: minimal async receive / transmit
+  loops built against `donglora.Dongle`.
+- `ping_pong.py`: two-dongle ping-pong demo over LoRa.
+- `lora_bridge.py`: two-way LoRa bridge over TCP.
+
+### Removed
+
+- `all_commands.py`: indexed the old v0.1 command enum that no longer
+  exists after the Protocol v2 split.
+
+### Notes
+
+- Not published to PyPI. Run via `just <recipe>` or
+  `uv run --project . <script>` from the examples directory. Local
+  dev uses the `[tool.uv.sources]` editable path to `../client-py`;
+  the declared registry dep is `donglora>=1.0.0,<2.0.0`.
diff --git a/pyproject.toml b/pyproject.toml
index ef6a8d1..26979b8 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,16 +1,16 @@
 [project]
 name = "donglora-examples"
-version = "0.1.0"
+version = "1.0.0"
 description = "DongLoRa example scripts"
 license = "MIT"
 requires-python = ">=3.10"
 dependencies = [
-    "donglora",
+    "donglora>=1.0.0,<2.0.0",
 ]
 
 [project.optional-dependencies]
-meshcore = ["donglora[meshcore]"]
-orac = ["donglora[orac]"]
+meshcore = ["donglora[meshcore]>=1.0.0,<2.0.0"]
+orac = ["donglora[orac]>=1.0.0,<2.0.0"]
 
 [dependency-groups]
 dev = ["ruff"]
diff --git a/uv.lock b/uv.lock
index b46a8a5..9e478d0 100644
--- a/uv.lock
+++ b/uv.lock
@@ -169,7 +169,7 @@ wheels = [
 
 [[package]]
 name = "donglora"
-version = "0.2.0"
+version = "1.0.0"
 source = { editable = "../client-py" }
 dependencies = [
     { name = "cobs" },
@@ -208,7 +208,7 @@ dev = [
 
 [[package]]
 name = "donglora-examples"
-version = "0.1.0"
+version = "1.0.0"
 source = { virtual = "." }
 dependencies = [
     { name = "donglora" },