Repository Loading Patterns

Core Principles

Use RepositoryLoader to validate required native data is loaded before rendering. Configure requiredRepositories to specify data dependencies, provide loadingFallback for UX, and let errors bubble to ErrorBoundary.

Why: Pre-rendering validation prevents downstream null errors, improves error handling, and provides clear loading states. Parallel loading with TanStack Query minimizes load time.

When to Use This Skill

Use these patterns when:

• Loading critical data from native modules before rendering
• Validating required repository properties exist
• Preventing null reference errors from missing data
• Providing loading states during data fetch
• Handling data loading errors with ErrorBoundary
• Wrapping navigation stacks with data requirements
• Testing components with repository dependencies