diff --git a/CLAUDE.md b/CLAUDE.md
index 879ed9e..1749a4b 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -76,3 +76,16 @@ Re-create the chart on theme change via `MutationObserver` on `data-theme` + `ma
 
 ### Toggle component
 Use `Toggle.svelte` (iOS-style) instead of raw `<input type="checkbox">` for user-facing boolean switches.
+
+## Versioning
+
+When committing, bump version numbers as appropriate using semver:
+
+- **patch** (x.y.Z): bug fixes, minor styling tweaks, small corrections
+- **minor** (x.Y.0): new features, significant UI changes, new pages/routes
+- **major** (X.0.0): breaking changes, major redesigns, data model changes
+
+Version files to update (keep in sync):
+- `package.json` — site version
+- `src-tauri/tauri.conf.json` — Tauri/Android app version
+- `src-tauri/Cargo.toml` — Rust crate version