Francy51/Neon-Desk
2
0
Fork 0
Code Issues 22 Pull Requests Actions Packages Projects Releases Wiki Activity
Files
73282c71afe6438b2b824253453a90516f86bf4b
Neon-Desk/DEPENDENCY_UPDATES.md
Francesco 73282c71af docs: Document npm update and Tailwind v4 PostCSS fixes 
- Add Build System Updates section documenting npm version update
- Document Tailwind CSS v4 PostCSS configuration changes
- Update Last Updated timestamp
2026-02-20 04:06:47 +00:00

5.0 KiB
Raw Blame History

Dependency Updates Summary

Generated: 2026-02-19 Last Updated: 2026-02-20

Build System Updates (2026-02-20)

npm Version Update:

  • Backend Dockerfile: Updated to install npm@latest globally during build
    • Previous: npm 10.8.2 (bundled with Node 20)
    • Updated: npm 11.10.1
    • Change: Added npm install -g npm@latest after bun installation
    • Benefit: Latest npm features, bug fixes, and security updates

Tailwind CSS v4 Compatibility Fixes:

  • Frontend PostCSS Configuration: Updated to use new Tailwind v4 plugin
    • Previous: tailwindcss: {} in postcss.config.js
    • Updated: '@tailwindcss/postcss': {} in postcss.config.js
    • Added: @tailwindcss/postcss: ^4.0.0 to devDependencies
    • Fixes: Build error "The PostCSS plugin has moved to a separate package"
    • Compatibility: Tailwind CSS v4.2.0

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:

  1. 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:

  1. react: 19.1.0 → 19.2.4

    • Patch update, should be compatible

  2. 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.
    • FIXED (2026-02-20): Updated postcss.config.js to use @tailwindcss/postcss plugin instead of tailwindcss directly. Added @tailwindcss/postcss: ^4.0.0 to devDependencies.

Medium Priority:

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

Low Priority:

  1. @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.

Reference in New Issue View Git Blame Copy Permalink