Project Maintenance & Update Plan

[scantarbian]

🔧 Project Maintenance & Update Plan

Status: 📋 Proposed
Created: 2026-04-23
Estimated Effort: 5 weeks

---

📊 Current Project State

Item	Value
Package Version	0.2.1
React Native	0.75.2
React	18.3.1
Yarn	3.6.1
Generated By	create-react-native-library v0.39.0

---

❌ Issues Found

🔴 Critical

1. Outdated GitHub Actions
   • actions/checkout@v3 → should be @v4
   • actions/setup-java@v3 → should be @v4
   • actions/cache@v3 → should be @v4
   • macOS runner macos-14 may need updating to macos-15

🟡 High Priority

1. Outdated Dependencies

   Package	Current	Recommended
   react-native	0.75.2	0.76+
   react	18.3.1	18.3.1+ / 19.x
   @commitlint/config-conventional	^17.0.2	^19.x
   commitlint	^17.0.2	^19.x
   release-it	^15.0.0	^17.x
   turbo	^1.10.7	^2.x
   eslint	^8.51.0	^9.x

2. Android Build Configuration

   • example/android/build.gradle uses fragile runtime path resolution
   • Missing explicit Android SDK/NDK version pins
   • Gradle wrapper version not explicitly specified

3. iOS Configuration

   • codegenConfig in package.json may need updating for React Native 0.76+
   • No Podfile.lock committed (build inconsistencies)

🟢 Medium/Low Priority

1. Code Quality

   • @ts-expect-error comment in src/index.tsx should be addressed
   • No JSDoc documentation on exported functions
   • Test coverage may need review

2. Documentation

   • README.md may need updating with latest usage examples
   • No CHANGELOG.md (relying on GitHub releases)

---

📅 Proposed Maintenance Timeline

Phase 1: Immediate Fixes (Week 1)

• Update GitHub Actions to latest versions
• Verify .nvmrc version pinning

Phase 2: Dependency Updates (Week 2)

• Update React Native from 0.75.2 → 0.76.x
• Update React peer dependencies
• Update all dev dependencies with security patches
• Run yarn dedupe to resolve duplicate dependencies

Phase 3: Platform Updates (Week 3)

• Update Android Gradle Plugin and Gradle wrapper
• Update iOS CocoaPods configuration
• Verify Turbo Module compatibility
• Test both old and new architecture builds

Phase 4: Code Quality (Week 4)

• Address TypeScript strictness issues
• Add JSDoc documentation
• Expand test coverage
• Enable additional ESLint rules

Phase 5: Documentation & Release (Week 5)

• Update README with examples
• Create CHANGELOG.md
• Bump version to 0.3.0
• Publish release

---

📋 Related Files

• .github/workflows/ci.yml - CI/CD configuration
• package.json - Main package configuration
• example/package.json - Example app dependencies
• example/android/build.gradle - Android build configuration
• example/ios/Podfile - iOS pod configuration
• react-native-zebra-linkos.podspec - iOS podspec
• src/index.tsx - Main TypeScript entry point
• src/@types/index.ts - Type definitions

---

Labels: maintenance, dependencies, ci-cd, documentation