awesome-claude-md

callstack/react-native-testing-library

View CLAUDE.md
libraries frameworks ReactTypeScript Updated 2026-02-10

Analysis

Category: Libraries & Frameworks

This CLAUDE.md represents the gold standard for testing library documentation from industry experts. Callstack's expertise in React Native development shines through comprehensive testing philosophy and practical implementation patterns.

Source Repository

What Makes This Example Exceptional

1. Behavioral Testing Philosophy Documentation

Emphasizes testing user behavior over implementation details with clear distinction between user events vs fire events, testing-first mindset with comprehensive examples, and integration with React Native testing ecosystem.

2. Three-Tier Query System Architecture

Implements get* queries that expect elements to exist (throw on failure), query* queries for elements that may not exist (return null), find* queries for asynchronous element discovery, and comprehensive API design patterns for different use cases.

3. Complete Development Workflow

Features Jest configuration for React Native testing, pre-commit hooks with ESLint and type checking, multiple export strategies for different package consumers, and build process with TypeScript compilation.

4. Testing Library Best Practices

Promotes accessibility-first query strategies, user-centric testing approaches, integration testing patterns for React Native components, and organized mock and testing utilities.

Key Takeaways for Developers

  1. Testing Philosophy Documentation: Clearly articulate testing principles and the "why" behind API design decisions
  2. Three-Tier API Patterns: Demonstrate how to design APIs with different expectation levels (get/query/find pattern)
  3. Modular Testing Architecture: Show how to organize testing utilities and maintain separation of concerns in test frameworks

Why This Example Was Selected

This example fills a crucial gap by showcasing professional testing library documentation from React Native experts at Callstack. It demonstrates how to document comprehensive testing philosophies while providing practical implementation guidance. The three-tier query system design pattern is an exemplary approach to API design that balances developer expectations with real-world usage scenarios.