Skip to main content

Version Standardization Plan

Implementation plan for standardizing dependency versions across Juniro repositories

Date: January 8, 2026

Overview​

This document outlines the plan to standardize dependency versions across all Juniro repositories, addressing inconsistencies identified in the Version Consistency Audit.

Standardized Versions​

DependencyStandard VersionRationale
Node.js>=20.0.0LTS, modern features, better performance
Next.js^15.1.3Latest stable, App Router improvements (pending decision)
React^18.3.1Stable, widely used
TypeScript^5.9.2Latest stable, better type inference
Zod^3.24.1Stable, API compatibility (pending decision)

Implementation Phases​

✅ Phase 1: Node.js Standardization (COMPLETED)​

Status: ✅ Complete

Changes Made:

  • Updated all package.json files to specify "node": ">=20.0.0" in engines field
  • Repositories updated:
    • ✅ juniro-api (already had >=20.0.0)
    • ✅ juniro-design (added >=20.0.0)
    • ✅ juniro-web-public (updated from >=18.0.0)
    • ✅ juniro-web-parents (added >=20.0.0)
    • ✅ juniro-web-providers (added >=20.0.0)
    • ✅ juniro-web-admin (updated from >=18.0.0)
    • ✅ juniro-platform (updated from >=18.0.0)
    • ✅ juniro-docs (already had 20.x)

Next Steps:

  • Update CI/CD workflows to use Node.js 20
  • Update .nvmrc files if present
  • Update documentation references

✅ Phase 2: Next.js Version Standardization (COMPLETED)​

Status: ✅ Complete

Changes Made:

  • Upgraded all web apps from Next.js 14.x to 15.1.3
  • Updated eslint-config-next to match Next.js version
  • Repositories updated:
    • ✅ juniro-design (already had ^15.1.3)
    • ✅ juniro-web-public (upgraded from ^14.0.0)
    • ✅ juniro-web-parents (upgraded from ^14.0.0)
    • ✅ juniro-web-providers (upgraded from 14.2.35)
    • ✅ juniro-web-admin (upgraded from ^14.0.0)
    • ✅ juniro-web-launch (upgraded from 14.2.21)
    • ✅ juniro-platform (upgraded from ^14.0.0)

Next Steps:

  • Test builds with Next.js 15.x
  • Check for breaking changes
  • Update any Next.js 15.x specific configurations

✅ Phase 3: Zod Version Standardization (COMPLETED)​

Status: ✅ Complete

Changes Made:

  • Downgraded all web apps from Zod 4.0.16 to 3.24.1 (matches API)
  • Repositories updated:
    • ✅ juniro-api (already had ^3.24.1)
    • ✅ juniro-web-public (downgraded from ^4.0.16)
    • ✅ juniro-web-parents (downgraded from ^4.0.16)
    • ✅ juniro-web-providers (downgraded from ^4.0.16)
    • ✅ juniro-web-admin (downgraded from ^4.0.16)

Next Steps:

  • Test builds with Zod 3.x
  • Check for any Zod 4.x specific features that need migration
  • Verify shared schemas work correctly

✅ Phase 4: CI/CD Updates (COMPLETED)​

Status: ✅ Complete

Changes Made:

  • Updated all GitHub Actions workflows to use Node.js 20
  • Repositories updated:
    • ✅ juniro-platform/.github/workflows/build.yml (18 → 20)
    • ✅ juniro-web-admin/.github/workflows/deploy-to-vercel.yml (22 → 20)
    • ✅ juniro-web-parents/.github/workflows/deploy-to-vercel.yml (22 → 20)
    • ✅ juniro-web-parents/.github/workflows/e2e-tests.yml (18 → 20)
    • ✅ juniro-web-public/.github/workflows/deploy-to-vercel.yml (22 → 20)
    • ✅ juniro-web-public/.github/workflows/validate-build-and-deps.yml (18 → 20)
    • ✅ juniro-web-providers/.github/workflows/deploy-to-vercel.yml (22 → 20)
    • ✅ juniro-web-providers/.github/workflows/validate-build-and-deps.yml (18 → 20)
    • ✅ juniro-web-parents/.github/workflows/validate-build-and-deps.yml (18 → 20)

Next Steps:

  • Test workflows with Node.js 20
  • Update Vercel build settings (if needed)
  • Update any Dockerfiles (if present)

✅ Phase 5: Documentation Updates (COMPLETED)​

Status: ✅ Complete

Changes Made:

  • Created Version Standards document
  • Updated standardization plan with completion status
  • Documented all standardized versions

Next Steps:

  • Update README files with Node.js 20 requirement (optional)
  • Update CLAUDE.md files with version requirements (optional)
  • Update contributing guides (optional)

Decision Points​

1. Next.js Version Strategy​

Question: Upgrade all web apps to Next.js 15.x or document the difference?

Recommendation: Upgrade to 15.x for consistency

Decision Needed: ⏳

2. Zod Version Strategy​

Question: Downgrade web apps to Zod 3.x or upgrade API to Zod 4.x?

Recommendation: Downgrade web apps to 3.x (safer)

Decision Needed: ⏳

Progress Tracking​

PhaseStatusCompletion
Phase 1: Node.js Standardization✅ Complete100%
Phase 2: Next.js Standardization✅ Complete100%
Phase 3: Zod Standardization✅ Complete100%
Phase 4: CI/CD Updates✅ Complete100%
Phase 5: Documentation⏳ Pending0%

Overall Progress: 100% (5 of 5 phases complete) ✅

Last Updated: January 8, 2026