NativeScript · NathanWalker · Sep 13, 2026 · Sep 8, 2026 · Sep 12, 2026
diff --git a/packages/core/global-types.d.ts b/packages/core/global-types.d.ts
@@ -140,6 +140,7 @@ declare const __COMMONJS__: boolean;
 declare const __ANDROID__: boolean;
 declare const __IOS__: boolean;
 declare const __VISIONOS__: boolean;
+declare const __TVOS__: boolean;
 declare const __APPLE__: boolean;
 
 declare function setTimeout(callback: (...args: any[]) => void, ms: number, ...args: any[]): number;

diff --git a/packages/core/index.ts b/packages/core/index.ts
@@ -37,7 +37,7 @@ export { ModuleNameResolver } from './module-name-resolver';
 export { _setResolver } from './module-name-resolver/helpers';
 export type { PlatformContext } from './module-name-resolver';
 export type { ModuleListProvider } from './module-name-resolver/helpers';
-export { isAndroid, isIOS, isVisionOS, isApple, Screen, Device, platformNames } from './platform';
+export { isAndroid, isIOS, isVisionOS, isTvOS, isApple, Screen, Device, platformNames } from './platform';
 export type { IDevice } from './platform';
 export { profile, enable as profilingEnable, disable as profilingDisable, time as profilingTime, uptime as profilingUptime, start as profilingStart, stop as profilingStop, isRunning as profilingIsRunning, dumpProfiles as profilingDumpProfiles, resetProfiles as profilingResetProfiles, startCPUProfile as profilingStartCPU, stopCPUProfile as profilingStopCPU } from './profiling';
 export type { InstrumentationMode, TimerInfo } from './profiling';

diff --git a/packages/core/module-name-resolver/qualifier-matcher/index.ts b/packages/core/module-name-resolver/qualifier-matcher/index.ts
@@ -87,15 +87,24 @@ const minHeightQualifier: QualifierSpec = {
 
 const platformQualifier: QualifierSpec = {
 	isMatch: function (path: string): boolean {
-		return path.includes('.android') || path.includes('.ios');
+		return path.includes('.android') || path.includes('.ios') || path.includes('.tvos');
 	},
 	getMatchOccurences: function (path: string): Array<string> {
-		return path.match(new RegExp('\\.android|\\.ios', 'g'));
+		return path.match(new RegExp('\\.android|\\.ios|\\.tvos', 'g'));
 	},
 	getMatchValue(value: string, context: PlatformContext): number {
 		const val = value.substring(1);
+		const os = context.os.toLowerCase();
+		if (val === os) {
+			// exact platform: .tvos on tvOS, .ios on iOS, .android on Android
+			return 2;
+		}
+		if (val === 'ios' && os === 'tvos') {
+			// tvOS falls back to .ios files, below an explicit .tvos candidate
+			return 1;
+		}
 
-		return val === context.os.toLowerCase() ? 1 : -1;
+		return -1;
 	},
 };
 

diff --git a/packages/core/platform/common.spec.ts b/packages/core/platform/common.spec.ts
@@ -0,0 +1,27 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+
+afterEach(() => {
+	vi.unstubAllGlobals();
+	vi.resetModules();
+});
+
+describe('tvOS platform identity', () => {
+	it('loads with bundlers that do not define the new tvOS flag', async () => {
+		delete (globalThis as any).__TVOS__;
+		const platform = await import('./common');
+		expect(platform.isTvOS).toBe(false);
+		const { Device } = await import('./device/index.ios');
+		expect(Device.os).toBe('iOS');
+	});
+
+	it('recognizes tvOS as both tvOS and iOS-compatible', async () => {
+		vi.stubGlobal('__TVOS__', true);
+		vi.stubGlobal('__IOS__', false);
+		vi.stubGlobal('__VISIONOS__', false);
+		const platform = await import('./common');
+		expect(platform.isTvOS).toBe(true);
+		expect(platform.isIOS).toBe(true);
+		const { Device } = await import('./device/index.ios');
+		expect(Device.os).toBe('tvOS');
+	});
+});
diff --git a/packages/core/platform/common.ts b/packages/core/platform/common.ts
@@ -5,10 +5,12 @@ export const platformNames = {
 	android: 'Android',
 	ios: 'iOS',
 	visionos: 'visionOS',
+	tvos: 'tvOS',
 	apple: 'apple',
 };
 
 export const isAndroid = !!__ANDROID__;
-export const isIOS = !!__IOS__ || !!__VISIONOS__;
+export const isTvOS = typeof __TVOS__ !== 'undefined' && !!__TVOS__;
+export const isIOS = !!__IOS__ || !!__VISIONOS__ || isTvOS;
 export const isVisionOS = !!__VISIONOS__;
 export const isApple = !!__APPLE__;
diff --git a/packages/core/platform/device/index.ios.ts b/packages/core/platform/device/index.ios.ts
@@ -1,4 +1,4 @@
-import { platformNames } from '../common';
+import { isTvOS, platformNames } from '../common';
 
 type DeviceType = 'Phone' | 'Tablet' | 'Vision';
 
@@ -15,6 +15,8 @@ class DeviceRef {
 	get os(): string {
 		if (__VISIONOS__) {
 			return platformNames.visionos;
+		} else if (isTvOS) {
+			return platformNames.tvos;
 		} else {
 			return platformNames.ios;
 		}

diff --git a/packages/core/platform/index.d.ts b/packages/core/platform/index.d.ts
@@ -24,6 +24,11 @@ export const isApple: boolean;
  */
 export const isVisionOS: boolean;
 
+/**
+ * Gets a value indicating if the app is running on the tvOS platform.
+ */
+export const isTvOS: boolean;
+
 export * from './common';
 export * from './device';
 export * from './screen';
diff --git a/packages/core/platforms/ios/NSCWinterTC.xcframework/Info.plist b/packages/core/platforms/ios/NSCWinterTC.xcframework/Info.plist
@@ -93,6 +93,37 @@
 			<key>SupportedPlatform</key>
 			<string>ios</string>
 		</dict>
+		<dict>
+			<key>BinaryPath</key>
+			<string>NSCWinterTC.framework/NSCWinterTC</string>
+			<key>LibraryIdentifier</key>
+			<string>tvos-arm64</string>
+			<key>LibraryPath</key>
+			<string>NSCWinterTC.framework</string>
+			<key>SupportedArchitectures</key>
+			<array>
+				<string>arm64</string>
+			</array>
+			<key>SupportedPlatform</key>
+			<string>tvos</string>
+		</dict>
+		<dict>
+			<key>BinaryPath</key>
+			<string>NSCWinterTC.framework/NSCWinterTC</string>
+			<key>LibraryIdentifier</key>
+			<string>tvos-arm64_x86_64-simulator</string>
+			<key>LibraryPath</key>
+			<string>NSCWinterTC.framework</string>
+			<key>SupportedArchitectures</key>
+			<array>
+				<string>arm64</string>
+				<string>x86_64</string>
+			</array>
+			<key>SupportedPlatform</key>
+			<string>tvos</string>
+			<key>SupportedPlatformVariant</key>
+			<string>simulator</string>
+		</dict>
 	</array>
 	<key>CFBundlePackageType</key>
 	<string>XFWK</string>

diff --git a/...latforms/ios/NSCWinterTC.xcframework/tvos-arm64/NSCWinterTC.framework/Headers/NSCCrypto.h b/...latforms/ios/NSCWinterTC.xcframework/tvos-arm64/NSCWinterTC.framework/Headers/NSCCrypto.h
@@ -0,0 +1,79 @@
+//
+//  NSCCrypto.h
+//  NSCWinterTC
+//
+//  Created by Osei Fortune on 03/07/2024.
+//  Copyright © 2024 NativeScript. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import <CommonCrypto/CommonCrypto.h>
+#import <Security/Security.h>
+#import <Security/SecItem.h>
+#ifndef NSCCrypto_h
+#define NSCCrypto_h
+
+typedef enum : NSUInteger {
+    kNSCCryptoRSASSA_PKCS1_v1_5,
+    kNSCCryptoRSA_PSS,
+    kNSCCryptoRSA_OAEP,
+} NSCCryptoRsaHashedKeyGenParamsName;
+
+
+typedef enum : NSUInteger {
+    kNSCCryptoHashSHA1,
+    kNSCCryptoHashSHA256,
+    kNSCCryptoHashSHA384,
+    kNSCCryptoHashSHA512
+} NSCCryptoHash;
+
+
+typedef enum : NSUInteger {
+    kNSCCryptoDecrypt,
+    kNSCCryptoEncrypt,
+    kNSCCryptoSign,
+    kNSCCryptoVerify,
+    kNSCCryptoDeriveKey,
+    kNSCCryptoDeriveBits,
+    kNSCCryptoWrapKey,
+    kNSCCryptoUnwrapKey,
+} NSCCryptoKeyUsages;
+
+
+
+@interface NSCCryptoKeyPair : NSObject
+@property (nonatomic, readonly, nonnull) SecKeyRef privateKey;
+@property (nonatomic, readonly, nonnull) SecKeyRef publicKey;
+-(nonnull id)initWithPrivateKey:(nonnull SecKeyRef)privKey andPublicKey:(nonnull SecKeyRef)pubKey;
+@end
+
+typedef void (^DigestCompletionHandler)(NSData * _Nullable result,NSError * _Nullable error);
+typedef void (^GenerateKeyCompletionHandler)(NSCCryptoKeyPair * _Nullable result,NSError * _Nullable error);
+typedef void (^DecryptCompletionHandler)(NSData * _Nullable result,NSError * _Nullable error);
+typedef void (^EncryptCompletionHandler)(NSData * _Nullable result,NSError * _Nullable error);
+
+
+@interface NSCCrypto:NSObject
++ (nonnull NSString*)randomUUID;
++ (nullable NSString*)getRandomValues:(nonnull NSMutableData*)buffer;
++ (nullable NSData*)digest:(nonnull NSData*)data mode:(int)mode;
++ (void)digest:(nonnull NSData*)data mode:(int)mode completion:(DigestCompletionHandler _Nonnull ) completion;
++ (nullable NSData *)generateKeyHmac:(int)hash length:(int)length;
++ (nullable NSData *)signHmac:(nonnull NSData*)key hash:(NSCCryptoHash)hash data:(nonnull NSData*)data;
++ (BOOL)verifyHmac:(nonnull NSData*)key hash:(NSCCryptoHash)hash signature:(nonnull NSData*)signature data:(nonnull NSData*)data;
+
++ (nullable NSCCryptoKeyPair*)generateKeyRsa:(NSCCryptoRsaHashedKeyGenParamsName)name modulusLength:(unsigned int)modulusLength publicExponent:(nullable void*)exponent size:(unsigned int)size hash:(NSCCryptoHash)hash extractable:(BOOL)extractable keyUsages:(nonnull NSArray*) usages;
+
++ (void)generateKeyRsa:(NSCCryptoRsaHashedKeyGenParamsName)name modulusLength:(unsigned int)modulusLength publicExponent:(nullable void*)exponent size:(unsigned int)size hash:(NSCCryptoHash)hash extractable:(BOOL)extractable keyUsages:(nonnull NSArray*) usages completion:(GenerateKeyCompletionHandler _Nonnull ) completion;
+
+
+
++ (nullable NSData *)encryptRsa:(BOOL)isPrivate key:(nonnull NSCCryptoKeyPair *)key hash:(NSCCryptoHash)hash data:(nonnull NSData*)data;
+
++ (void)encryptRsa:(BOOL)isPrivate key:(nonnull NSCCryptoKeyPair *)key hash:(NSCCryptoHash)hash data:(nonnull NSData*)data completion:(EncryptCompletionHandler _Nonnull ) completion;
+
++ (nullable NSData *)decryptRsa:(BOOL)isPrivate key:(nonnull NSCCryptoKeyPair *)key hash:(NSCCryptoHash)hash data:(nonnull NSData*)data;
+
++ (void)decryptRsa:(BOOL)isPrivate key:(nonnull NSCCryptoKeyPair *)key hash:(NSCCryptoHash)hash data:(nonnull NSData*)data completion:(DecryptCompletionHandler _Nonnull ) completion;
+@end
+#endif /* NSCCrypto_h */
diff --git a/...tforms/ios/NSCWinterTC.xcframework/tvos-arm64/NSCWinterTC.framework/Headers/NSCWinterTC.h b/...tforms/ios/NSCWinterTC.xcframework/tvos-arm64/NSCWinterTC.framework/Headers/NSCWinterTC.h
@@ -0,0 +1,20 @@
+//
+//  NSCWinterTC.h
+//  NSCWinterTC
+//
+//  Created by Osei Fortune and Nathan Walker on 07/09/2024.
+//  Copyright © 2024 NativeScript. All rights reserved.
+//
+
+#import <UIKit/UIKit.h>
+
+//! Project version number for NSCWinterTC.
+FOUNDATION_EXPORT double NSCWinterTCVersionNumber;
+
+//! Project version string for NSCWinterTC.
+FOUNDATION_EXPORT const unsigned char NSCWinterTCVersionString[];
+
+// In this header, you should import all the public headers of your framework using statements like #import <NSCWinterTC/PublicHeader.h>
+
+#import "NSCCrypto.h"
+#import "NSString+WinterTC.h"
diff --git a/.../ios/NSCWinterTC.xcframework/tvos-arm64/NSCWinterTC.framework/Headers/NSString+WinterTC.h b/.../ios/NSCWinterTC.xcframework/tvos-arm64/NSCWinterTC.framework/Headers/NSString+WinterTC.h
@@ -0,0 +1,21 @@
+//
+//  NSString+WinterTC.h
+//  NSCWinterTC
+//
+//  Created by Osei Fortune and Nathan Walker on 07/09/2024.
+//  Copyright © 2024 NativeScript. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface NSString (WinterTC)
+
++ (NSString*)atob:(nonnull NSString*)data;
+
++ (NSString*)btoa:(nonnull NSString*)stringToEncode;
+
+@end
+
+NS_ASSUME_NONNULL_END
diff --git a/...es/core/platforms/ios/NSCWinterTC.xcframework/tvos-arm64/NSCWinterTC.framework/Info.plist b/...es/core/platforms/ios/NSCWinterTC.xcframework/tvos-arm64/NSCWinterTC.framework/Info.plist
diff --git a/...rms/ios/NSCWinterTC.xcframework/tvos-arm64/NSCWinterTC.framework/Modules/module.modulemap b/...rms/ios/NSCWinterTC.xcframework/tvos-arm64/NSCWinterTC.framework/Modules/module.modulemap
@@ -0,0 +1,6 @@
+framework module NSCWinterTC {
+  umbrella header "NSCWinterTC.h"
+  export *
+
+  module * { export * }
+}
diff --git a/...s/core/platforms/ios/NSCWinterTC.xcframework/tvos-arm64/NSCWinterTC.framework/NSCWinterTC b/...s/core/platforms/ios/NSCWinterTC.xcframework/tvos-arm64/NSCWinterTC.framework/NSCWinterTC
diff --git a/...interTC.xcframework/tvos-arm64_x86_64-simulator/NSCWinterTC.framework/Headers/NSCCrypto.h b/...interTC.xcframework/tvos-arm64_x86_64-simulator/NSCWinterTC.framework/Headers/NSCCrypto.h
@@ -0,0 +1,79 @@
+//
+//  NSCCrypto.h
+//  NSCWinterTC
+//
+//  Created by Osei Fortune on 03/07/2024.
+//  Copyright © 2024 NativeScript. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import <CommonCrypto/CommonCrypto.h>
+#import <Security/Security.h>
+#import <Security/SecItem.h>
+#ifndef NSCCrypto_h
+#define NSCCrypto_h
+
+typedef enum : NSUInteger {
+    kNSCCryptoRSASSA_PKCS1_v1_5,
+    kNSCCryptoRSA_PSS,
+    kNSCCryptoRSA_OAEP,
+} NSCCryptoRsaHashedKeyGenParamsName;
+
+
+typedef enum : NSUInteger {
+    kNSCCryptoHashSHA1,
+    kNSCCryptoHashSHA256,
+    kNSCCryptoHashSHA384,
+    kNSCCryptoHashSHA512
+} NSCCryptoHash;
+
+
+typedef enum : NSUInteger {
+    kNSCCryptoDecrypt,
+    kNSCCryptoEncrypt,
+    kNSCCryptoSign,
+    kNSCCryptoVerify,
+    kNSCCryptoDeriveKey,
+    kNSCCryptoDeriveBits,
+    kNSCCryptoWrapKey,
+    kNSCCryptoUnwrapKey,
+} NSCCryptoKeyUsages;
+
+
+
+@interface NSCCryptoKeyPair : NSObject
+@property (nonatomic, readonly, nonnull) SecKeyRef privateKey;
+@property (nonatomic, readonly, nonnull) SecKeyRef publicKey;
+-(nonnull id)initWithPrivateKey:(nonnull SecKeyRef)privKey andPublicKey:(nonnull SecKeyRef)pubKey;
+@end
+
+typedef void (^DigestCompletionHandler)(NSData * _Nullable result,NSError * _Nullable error);
+typedef void (^GenerateKeyCompletionHandler)(NSCCryptoKeyPair * _Nullable result,NSError * _Nullable error);
+typedef void (^DecryptCompletionHandler)(NSData * _Nullable result,NSError * _Nullable error);
+typedef void (^EncryptCompletionHandler)(NSData * _Nullable result,NSError * _Nullable error);
+
+
+@interface NSCCrypto:NSObject
++ (nonnull NSString*)randomUUID;
++ (nullable NSString*)getRandomValues:(nonnull NSMutableData*)buffer;
++ (nullable NSData*)digest:(nonnull NSData*)data mode:(int)mode;
++ (void)digest:(nonnull NSData*)data mode:(int)mode completion:(DigestCompletionHandler _Nonnull ) completion;
++ (nullable NSData *)generateKeyHmac:(int)hash length:(int)length;
++ (nullable NSData *)signHmac:(nonnull NSData*)key hash:(NSCCryptoHash)hash data:(nonnull NSData*)data;
++ (BOOL)verifyHmac:(nonnull NSData*)key hash:(NSCCryptoHash)hash signature:(nonnull NSData*)signature data:(nonnull NSData*)data;
+
++ (nullable NSCCryptoKeyPair*)generateKeyRsa:(NSCCryptoRsaHashedKeyGenParamsName)name modulusLength:(unsigned int)modulusLength publicExponent:(nullable void*)exponent size:(unsigned int)size hash:(NSCCryptoHash)hash extractable:(BOOL)extractable keyUsages:(nonnull NSArray*) usages;
+
++ (void)generateKeyRsa:(NSCCryptoRsaHashedKeyGenParamsName)name modulusLength:(unsigned int)modulusLength publicExponent:(nullable void*)exponent size:(unsigned int)size hash:(NSCCryptoHash)hash extractable:(BOOL)extractable keyUsages:(nonnull NSArray*) usages completion:(GenerateKeyCompletionHandler _Nonnull ) completion;
+
+
+
++ (nullable NSData *)encryptRsa:(BOOL)isPrivate key:(nonnull NSCCryptoKeyPair *)key hash:(NSCCryptoHash)hash data:(nonnull NSData*)data;
+
++ (void)encryptRsa:(BOOL)isPrivate key:(nonnull NSCCryptoKeyPair *)key hash:(NSCCryptoHash)hash data:(nonnull NSData*)data completion:(EncryptCompletionHandler _Nonnull ) completion;
+
++ (nullable NSData *)decryptRsa:(BOOL)isPrivate key:(nonnull NSCCryptoKeyPair *)key hash:(NSCCryptoHash)hash data:(nonnull NSData*)data;
+
++ (void)decryptRsa:(BOOL)isPrivate key:(nonnull NSCCryptoKeyPair *)key hash:(NSCCryptoHash)hash data:(nonnull NSData*)data completion:(DecryptCompletionHandler _Nonnull ) completion;
+@end
+#endif /* NSCCrypto_h */
diff --git a/...terTC.xcframework/tvos-arm64_x86_64-simulator/NSCWinterTC.framework/Headers/NSCWinterTC.h b/...terTC.xcframework/tvos-arm64_x86_64-simulator/NSCWinterTC.framework/Headers/NSCWinterTC.h
@@ -0,0 +1,20 @@
+//
+//  NSCWinterTC.h
+//  NSCWinterTC
+//
+//  Created by Osei Fortune and Nathan Walker on 07/09/2024.
+//  Copyright © 2024 NativeScript. All rights reserved.
+//
+
+#import <UIKit/UIKit.h>
+
+//! Project version number for NSCWinterTC.
+FOUNDATION_EXPORT double NSCWinterTCVersionNumber;
+
+//! Project version string for NSCWinterTC.
+FOUNDATION_EXPORT const unsigned char NSCWinterTCVersionString[];
+
+// In this header, you should import all the public headers of your framework using statements like #import <NSCWinterTC/PublicHeader.h>
+
+#import "NSCCrypto.h"
+#import "NSString+WinterTC.h"