React Native for OpenHarmony Developer Documentation

This documentation is intended for developers with React Native experience. Before reading, we recommend learning from the React Native Official Documentation.

Notice: The English documentation is designed for version 0.72. Please refer to the Chinese documentation for the latest version. We plan to update the English content in H1 2027.

Developer Journey Navigation

Journey Stage	Directory	Core Content
📐 Design	01-design	Interface specs, architecture planning, communication mechanisms
💻 Development	02-development	Environment setup, feature development, component customization
🔍 Debugging	03-debugging	Debugging methods, troubleshooting, FAQ
⚡ Optimization	04-optimization	Performance tuning, practice cases
🔧 Operations	05-operations	Version management, stability management, build & bundling
🌐 Community	06-community	Community guidelines, contribution guides

---

Directory Structure

docs/en/
│
├── 01-design/                      # Design Stage
│   ├── about-react-native.md       # RNOH overview
│   ├── architecture.md             # Technical architecture
│   ├── three-rendering-phases.md   # Rendering process
│   ├── arkts-cpp-communication.md  # Native communication
│   ├── js-native-communication.md  # JS-Native communication
│   ├── api-description.md          # Interface specs
│   ├── specification-faq.md        # Specification FAQs
│   └── README.md
│
├── 02-development/                 # Development Stage
│   ├── 01-environment-and-tools/   # Environment & Tools ⚡version-related
│   │   ├── environment-setup.md    # Environment configuration
│   │   ├── getting-started.md      # Quick start guide
│   │   ├── SDK version configuration guide.md  # SDK version selection
│   │   └── samples-guide.md        # Sample project list
│   ├── 02-development-guide/       # Development Guide
│   │   ├── feature-development.md  # Development process guide
│   │   ├── custom-components.md    # Component development
│   │   ├── Codegen.md              # Code generation tool
│   │   ├── TurboModule.md          # TurboModule usage
│   │   ├── autolinking.md          # Auto-linking config ⚡version-related
│   │   ├── rn-native-integration.md  # Native integration
│   │   ├── usage-of-c-api-component-hybrid-solution.md  # C-API hybrid
│   │   └── build-configuration/
│   │       ├── build-and-compilation-guide.md
│   │       └── RNOH Build and Symbol Management Guide.md
│   ├── 03-scenarios-and-practices/ # Scenarios & Practices
│   │   ├── common-development-scenarios.md  # Development scenarios
│   │   ├── best-practices-by-scenario.md    # Best practices
│   │   └── usage-faqs.md            # Development FAQs
│   └── README.md
│
├── 03-debugging/                   # Debugging Stage
│   ├── debugging.md                # Debugging tools & methods
│   ├── faqs.md                     # FAQ overview
│   ├── faqs/
│   │   ├── compilation-faqs.md
│   │   ├── runtime-faqs.md
│   │   ├── usage-faqs.md
│   │   ├── locating-faqs.md
│   │   └── specification-faqs.md
│   └── README.md
│
├── 04-optimization/                # Optimization Stage
│   ├── performance-optimization.md
│   ├── application-performance-optimization.md
│   ├── performance-optimization-practice/
│   │   └── page-transition-and-sliding-optimization.md
│   └── README.md
│
├── 05-operations/                  # Operations Stage ⚡version-related
│   ├── release-notes-overview.md   # Release notes summary
│   ├── version-upgrade-guide.md    # Upgrade instructions
│   ├── upstream-community-incompatible-changes.md  # Upstream changes
│   ├── rn-js-bundle.md             # JS bundling
│   ├── hvigorfile-configuration.md # Build configuration
│   ├── multi-screen-adaptation-guide.md  # Multi-screen adaptation
│   ├── AI-assisted-issue-diagnosis-guide.md  # AI diagnosis
│   ├── release-notes/              # Detailed release notes
│   │   └── react-native-harmony-v0.86.1.md
│   ├── build-configuration/
│   ├── stability-coding-standards/ # Stability coding standards
│   │   └── stability-coding-standards.md
│   ├── stability-skill/            # Stability analysis tools
│   │   ├── rnoh-stability-review/
│   │   └── rnoh-stability-triage/
│   ├── stability-overview/         # Stability issue overview
│   │   ├── stability-overview.md
│   │   ├── stability-analysis-methods.md
│   │   └── stability-cases.md
│   └── README.md
│
├── 06-community/                   # Community Governance
│   ├── documentation-contribution-guide.md  # Documentation contribution
│   ├── roadmap.md                  # Community roadmap
│   ├── community-guidelines/
│   └── README.md
│
├── figures/                        # Image resources
└── public_sys-resources/           # Public resources

⚡ Marked as "version-related" documents need to be updated with each release

---

External Resources

• Third-party Library Integration Guide - RNOH-compatible libraries
• Project Samples - Sample projects for various scenarios
• Maintainer Documentation - RNOH maintainer documentation
• Docs version sync skill - Post-release maintenance for the full docs/ tree

---

Version Classification

Type	Directory	Maintenance Strategy
Version-related	02-development/01-environment-and-tools (environment/SDK), 02-development/02-development-guide (autolinking), 05-operations (version/build/history)	Updated with each release
Version-independent	01-design, 03-debugging, 04-optimization, 05-operations (stability-coding-standards/stability-skill/stability-overview), 06-community	Independently maintained, long-term valid

---

Contributing

For contribution guidelines, see Documentation Contribution Guide.

After a release, to sync version numbers across the full docs/ tree (zh-cn, en, Samples, templates), use the docs version sync skill (@.agents/skills/rnoh-upgrade-version/rnoh-docs-version-upgrade/SKILL.md).