Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/app-publishing.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ These are the steps to follow if you are looking to publish a React Native Windo
- Pricing and Availability ([Set app pricing and availability - UWP applications | Microsoft Docs](https://docs.microsoft.com/windows/uwp/publish/set-app-pricing-and-availability))
- Properties ([Enter app properties - UWP applications | Microsoft Docs](https://docs.microsoft.com/windows/uwp/publish/enter-app-properties))
- Age Ratings ([Age ratings - UWP applications | Microsoft Docs](https://docs.microsoft.com/windows/uwp/publish/age-ratings))
- Store Listings ([Create app Store listings - UWP applications | Microsoft Docs](https://docs.microsoft.com/windows/uwp/publish/create-app-store-listings))
- Store Listings ([Create app Store listings - UWP applications | Microsoft Docs](https://learn.microsoft.com/en-us/windows/apps/publish))
- Submission Options ([Manage submission options - UWP applications | Microsoft Docs](https://docs.microsoft.com/windows/uwp/publish/manage-submission-options))

11. Under the packages section you will be asked to upload your `.appxupload`. Make sure that your `.appxupload`…
Expand Down
14 changes: 7 additions & 7 deletions docs/init-windows-cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ Here are the options that `react-native init-windows` takes:
| Option | Input Type | Description |
|-----------------------|------------|--------------------------------------------------|
| `--logging` | boolean | Verbose output logging |
| `--template` | string | Specify the template to use (default: `old/uwp-cpp-app`) |
| `--template` | string | Specify the template to use (default: `cpp-app`) |
| `--name` | string | The native project name. Defaults to the name property in `app.json` or `package.json` |
| `--namespace` | string | The native project namespace, expressed using dots as separators, i.e. `Level1.Level2.Level3`. Defaults to the same as name |
| `--overwrite` | boolean | Overwrite any existing files without prompting |
Expand All @@ -42,12 +42,12 @@ After running, the `init-windows` command will save the `name`, `namespace` and
"init-windows": {
"name": "MyApp",
"namespace": "MyApp",
"template": "old/uwp-cpp-app"
"template": "cpp-app"
}
}
```

If you later repeat the `init-windows` command to re-initialize a Windows project, without specifying any of those options, the command will default to any saved values. Among other things, this means you can safely re-run `init-windows` without it automatically changing your project to a different template.
If you later repeat the `init-windows` command to re-initialize a Windows project, without specifying any of those options, the command will default to any saved values. Among other things, this means you can safely re-run `init-windows` without it automatically changing your project to a different template (i.e. if your project is an Old Architecture app, `init-windows` won't force you to migrate to the New Architecture).

If you *want* to change the value (say, you *do* want to migrate to a new template) just explicitly (re-)specify the option when running `init-windows`.

Expand All @@ -57,12 +57,12 @@ The following templates are available to `init-windows` and can by manually spec

| Template | Name | Description |
|:-:|:--|:--|
| `cpp-app` | React Native Windows Application (New Arch, WinAppSDK, C++) | A RNW app using RN's New Architecture, built in C++ and targeting WinAppSDK |
| `cpp-app` | React Native Windows Application (New Arch, WinAppSDK, C++) | `[Default]` A RNW app using RN's New Architecture, built in C++ and targeting WinAppSDK |
| `cpp-lib` | React Native Windows Library (C++) | A RNW (Turbo) Native Module supporting RN's New and Old Architectures built in C++ |
| `old/uwp-cpp-app` | React Native Windows Application (Old Arch, UWP, C++) | A RNW app using RN's Old Architecture, built in C++ and targeting UWP |
| `old/uwp-cs-app` | React Native Windows Application (Old Arch, UWP, C#) | A RNW app using RN's Old Architecture, built in C# and targeting UWP |
| `old/uwp-cpp-app` | React Native Windows Application (Old Arch, UWP, C++) | `[Legacy]` A RNW app using RN's Old Architecture, built in C++ and targeting UWP |
| `old/uwp-cs-app` | React Native Windows Application (Old Arch, UWP, C#) | `[Legacy]` A RNW app using RN's Old Architecture, built in C# and targeting UWP |

> **Architecture Note:** When initializing React Native for Windows for the first time, the `init-windows` CLI command defaults to the `old/uwp-cpp-app` template, which targets React Native's Old Architecture. For more information, see [New vs. Old Architecture](new-architecture.md).
> **Architecture Note:** When initializing React Native for Windows for the first time, the `init-windows` CLI command defaults to the `cpp-app` template, which targets [React Native's New Architecture](https://reactnative.dev/architecture/landing-page). For more information, see [New vs. Old Architecture](new-architecture.md).

## Telemetry Notice

Expand Down
4 changes: 2 additions & 2 deletions docs/new-architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ title: New vs. Old Architecture

React Native's [New Architecture](https://reactnative.dev/architecture/landing-page) brings many framework improvements including the advanced [Fabric](https://reactnative.dev/architecture/fabric-renderer) rendering system. It greatly improves the speed and responsiveness of React Native apps over the previous *Legacy* or *Old Architecture* and its *Paper* renderer. The New Architecture was enabled by default for the *iOS* and *Android* platforms in [react-native@0.76.0](https://reactnative.dev/blog/2024/10/23/the-new-architecture-is-here).

React Native for Windows also supports the New Architecture for the *Windows* platform. It was first available as an opt-in preview in [react-native-windows@0.76.0](https://devblogs.microsoft.com/react-native/2025-01-29-new-architecture-on-0-76-0-77/). For more information on the differences between the architectures on Windows, see [New vs. Old Architecture Differences](#new-vs-old-architecture-differences).
React Native for Windows also supports the New Architecture for the *Windows* platform. It was first available as an opt-in preview in [react-native-windows@0.76.0](https://devblogs.microsoft.com/react-native/2025-01-29-new-architecture-on-0-76-0-77/) and became the default for *new* app projects in `react-native-windows@0.80.0`. For more information on the differences between the architectures on Windows, see [New vs. Old Architecture Differences](#new-vs-old-architecture-differences).

> **Important:** Nearly all future investments to React Native (and React Native for Windows) will be toward the New Architecture, and we highly recommend that all projects migrate as soon as possible. React Native (and therefore React Native for Windows) will eventually deprecate, then delete, support for the Old Architecture.

Expand Down Expand Up @@ -51,7 +51,7 @@ This change makes it easier for React Native for Windows to implement expected b

Developers choose the React Native Architecture (New or Old) for their Windows application when (re-)initializing Windows platform support for their project. This choice is determined by the `--template` argument when running the [init-windows command](init-windows-cli.md).

If you re-run `init-windows` on a project without specifying a template, the command will default to the previously used template. See [Default Options and Re-initializing Projects](init-windows-cli.md#default-options-and-re-initializing-projects) for more details.
Starting with `react-native-windows@0.80.0`, calling `init-windows` for the *first time* in an application project (as seen in the [Getting Started](getting-started.md) guide) will default to using the New Architecture template if none is specified. If you re-run `init-windows` on a project without specifying a template, the command will default to the previously used template. See [Default Options and Re-initializing Projects](init-windows-cli.md#default-options-and-re-initializing-projects) for more details.

> **Note:** The choice described here only applies for your project's Windows build and is independent of the choice you make for other React Native platforms, i.e. your Android and iOS builds can target a different architecture than your Windows build.

Expand Down
2 changes: 1 addition & 1 deletion website/versioned_docs/version-0.67/app-publishing.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ These are the steps to follow if you are looking to publish a React Native Windo
- Pricing and Availability ([Set app pricing and availability - UWP applications | Microsoft Docs](https://docs.microsoft.com/windows/uwp/publish/set-app-pricing-and-availability))
- Properties ([Enter app properties - UWP applications | Microsoft Docs](https://docs.microsoft.com/windows/uwp/publish/enter-app-properties))
- Age Ratings ([Age ratings - UWP applications | Microsoft Docs](https://docs.microsoft.com/windows/uwp/publish/age-ratings))
- Store Listings ([Create app Store listings - UWP applications | Microsoft Docs](https://docs.microsoft.com/windows/uwp/publish/create-app-store-listings))
- Store Listings ([Create app Store listings - UWP applications | Microsoft Docs](https://learn.microsoft.com/en-us/windows/apps/publish))
- Submission Options ([Manage submission options - UWP applications | Microsoft Docs](https://docs.microsoft.com/windows/uwp/publish/manage-submission-options))

11. Under the packages section you will be asked to upload your `.appxupload`. Make sure that your `.appxupload`…
Expand Down
2 changes: 1 addition & 1 deletion website/versioned_docs/version-0.79/app-publishing.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ These are the steps to follow if you are looking to publish a React Native Windo
- Pricing and Availability ([Set app pricing and availability - UWP applications | Microsoft Docs](https://docs.microsoft.com/windows/uwp/publish/set-app-pricing-and-availability))
- Properties ([Enter app properties - UWP applications | Microsoft Docs](https://docs.microsoft.com/windows/uwp/publish/enter-app-properties))
- Age Ratings ([Age ratings - UWP applications | Microsoft Docs](https://docs.microsoft.com/windows/uwp/publish/age-ratings))
- Store Listings ([Create app Store listings - UWP applications | Microsoft Docs](https://docs.microsoft.com/windows/uwp/publish/create-app-store-listings))
- Store Listings ([Create app Store listings - UWP applications | Microsoft Docs](https://learn.microsoft.com/en-us/windows/apps/publish))
- Submission Options ([Manage submission options - UWP applications | Microsoft Docs](https://docs.microsoft.com/windows/uwp/publish/manage-submission-options))

11. Under the packages section you will be asked to upload your `.appxupload`. Make sure that your `.appxupload`…
Expand Down