Merge branch 'main' into main

Author: NathanWalker

README.md

@@ -4,7 +4,7 @@ Live version: https://docs.nativescript.org/
 
 ---
 
-This repository holds the source for the **latest** version of our docs. The theme and general functionality is being built in a different repo, this repo is purely focused on the content.
+This repository holds the source for the **latest** version of our docs.
 
 ## Goals
 
@@ -29,9 +29,7 @@ This repository holds the source for the **latest** version of our docs. The the
 Pick a topic/page that nobody is working on yet, create a new branch, add the necessary markdown file and an entry to `content/sidebar.ts`.
 Open a draft PR and start working on the page. Once you are ready for feedback, mark the PR as ready for review. During the review process, address any feedback until the content is approved.
 
-If you have any questions, feel free to ask them in your PR and ping [@rigor789](https://github.com/rigor789).
-
-> **Note**: in the current stage of the beta docs, please try to only include a single page + the sidebar config change in a PR to make the review process easier, and reduce possible conflicts. Once we have the majority of the pages complete, we can focus on adding cross-links and references where necessary, and do any additional cleanup passes - at which point this requirement will be dropped.
+If you have any questions, feel free to ask them in your PR.
 
 ### Reviewing PRs
 

content/guide/choosing-an-editor.md

@@ -16,9 +16,9 @@ If you do choose to [try Visual Studio Code](https://code.visualstudio.com/), le
 
 After you install Visual Studio Code, you can open projects using the editor's `File` → `Open` menu option, but there's an alternative option that works far better for command-line-based projects like NativeScript: the `code` command.
 
-The `code` command runs in your command-line or terminal, and it works just like the `ns` command does for NativeScript apps. Visual Studio Code installs the `code` command by default on Windows on Linux, but on macOS, there's [one manual step](https://code.visualstudio.com/docs/setup/mac) you must perform.
+The `code` command runs in your command-line or terminal, and it works just like the `ns` command does for NativeScript apps. Visual Studio Code installs the `code` command by default on Windows and Linux, but on macOS, there's [one manual step](https://code.visualstudio.com/docs/setup/mac) you must perform.
 
-Once set up, you can type `code .` in your terminal to open the files in your current folder for editing. For example, you could use the following sequence of command to create a new NativeScript app and open it for editing.
+Once set up, you can type `code .` in your terminal to open the files in your current folder for editing. For example, you could use the following sequence of commands to create a new NativeScript app and open it for editing.
 
 ```bash
 ns create MyNewApp

content/guide/code-sharing.md

@@ -25,9 +25,9 @@ If a "code sharing solution" is maintained by a framework that can often mean th
 
 ## Code Sharing Solutions
 
-Here are a few solitions to **code-sharing**, each having their pros and cons.
+Here are a few solutions to **code-sharing**, each having their pros and cons.
 
-### Nrwl Nx DevTools with @nativescript/nx
+### Nx with @nativescript/nx
 
 [Learn More about @nativescript/nx](https://github.com/NativeScript/nx)
 
@@ -42,28 +42,10 @@ Here are a few solitions to **code-sharing**, each having their pros and cons.
 
 - Learning curve if not used to Nx practices in general
 
-### Nrwl Nx DevTools with @nstudio/xplat
+### npm or yarn workspaces
 
-[Learn more about @nstudio/xplat](https://nstudio.io/xplat)
-
-**Pros:**
-
-- It's centered around JavaScript/TypeScript (lesson 1 and 5 above)
-- Uses standard build tooling like TypeScript or webpack to build code (lesson 2 above)
-- No custom file extensions to deal with (lesson 3 above)
-- Nx splits up "apps" and "libs" clearly identifying deployment/distribution targets "apps" that consume shared code "libs" (lesson 4 above)
-- It builds upon @nativescript/nx to further scale it across more paradigms so it's a natural extension when needed if already working in Nx with @nativescript/nx
-- Opinionated architecture is provided via xplat which helps to avoid common pitfalls from hard lessons learned in real world developments with cross platform mixtures
-
-**Cons:**
-
-- Learning curve if not used to Nx practices in general
-- Learning curve if you have not developed applications in large codebases before
-- Understanding the [basic fundamentals](https://nstudio.io/xplat/fundamentals/architecture) of the provided architecture
-
-### Yarn workspaces
-
-[Learn more about Yarn workspaces](https://classic.yarnpkg.com/en/docs/workspaces/)
+- [Learn more about npm workspaces](https://docs.npmjs.com/cli/using-npm/workspaces/)
+- [Learn more about Yarn workspaces](https://classic.yarnpkg.com/en/docs/workspaces/)
 
 **Pros:**
 

content/guide/crash-reporting-sentry.md

@@ -45,6 +45,10 @@ SENTRY_AUTH_TOKEN=your-auth-token
 
 Replace the above placeholders with your actual Sentry details.
 
+::: tip
+If you are also doing XR development with Vision Pro or Meta Quest, you may want to additionally setup `SENTRY_PROJECT_SLUG_VISIONOS`, `SENTRY_DSN_VISIONOS`, `SENTRY_PROJECT_SLUG_QUEST`, and `SENTRY_DSN_QUEST`. The bundling config below demonstrates using a visionOS version string as an example. Meta Quest would use the standard Android versioning location of app.gradle.
+:::
+
 ## Step 4: Configure Webpack
 
 We will use Webpack to manage environment variables and source maps with plugins:
@@ -89,7 +93,10 @@ module.exports = (env) => {
           ).match(/versionName\s+"([^"]+)"/)[1]
         : parse(
             readFileSync(
-              resolve(__dirname, 'App_Resources/iOS/Info.plist'),
+              resolve(
+                __dirname,
+                `App_Resources/${platform === 'visionos' ? 'visionOS' : 'iOS'}/Info.plist`,
+              ),
               'utf8',
             ),
           )['CFBundleShortVersionString']

content/guide/updating/index.md

@@ -10,7 +10,6 @@ Updating a NativeScript app is usually a quick process if done regularly. The fo
 ## Update guides
 
 - [Updating to latest](/guide/updating/to-latest)
-- More soon...
 
 ## Updating to a tagged version
 

content/plugins/biometrics.md

@@ -34,7 +34,15 @@ editUrl: https://github.com/NativeScript/plugins/tree/main/packages/biometrics/R
 A plugin that allows you to authenticate users with biometrics, such as fingerprints, facial recognition, etc.
 
 > **Note**
-> This plugin replaces [@nativescript/fingerprint-auth](../fingerprint-auth).
+> This plugin replaces [@nativescript/fingerprint-auth](../plugins/fingerprint-auth).
+
+### Prerequisites:
+
+Before you can verify a user’s biometrics, the device must already have biometric data (such as fingerprints or a face scan) enrolled at the system level. This enrollment is handled by the device’s operating system settings—your app or this plugin does not capture or store biometric data directly. Users must set up biometrics through their device’s security settings (e.g., `Settings` > `Security` > `Biometrics` on Android, or `Settings` > `Face ID` & `Passcode` on iOS).
+
+### How it works:
+
+When you call the plugin’s verification methods, the plugin asks the operating system to prompt the user for their enrolled biometric (fingerprint, face, etc.) and returns the result. The plugin never sees or manages the actual biometric data—only the OS does.
 
 ## Installation
 

content/plugins/detox.md

@@ -197,7 +197,36 @@ A default NativeScript Android project uses 17 as the minimum SDK, but Detox req
 
 :::
 
-### Allow Local Networking (**iOS Only**)
+### Allow Local Networking
+
+#### Android (Compulsory)
+
+We have added a network security config file at `./res/xml/network_security_config.xml`, add it to the applications `AndroidManifest.xml` as below
+
+```xml
+<!-- ./res/xml/network_security_config.xml -->
+<?xml version="1.0" encoding="utf-8"?>
+<network-security-config>
+    <domain-config cleartextTrafficPermitted="true">
+        <domain includeSubdomains="true">10.0.2.2</domain>
+        <domain includeSubdomains="true">localhost</domain>
+    </domain-config>
+</network-security-config>
+```
+
+```xml
+<!-- ./res/xml/network_security_config.xml -->
+...existing code...
+
+  <application
+		...existing attributes...
+    android:networkSecurityConfig="@xml/network_security_config">
+...existing code...
+```
+
+If you have an existing network security config, incorporate the configuration specified above into it.
+
+#### iOS (Optional)
 
 Dependending on your setup iOS may not be able to communicate with Detox off the bat. In that case, you need to add the following to your `Info.plist` file to allow for local networking requests.
 

content/plugins/fingerprint-auth.md

@@ -11,7 +11,7 @@ editUrl: https://github.com/NativeScript/plugins/tree/main/packages/fingerprint-
 
 ## Replacement notice
 
-This plugin is replaced by [@nativescript/biometrics](../biometrics)
+This plugin is replaced by [@nativescript/biometrics](../plugins/biometrics)
 
 # @nativescript/fingerprint-auth