diff --git a/README.md b/README.md
index 82eac8a..e0916d5 100644
--- a/README.md
+++ b/README.md
@@ -10,6 +10,10 @@
   </p>
 </p>
 
+> [!IMPORTANT]
+> **Upgrading to v3?** Please read the [Migration Guide](MIGRATION_GUIDE.md) for breaking changes and upgrade instructions.
+
+
 ## 🚀 Quick Start
 
 ```bash
@@ -105,7 +109,7 @@ docker compose up -d
 #### Using Pre-built Image Directly
 
 ```bash
-docker pull ghcr.io/raylabshq/gitea-mirror:v2.20.1
+docker pull ghcr.io/raylabshq/gitea-mirror:v3.0.0
 ```
 
 ### Configuration Options
@@ -212,8 +216,11 @@ bun run build
 - Never stored in plaintext
 - Secure session management with JWT tokens
 
-### Migration
-If upgrading from a version without token encryption:
+### Upgrading to v3
+
+**Important**: If upgrading from v2.x to v3.0, please read the [Migration Guide](MIGRATION_GUIDE.md) for breaking changes and upgrade instructions.
+
+For quick token encryption migration:
 ```bash
 bun run migrate:encrypt-tokens
 ```
diff --git a/package.json b/package.json
index ca0fc82..2e4ec47 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "gitea-mirror",
   "type": "module",
-  "version": "2.22.0",
+  "version": "3.0.0",
   "engines": {
     "bun": ">=1.2.9"
   },
@@ -66,14 +66,14 @@
     "@types/canvas-confetti": "^1.9.0",
     "@types/react": "^19.1.8",
     "@types/react-dom": "^19.1.6",
-    "astro": "5.11.0",
+    "astro": "5.11.2",
     "bcryptjs": "^3.0.2",
     "better-auth": "^1.2.12",
     "canvas-confetti": "^1.9.3",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",
-    "drizzle-orm": "^0.44.2",
+    "drizzle-orm": "^0.44.3",
     "fuse.js": "^7.1.0",
     "jsonwebtoken": "^9.0.2",
     "lucide-react": "^0.525.0",
@@ -81,14 +81,14 @@
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
     "react-icons": "^5.5.0",
-    "sonner": "^2.0.5",
+    "sonner": "^2.0.6",
     "tailwind-merge": "^3.3.1",
     "tailwindcss": "^4.1.11",
     "tw-animate-css": "^1.3.5",
     "typescript": "^5.8.3",
     "uuid": "^11.1.0",
     "vaul": "^1.1.2",
-    "zod": "^3.25.75"
+    "zod": "^4.0.5"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.6.3",