Neon-Desk/DEPENDENCY_UPDATES.md

Dependency Updates Summary

Generated: 2026-02-19

Backend Dependencies Updates

MAJOR VERSION UPDATES:

1. zod: 3.24.1 → 4.3.6

   • Major version bump
   • Potential breaking changes in validation API

2. bcryptjs: 2.4.3 → 3.0.3

   • Major version bump
   • Potential breaking changes in hashing API

3. @types/bcryptjs: 2.4.6 → 3.0.0

   • TypeScript types update to match bcryptjs v3

MINOR/PATCH UPDATES:

4. jsonwebtoken: 9.0.2 → 9.0.3
   • Patch update, should be compatible

ALREADY UP-TO-DATE:

• @elysiajs/cors: 1.4.1 ✓
• @elysiajs/swagger: 1.3.1 ✓
• elysia: 1.4.25 ✓
• pg: 8.18.0 ✓
• postgres: 3.4.8 ✓
• dotenv: 17.3.1 ✓
• @types/pg: 8.16.0 ✓
• @types/jsonwebtoken: 9.0.10 ✓

---

Frontend Dependencies Updates

MAJOR VERSION UPDATES:

1. next-auth: 5.0.0-beta.25 → 5.0.0-beta.30

   • Updated to latest v5 beta (not downgraded to v4)
   • Maintains feature set, gets bug fixes
   • Decision: Keep on v5 beta as it's the future version

2. recharts: 2.15.4 → 3.7.0

   • Major version bump
   • Potential breaking changes in chart components

3. tailwind-merge: 2.6.1 → 3.5.0

   • Major version bump
   • Potential breaking changes in class merging logic

4. @types/node: 22.12.0 → 25.3.0

   • Major version bump
   • Updated TypeScript definitions for Node.js

5. tailwindcss: 3.4.19 → 4.2.0

   • Major version bump
   • Tailwind CSS v4 has significant changes to configuration and API
   • May require updating tailwind.config.js configuration

MINOR/PATCH UPDATES:

6. react: 19.1.0 → 19.2.4

   • Patch update, should be compatible

7. react-dom: 19.1.0 → 19.2.4

   • Patch update, should be compatible

ALREADY UP-TO-DATE:

• next: 16.1.6 ✓
• lucide-react: 0.574.0 ✓
• date-fns: 4.1.0 ✓
• @radix-ui/react-dialog: 1.1.15 ✓
• @radix-ui/react-dropdown-menu: 2.1.16 ✓
• @radix-ui/react-slot: 1.2.4 ✓
• @radix-ui/react-tabs: 1.1.13 ✓
• @radix-ui/react-toast: 1.2.15 ✓
• class-variance-authority: 0.7.1 ✓
• clsx: 2.1.1 ✓
• typescript: 5.9.3 ✓
• postcss: 8.5.6 ✓
• autoprefixer: 10.4.24 ✓
• @types/react: 19.2.14 ✓
• @types/react-dom: 19.2.3 ✓

---

Known Compatibility Issues & Recommendations

High Priority:

1. tailwindcss v4: This is a major update with significant changes. The project's configuration files (tailwind.config.js, postcss.config.js) may need updates. Note: Tailwind v4 is designed to be backward compatible with v3 configs in most cases.

Medium Priority:

2. zod v4: Check if validation schemas need updates.
3. bcryptjs v3: Check if password hashing/verification code needs updates.
4. recharts v3: Chart components may need updates to match new API.

Low Priority:

5. @types/node v25: Usually compatible, but check for any Node.js API changes.

---

Testing Checklist

After updating dependencies:

• Run npm install in both backend and frontend
• Run npm run build in frontend
• Test authentication flow (next-auth)
• Test API endpoints
• Test database connections
• Test all UI components and charts
• Run any existing tests
• Check console for deprecation warnings
• Test Docker build (docker-compose build)

---

Rollback Plan

If issues arise after updates:

1. Revert package.json changes
2. Run npm install to restore previous versions
3. Commit and push revert

To revert: git checkout HEAD~1 (if committed) Or restore from backup: cp package.json.backup package.json

---

Summary

Total dependencies updated:

• Backend: 3 dependencies (1 major, 1 patch, 1 type update)
• Frontend: 7 dependencies (5 major, 2 patch)

Changes committed: Yes (commit 1573e07) Changes pushed to remote: Yes

Next steps:

1. Pull latest changes: git pull
2. Install dependencies in both directories:
   • Backend: cd backend && bun install (or npm install)
   • Frontend: cd frontend && npm install
3. Test build: npm run build (frontend)
4. Run the testing checklist above
5. Monitor for deprecation warnings or errors

If issues occur: Refer to rollback plan above or reach out for assistance.