Skip to content

3.1.0 (Jan 19, 2026)

Choose a tag to compare

View all tags
@Teczer Teczer released this 19 Jan 13:32
· 2 commits to main since this release
v3.1.0
e5932f0

🔧 Fast Expo App v3.1.0 - Stability & Dependency Fixes

🛠️ Patch Release - Critical Bug Fixes

This is a minor release focused on fixing critical dependency issues, navigation errors, and ensuring stable project generation. All version specifiers are now exact (no ^ or ~) for reproducible builds.

✨ What's Fixed

🔗 React Query Persistence (NEW Dependencies)

Added missing dependencies for proper React Query + MMKV persistence:

"@tanstack/react-query-persist-client": "5.90.7",
"@tanstack/query-sync-storage-persister": "5.90.7"

DevDependencies:

"@dev-plugins/react-native-mmkv": "0.4.0"

These are now mandatory since MMKV is always included. The QueryProvider now properly persists queries to MMKV storage with dev tools support.

🧭 Navigation Context Error Fix

Fixed: [Error: Couldn't find a LinkingContext context]

Updated @react-navigation/native and added missing peer dependencies:

"@react-navigation/native": "7.1.8",        // was 7.1.6
"@react-navigation/bottom-tabs": "7.4.0",   // NEW
"@react-navigation/elements": "2.6.3"       // NEW

This resolves the LinkingContext error that occurred with expo-router 6.0.14+.

💎 Unistyles v3 Compatibility

Updated to latest stable Unistyles v3:

"react-native-unistyles": "3.0.21"  // was 2.8.0

Fixed: Module manager now correctly sets the same version as the template, ensuring consistent builds.

📦 Expo SDK Updates

"expo": "54.0.31",           // was 54.0.23
"expo-linking": "8.0.11"     // was 8.0.8

🔒 Exact Version Pinning

All dependencies now use exact versions (no ^ or ~):

Dependency Before After
@tanstack/react-query ^5.90.7 5.90.7
react-native-unistyles ^3.0.18 3.0.21
react-native-worklets ^0.5.1 0.5.1
zustand ^5.0.2 5.0.2
expo-haptics ~14.0.0 14.0.0
react-native-edge-to-edge ^1.0.0 1.0.0
react-native-gesture-handler ~2.28.0 2.28.0
react-native-keyboard-controller ^1.18.5 1.18.5
expo-dev-client ~6.0.17 6.0.17

This ensures reproducible builds and prevents unexpected breaking changes from minor version updates.

🏗️ CLI Improvements

Module Manager Sync

The module-manager.ts now uses the same versions as the template package.json:

// Before: Version mismatch
deps['react-native-unistyles'] = '3.0.18'; // CLI
// template had 2.8.0

// After: Consistent versions
deps['react-native-unistyles'] = '3.0.21'; // Both match

Build Process

  • ✅ Templates are now copied with correct dependency versions
  • ✅ No more version conflicts between CLI and generated projects
  • ✅ Clean builds without peer dependency warnings

📋 Full Dependency Changes

Dependencies Added

"@tanstack/react-query-persist-client": "5.90.7",
"@tanstack/query-sync-storage-persister": "5.90.7",
"@react-navigation/bottom-tabs": "7.4.0",
"@react-navigation/elements": "2.6.3"

Dependencies Updated

"@react-navigation/native": "7.1.6" → "7.1.8",
"expo": "54.0.23" → "54.0.31",
"expo-linking": "8.0.8" → "8.0.11",
"react-native-unistyles": "2.8.0" → "3.0.21",
"@dev-plugins/react-native-mmkv": "0.0.3" → "0.4.0"

🐛 Bugs Fixed

Issue Status
LinkingContext context error on app start ✅ Fixed
React Query not persisting to MMKV ✅ Fixed
Version mismatch between CLI and template ✅ Fixed
Unistyles v3 initialization issues ✅ Fixed
MMKV DevTools not working ✅ Fixed
Inconsistent dependency versions ✅ Fixed

🚀 Upgrade Guide

For New Projects

Simply run:

bunx fast-expo-app@3.1.0

For Existing v3.0.0 Projects

Update your package.json:

# Add missing dependencies
bun add @tanstack/react-query-persist-client@5.90.7 @tanstack/query-sync-storage-persister@5.90.7 @react-navigation/bottom-tabs@7.4.0 @react-navigation/elements@2.6.3

# Update existing dependencies
bun add @react-navigation/native@7.1.8 react-native-unistyles@3.0.21

# Add dev dependency
bun add -D @dev-plugins/react-native-mmkv@0.4.0

# Reinstall
rm -rf node_modules && bun install

📊 Stats

  • 5 critical bugs fixed
  • 4 new dependencies added
  • 6 dependencies updated
  • 9 versions pinned to exact
  • 100% version consistency between CLI and templates

🔗 Links

📦 Installation

# Using Bun (recommended)
bunx fast-expo-app@3.1.0

# Or using npm
npx fast-expo-app@3.1.0

Full Changelog: v3.0.0...v3.1.0

Made with ♥ by Teczer

⭐ Star the repo if you find it useful!

Assets 2
Loading