diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..de946db
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,21 @@
+# WealthySmart
+
+Personal finance management web app.
+
+## Stack
+
+- **Frontend:** React 19 + Vite + TypeScript + Tailwind CSS 4
+- **Package manager:** pnpm
+
+## Development
+
+```bash
+cd frontend && pnpm install && pnpm run dev
+```
+
+## Deployment
+
+- Deployed via Gitea Actions (self-hosted runner on VPS)
+- Push to `main` triggers: GitHub → webhook → Gitea mirror sync → Actions workflow → Docker build & deploy
+- Domain: wealthy.cescalante.dev
+- Reverse proxy: nginx-proxy + acme-companion (auto TLS)