mirror of
https://github.com/react/react-native.git
synced 2026-09-28 13:23:09 +08:00
loulanyue
ba398a5581
Summary: Pull Request resolved: https://github.com/react/react-native/pull/58179 Replaces hardcoded `react/react-native` URLs with standard relative repository links for `LICENSE` and `.github/SUPPORT.md` in `README.md`. ## Changelog: [General][Internal] Use relative Markdown links for LICENSE and SUPPORT.md in README Pull Request resolved: https://github.com/react/react-native/pull/58130 Test Plan: Verified Markdown links navigate to relative repo root and `.github/` folder correctly in GitHub markdown viewer. Reviewed By: cortinico Differential Revision: D117642224 Pulled By: vzaidman fbshipit-source-id: 1bc4f120c6e34f5f0de746cf4f8ee2fef3508d3a
106 lines
6.1 KiB
Markdown
106 lines
6.1 KiB
Markdown
<p align="center">
|
|
<picture>
|
|
<source media="(prefers-color-scheme: dark)" srcset="https://reactnative.dev/react-native-dark.svg">
|
|
<source media="(prefers-color-scheme: light)" srcset="https://reactnative.dev/react-native-light.svg">
|
|
<img alt="React Native logo" src="https://reactnative.dev/react-native-light.svg" height="80">
|
|
</picture>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<strong>Learn once, write anywhere:</strong><br>
|
|
Create native apps for Android, iOS, and more using React
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="React Native is released under the MIT license" /></a>
|
|
<a href="https://www.npmjs.com/package/react-native"><img src="https://img.shields.io/npm/v/react-native.svg?color=blue" alt="Current npm package version" /></a>
|
|
<a href="https://www.npmjs.com/package/react-native"><img src="https://img.shields.io/npm/dm/react-native.svg" alt="Monthly npm downloads" /></a>
|
|
<a href="https://twitter.com/intent/follow?screen_name=reactnative"><img src="https://img.shields.io/badge/Follow_@reactnative-black?logo=x&logoColor=white" alt="Follow @reactnative on X" /></a>
|
|
</p>
|
|
|
|
<h4 align="center">
|
|
<a href="https://reactnative.dev/docs/environment-setup">Getting Started</a>
|
|
<span> · </span>
|
|
<a href="https://reactnative.dev/docs/tutorial">Learn the Basics</a>
|
|
<span> · </span>
|
|
<a href="https://reactnative.dev/showcase">Showcase</a>
|
|
<span> · </span>
|
|
<a href="https://reactnative.dev/docs/contributing">Contribute</a>
|
|
<span> · </span>
|
|
<a href="https://reactnative.dev/help">Community</a>
|
|
<span> · </span>
|
|
<a href="./.github/SUPPORT.md">Support</a>
|
|
</h4>
|
|
|
|
# React Native
|
|
|
|
React Native lets you build native apps using [React](https://react.dev/). Written
|
|
in JavaScript, rendered with native code.
|
|
|
|
- **Native UI.** React Native primitives render to native platform UI, meaning your app
|
|
uses the same native platform APIs other apps do. Gestures, text scaling, and
|
|
accessibility behave the way users expect on each OS.
|
|
- **React, everywhere.** Declarative UI, components, hooks, and Suspense, reused
|
|
across Android, iOS, and [other platforms](https://reactnative.dev/docs/out-of-tree-platforms).
|
|
- **Developer Velocity.** See local changes in seconds. Changes to JavaScript code are applied with Fast Refresh, without rebuilding the native app.
|
|
- **Extend it yourself.** Native Modules let you call platform code directly from JavaScript, synchronously and type-safe — or reach for [thousands of existing libraries](https://reactnative.directory/).
|
|
|
|
React Native is developed and supported by many companies and individual core contributors. Find out more on the [React Foundation website](https://react.foundation/).
|
|
|
|
## Building your first React Native app
|
|
|
|
Follow the [Getting Started guide](https://reactnative.dev/docs/environment-setup) for a new app, or [Integration with Existing Apps](https://reactnative.dev/docs/integration-with-existing-apps) to adopt React Native incrementally.
|
|
|
|
### Using a Framework
|
|
|
|
We believe that the best way to experience React Native is through a Framework, a toolbox with all the necessary APIs to let you build production ready apps. [Expo](https://docs.expo.dev/get-started/set-up-your-environment/) is a production-grade React Native Framework, with file-based routing, a standard library of native modules, and much more.
|
|
|
|
To create a new Expo project, run the following in your terminal:
|
|
|
|
npx create-expo-app@latest
|
|
|
|
Then follow the rest of [Expo's getting started guide](https://docs.expo.dev/get-started/set-up-your-environment/) to start building.
|
|
|
|
### Without a Framework
|
|
|
|
You can also use React Native without a Framework, however we've found that most developers benefit from one — navigation, native dependencies, and platform tooling are problems the ecosystem has already solved. If a Framework doesn't suit your app, follow [Getting Started Without a Framework](https://reactnative.dev/docs/getting-started-without-a-framework).
|
|
|
|
## Documentation
|
|
|
|
The full documentation for React Native can be found on our [website](https://reactnative.dev/docs/getting-started).
|
|
|
|
- [Introduction](https://reactnative.dev/docs/getting-started)
|
|
- [Getting Started](https://reactnative.dev/docs/environment-setup)
|
|
- [Learn the Basics](https://reactnative.dev/docs/tutorial)
|
|
- [Components and APIs](https://reactnative.dev/docs/components-and-apis)
|
|
- [UI & Interaction](https://reactnative.dev/docs/style)
|
|
- [Native Modules](https://reactnative.dev/docs/native-platform)
|
|
- [Debugging](https://reactnative.dev/docs/debugging)
|
|
- [Upgrading](https://reactnative.dev/docs/upgrading)
|
|
- [Architecture](https://reactnative.dev/architecture/overview)
|
|
|
|
The source for the React Native docs and website is hosted on a separate repository, [**react/react-native-website**](https://github.com/react/react-native-website).
|
|
|
|
## Contributing
|
|
|
|
The main purpose of this repository is to continue evolving React Native core. We want to make contributing to this project as easy and transparent as possible, and we are grateful to the community for contributing bug fixes and improvements. Read below to learn how you can take part in improving React Native.
|
|
|
|
### [Code of Conduct](https://code.fb.com/codeofconduct/)
|
|
|
|
Meta has adopted a Code of Conduct that we expect project participants to adhere to.
|
|
Please read the [full text](https://code.fb.com/codeofconduct/) so that you can understand what actions will and will not be tolerated.
|
|
|
|
### [Contributing Guide](https://reactnative.dev/docs/contributing)
|
|
|
|
Read our [**Contributing Guide**](https://reactnative.dev/docs/contributing) to learn about our development process, how to propose bugfixes and improvements, and how to build and test your changes to React Native.
|
|
|
|
### Discussions
|
|
|
|
Larger discussions and proposals are discussed in [**react-native-community/discussions-and-proposals**](https://github.com/react-native-community/discussions-and-proposals).
|
|
|
|
React Native releases are discussed in [**reactwg/react-native-releases**](https://github.com/reactwg/react-native-releases/discussions).
|
|
|
|
## License
|
|
|
|
React Native is MIT licensed, as found in the [LICENSE](./LICENSE) file.
|