mirror of https://github.com/react/react-native.git synced 2026-09-28 13:23:09 +08:00

Files

T

Zeya Peng 969f9bec45 Document the Native Animated architecture (#58106 )

Summary:
Pull Request resolved: https://github.com/react/react-native/pull/58106

Document the cross-platform C++ implementation of Native Animated, including its purpose, execution model, core components, prop application paths, and relationship with the shared Animation Backend.

Changelog:
[Internal]

___

Reviewed By: cipolleschi

Differential Revision: D116797721

fbshipit-source-id: 64e7a295fb05f8f51be882404b34c1db2fba18bd

2026-08-25 06:21:19 -07:00

GUIDELINES.md

Prettify markdown files in __docs__ (#50587 )

2025-04-09 05:42:48 -07:00

README-template.md

Use emojis in technical docs titles (#50699 )

2025-04-14 05:41:02 -07:00

README.md

Document the Native Animated architecture (#58106 )

2026-08-25 06:21:19 -07:00

README.md

React Native Technical Documentation

The React Native technical documentation describes how React Native works internally, the subsystems it is composed of, how they work and how they interact with each other.

The intended audience is people who want to learn about the internals of React Native and contribute to it. End users of React Native are meant to use the public website instead (its code can be found here).

For details on how we approach technical documentation in this repository, see GUIDELINES.md.

🚀 Usage

This repository is not meant to be consumed directly by end users. Instead, it creates several packages that are published to the NPM registry for direct consumption by end users and frameworks.

This repository uses a monorepo approach, and public packages can be found in the packages directory (the ones that do not contain "private": true in their package.json file).

The most important package is the react-native package, located in packages/react-native, which contains the public JavaScript API.

This repository provides the Android and iOS versions of React Native. Versions for other platforms are maintained in their own repositories.

📐 Design

TODO: Explain the different components of React Native at a high level.

🔗 Relationship with other systems

Part of this

Runtime
- Cross-platform
  - Feature Flags
  - Host / Instance / Bridgeless
  - UI / Fabric
    - Events
    - Shadow Tree Lifecycle
      - Runtime Shadow Node Reference Update
      - passChildrenWhenCloningPersistedNodes
    - Layout
    - Mounting
    - Animation Backend
    - Native Animated
  - Native Modules / TurboModules
  - JS Runtime
    - Event Loop
    - Globals and environment setup
    - Error handling
  - Developer Tools
    - React Native DevTools
      - Infrastructure
        
        Inspector proxy protocol
    - LogBox
  - Misc
    - Web APIs
      - DOM Traversal & Layout APIs
      - IntersectionObserver
      - MutationObserver
      - Performance & PerformanceObserver
      - Timers
- Platform-specific
  - Host Platform Interface
- Android
  - UI
    - Events
    - Mounting
- iOS
  - UI
    - Events
    - Mounting
Build system
- Android
- iOS
  - SwiftPM
- C++
- JavaScript
  - Metro
Testing
- Android
- iOS
- C++
- JavaScript
  - Flow
  - TypeScript
  - Jest
  - ESLint
- Integration / E2E
  - Fantom

Used by this

This repository has many different types of dependencies: build systems, external packages to be used during development, external packages used at runtime, etc.

Uses this

The main use cases for this repository are:

Developing React Native itself.
Testing and releasing React Native.
Synchronizing forks like react-native-windows and react-native-macos.