@croacroa/react-native-template 2.0.1 → 3.2.0

package/CHANGELOG.md

@@ -1,106 +1,195 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [Unreleased]
-
-### Added
-
-- Auth adapter pattern for easy provider switching (Supabase, Firebase, etc.)
-- Internationalization (i18n) support with expo-localization and i18next
-  - English and French translations included
-  - Language detection and persistence
-- New UI components:
-  - `Select` - Dropdown/picker component
-  - `Checkbox` and `CheckboxGroup` - Animated checkbox components
-  - `BottomSheet` - Modal bottom sheet with @gorhom/bottom-sheet
-  - `Avatar` and `AvatarGroup` - User avatar components
-  - `Badge`, `Chip`, and `CountBadge` - Label/tag components
-  - `OptimizedImage` - High-performance image component with expo-image
-- Deep linking support with `useDeepLinking` hook
-- Biometric authentication with `useBiometrics` hook
-- Analytics adapter for multiple providers (Mixpanel, Amplitude, etc.)
-- Rate limiting for API calls using Bottleneck
-- E2E testing setup with Maestro
-  - Login, registration, navigation, and offline flow tests
-- Project documentation:
-  - CONTRIBUTING.md
-  - CHANGELOG.md
-  - Architecture Decision Records (ADRs)
-- GitHub Actions CI/CD workflows:
-  - Lint, test, and build checks
-  - Maestro Cloud E2E tests
-  - EAS Build workflow (manual trigger)
-  - EAS Update workflow (OTA on push to main)
-- Onboarding screens with animated pagination
-- OTA updates support with `useUpdates` hook
-- Performance monitoring with `usePerformance` hook
-- Comprehensive accessibility utilities:
-  - Builder functions for all UI patterns (button, input, toggle, etc.)
-  - Hooks for screen reader, reduce motion, and bold text preferences
-  - Utility functions for announcements and focus management
-
-### Changed
-
-- Primary color changed from blue to emerald green (croacroa branding)
-- API client now includes rate limiting protection
-
-### Dependencies Added
-
-- `@gorhom/bottom-sheet` ^4.6.0
-- `bottleneck` ^2.19.5
-- `expo-image` ~2.0.0
-- `expo-local-authentication` ~15.0.0
-- `expo-localization` ~15.0.0
-- `i18next` ^23.0.0
-- `react-i18next` ^14.0.0
-
-## [1.0.0] - 2024-01-01
-
-### Added
-
-- Initial release
-- Expo SDK 52 with React Native 0.76
-- Expo Router for file-based navigation
-- Authentication flow with secure token storage
-- React Query for data fetching with offline support
-- Zustand for state management
-- NativeWind (Tailwind CSS) for styling
-- React Hook Form with Zod validation
-- Push notifications with Expo Notifications
-- Error tracking with Sentry
-- Storybook for component documentation
-- Jest and Testing Library for unit tests
-- Dark mode support
-- Basic UI components (Button, Input, Card, Modal, Skeleton)
-- Animated components with Reanimated
-- Toast notifications with Burnt
-
-### Infrastructure
-
-- EAS Build configuration for dev/preview/production
-- ESLint and Prettier setup
-- Husky pre-commit hooks
-- TypeScript strict mode
-
----
-
-## Versioning Guide
-
-### Version Format: MAJOR.MINOR.PATCH
-
-- **MAJOR**: Breaking changes
-- **MINOR**: New features (backwards compatible)
-- **PATCH**: Bug fixes (backwards compatible)
-
-### Changelog Categories
-
-- **Added**: New features
-- **Changed**: Changes to existing functionality
-- **Deprecated**: Features to be removed
-- **Removed**: Removed features
-- **Fixed**: Bug fixes
-- **Security**: Security improvements
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [3.2.0] - 2026-02-23
+
+### Added — Phase 8: Additional Features
+
+- **Rate Limiting UI** — 429 response interception with `Retry-After` parsing, toast feedback, `useRateLimit` hook with countdown
+- **App Force Update** — Version comparison service, `useForceUpdate` hook, non-dismissible `ForceUpdateScreen` component
+- **In-App Review** — `useInAppReview` hook with session counting and throttle via AsyncStorage, powered by `expo-store-review`
+- **Crash Recovery** — Enhanced `ErrorBoundary` with soft reset (re-render) and hard reset (clear stores + `Updates.reloadAsync()`), crash counter with Sentry context
+- **Feature Flags + A/B Testing** — `FeatureFlagAdapter` interface, `FeatureFlags` facade with `setAdapter()`, `MockFeatureFlagAdapter`, `useFeatureFlag`/`useExperiment` hooks, `FeatureGate` component
+- **Accessibility Tests** — 26 a11y tests for Button, Input, Checkbox, Modal, Card with reusable assertion helpers
+- **HTTP ETag Caching** — In-memory ETag cache with LRU eviction in `ApiClient`, `If-None-Match`/304 handling
+- **LaunchDarkly Integration Guide** — Complete adapter implementation guide
+
+### Changed
+
+- `Button` component now includes `accessibilityRole="button"` and `accessibilityState`
+
+### Dependencies Added
+
+- `expo-store-review`
+
+---
+
+## [3.1.0] - 2026-02-23
+
+### Added — Phase 7: Polish & Documentation
+
+- **Screen Internationalization** — All 6 screens (login, register, forgot-password, home, profile, settings) fully migrated to i18n with 56 strings replaced
+- **i18n Completeness** — 23 new keys added to all 5 locales (en, fr, es, de, ar), including `forgotPassword.*` and `home.*` sections
+- **Phase 6 Hook Tests** — 57 unit tests across 6 files covering all 13 Phase 6 hooks (permissions, payments, media, WebSocket, animations, analytics)
+- **Integration Guides** — Copy-paste-ready adapter guides for Supabase (auth), RevenueCat (payments), PostHog (analytics)
+
+---
+
+## [3.0.0] - 2026-02-22
+
+### Added — Phase 6: Template Completion
+
+- **Permission Management** (turnkey)
+  - Centralized `PermissionManager` service for all Expo permissions
+  - `usePermission` hook with auto-refresh on app resume
+  - `PermissionGate` component for declarative permission-gated UI
+  - Support: camera, location, contacts, media library, microphone, notifications
+- **Animations / UX Polish** (turnkey)
+  - Animation presets (timing, spring) and entry animation configs
+  - Screen transition presets for Expo Router (slide, fade, modal, etc.)
+  - `useAnimatedEntry` and `useStaggeredEntry` hooks
+  - `useParallax` hook for scroll parallax effects
+  - `AnimatedScreen` and `AnimatedListItem` components
+- **Social Login** (turnkey)
+  - Google Sign-In via `expo-auth-session` with PKCE
+  - Apple Sign-In via `expo-apple-authentication` (iOS)
+  - `SocialAuth` orchestrator with configurable providers
+  - `SocialLoginButtons` component with platform-aware display
+- **Analytics** (adapter pattern)
+  - `AnalyticsAdapter` interface following auth adapter pattern
+  - Console adapter for development
+  - `useTrackScreen` hook (auto-tracks Expo Router navigation)
+  - `useTrackEvent` hook for custom events
+  - `AnalyticsProvider` with automatic initialization
+- **Payment Infrastructure** (adapter pattern)
+  - `PaymentAdapter` interface with mock implementation
+  - `useProducts`, `usePurchase`, `useSubscription` hooks
+  - `Paywall` and `PurchaseButton` components
+- **File Upload / Media**
+  - Media picker service (camera + library)
+  - Image compression service via `expo-image-manipulator`
+  - Upload service with progress tracking, cancel, retry
+  - `useImagePicker` and `useUpload` hooks
+  - `ImagePickerButton` and `UploadProgress` components
+- **WebSockets / Real-time**
+  - `WebSocketManager` with auto-reconnect and exponential backoff
+  - Heartbeat, offline queue, auth token injection
+  - `useWebSocket`, `useChannel`, `usePresence` hooks
+
+### Dependencies Added
+
+- `expo-camera`
+- `expo-location`
+- `expo-contacts`
+- `expo-media-library`
+- `expo-auth-session`
+- `expo-web-browser`
+- `expo-apple-authentication`
+- `expo-crypto`
+- `expo-image-manipulator`
+
+---
+
+## [Unreleased]
+
+### Added
+
+- Auth adapter pattern for easy provider switching (Supabase, Firebase, etc.)
+- Internationalization (i18n) support with expo-localization and i18next
+  - English and French translations included
+  - Language detection and persistence
+- New UI components:
+  - `Select` - Dropdown/picker component
+  - `Checkbox` and `CheckboxGroup` - Animated checkbox components
+  - `BottomSheet` - Modal bottom sheet with @gorhom/bottom-sheet
+  - `Avatar` and `AvatarGroup` - User avatar components
+  - `Badge`, `Chip`, and `CountBadge` - Label/tag components
+  - `OptimizedImage` - High-performance image component with expo-image
+- Deep linking support with `useDeepLinking` hook
+- Biometric authentication with `useBiometrics` hook
+- Analytics adapter for multiple providers (Mixpanel, Amplitude, etc.)
+- Rate limiting for API calls using Bottleneck
+- E2E testing setup with Maestro
+  - Login, registration, navigation, and offline flow tests
+- Project documentation:
+  - CONTRIBUTING.md
+  - CHANGELOG.md
+  - Architecture Decision Records (ADRs)
+- GitHub Actions CI/CD workflows:
+  - Lint, test, and build checks
+  - Maestro Cloud E2E tests
+  - EAS Build workflow (manual trigger)
+  - EAS Update workflow (OTA on push to main)
+- Onboarding screens with animated pagination
+- OTA updates support with `useUpdates` hook
+- Performance monitoring with `usePerformance` hook
+- Comprehensive accessibility utilities:
+  - Builder functions for all UI patterns (button, input, toggle, etc.)
+  - Hooks for screen reader, reduce motion, and bold text preferences
+  - Utility functions for announcements and focus management
+
+### Changed
+
+- Primary color changed from blue to emerald green (croacroa branding)
+- API client now includes rate limiting protection
+
+### Dependencies Added
+
+- `@gorhom/bottom-sheet` ^4.6.0
+- `bottleneck` ^2.19.5
+- `expo-image` ~2.0.0
+- `expo-local-authentication` ~15.0.0
+- `expo-localization` ~15.0.0
+- `i18next` ^23.0.0
+- `react-i18next` ^14.0.0
+
+## [1.0.0] - 2024-01-01
+
+### Added
+
+- Initial release
+- Expo SDK 52 with React Native 0.76
+- Expo Router for file-based navigation
+- Authentication flow with secure token storage
+- React Query for data fetching with offline support
+- Zustand for state management
+- NativeWind (Tailwind CSS) for styling
+- React Hook Form with Zod validation
+- Push notifications with Expo Notifications
+- Error tracking with Sentry
+- Storybook for component documentation
+- Jest and Testing Library for unit tests
+- Dark mode support
+- Basic UI components (Button, Input, Card, Modal, Skeleton)
+- Animated components with Reanimated
+- Toast notifications with Burnt
+
+### Infrastructure
+
+- EAS Build configuration for dev/preview/production
+- ESLint and Prettier setup
+- Husky pre-commit hooks
+- TypeScript strict mode
+
+---
+
+## Versioning Guide
+
+### Version Format: MAJOR.MINOR.PATCH
+
+- **MAJOR**: Breaking changes
+- **MINOR**: New features (backwards compatible)
+- **PATCH**: Bug fixes (backwards compatible)
+
+### Changelog Categories
+
+- **Added**: New features
+- **Changed**: Changes to existing functionality
+- **Deprecated**: Features to be removed
+- **Removed**: Removed features
+- **Fixed**: Bug fixes
+- **Security**: Security improvements