## Core Features

### Offline-First Data Layer
- SQLite database for local note and folder caching
- Stale-while-revalidate pattern for instant UI updates
- Conditional HTTP requests (ETag/Last-Modified) to minimize data transfer
- Configurable cache preference: decrypted (instant) vs encrypted (secure)

### Background Sync System
- Mutation queue in SQLite for offline changes
- Auto-sync on network reconnect with race condition protection
- Retry logic with exponential backoff for failed syncs
- Optimistic UI updates with temp IDs for offline note creation

### Network Management
- Network status detection with @react-native-community/netinfo
- Orange floating offline indicator
- Disabled edit/delete when offline (create notes offline enabled)
- Clear user feedback with offline alerts

### User Settings
- Cache preference bottom sheet (replaced toggle)
- "Cache Decrypted" - instant loading, requires master password
- "Cache Encrypted" - maximum security, slightly slower

## Technical Improvements

### API Layer
- Enhanced HTTP client with conditional request support
- Database cache layer with metadata tracking
- Folder and note APIs with offline fallback
- Type-safe SQLite bindings with proper null handling

### UI/UX
- Fixed settings toggle switch positioning (16px → 20px translation)
- Better cache preference explanations with radio buttons

…diting issues

Performance Optimizations:
- Consolidate SQL queries from 5 separate queries to 1 optimized query (~80% reduction)
- Add composite database indexes for count queries (O(log n) instead of O(n) lookups)
- Implement 10s short-lived cache for offline counts to prevent recalculation
- Add helper functions to eliminate code duplication (112 lines deduplicated)

Bug Fixes:
- Fix folder counts not displaying when offline (calculate from SQLite cache)
- Fix race condition in ViewNote attachment loading with proper cleanup
- Fix infinite error toasts when viewing notes offline
- Improve error handling to return complete interfaces

UX Improvements:
- Add 500ms debouncing for network status changes (prevents flaky connection issues)
- Add prefetch during master password authentication for instant offline access
- Add two-stage loading UI: "Securing Your Data" → "Caching Your Data"
- Add loading spinner to prevent white screen flash

Security:
- Change default to encrypted cache for better security (decrypt on-demand)
- Add "Offline Cache Security" documentation in Settings
- Maintain end-to-end encryption throughout