Perry Compiles TypeScript directly to executables using SWC and LLVM

# Perry — TypeScript → Native Source: [https://www.perryts.com/](https://www.perryts.com/) v0\.5\.306 — generational GC \+ lazy JSON tape default, faster than Node and Bun on most benchmarks ## One Codebase\. Every Platform\. Native Performance\. Perry compiles TypeScript to native GUI and CLI apps onmacOS, iPadOS, iOS, Android, Linux, Windows, watchOS, tvOS, WebAssembly, and the Web\.No runtime\. No Electron\. Just native binaries\. [Get Started](https://www.perryts.com/#installation)[View on GitHub](https://github.com/PerryTS/perry) $perrycompile main\.ts Compiling main\.ts\.\.\. ✓ Compiled executable: main \(2\.3 MB\) $\./main Hello, World\! ## WhyPerry? Everything you need to compile TypeScript to native applications ### No Runtime Required Produces standalone native executables\. No Node\.js, no V8, no runtime dependencies\. Just a single binary that runs anywhere\. ### Fast Compilation Direct TypeScript to native code compilation using SWC for parsing and LLVM for optimized code generation\. No intermediate JavaScript\. ### Small Binaries Output binaries are typically 2\-5MB\. With optional V8 runtime for JS npm packages, 15\-20MB\. Ship less, deploy faster\. ### Deterministic Builds Same input, same binary\. Reproducible across machines, across CI runs, across teams\. No mystery rebuilds\. ### Comprehensive Standard Library Built\-in native implementations of fs, path, crypto, os, Buffer, child\_process, and more\. Use familiar Node\.js APIs\. ### Optional V8 Runtime Need to use a pure JavaScript npm package? Enable the V8 runtime flag for full npm ecosystem compatibility\. ### 25\+ Native UI Widgets Buttons, text fields, text areas, tables, canvas, scroll views, QR codes, secure fields, splash screens, and more — all compiling to real platform widgets via AppKit, GTK4, Win32, UIKit, and JNI\. ### Compile\-Time Plugin System Modules compose at build time — no runtime plugin overhead, no IPC boundaries\. Your dependencies become direct native function calls in the final binary\. ### True Multi\-Threading Real OS threads with parallelMap, parallelFilter, and spawn\. Compile\-time safety rejects mutable captures — no SharedArrayBuffer, no workers, just threads\. ### Compile\-Time i18n Automatic string extraction, CLDR plural rules for 30\+ locales, compile\-time validation\. Translations baked into the binary with near\-zero runtime lookup\. ## Native onEvery Platform Perry compiles your TypeScript to native UI frameworks, WebAssembly, and JavaScript — not web views, not Electron\. Real native widgets on every platform, plus the web\. ## From Code toApp Store Perry doesn't just compile your app — it gets it into your users' hands\. ### Build & Sign Cross\-platform builds from one command\. Code signing for macOS, iOS, Android, and Windows handled for you\. No wrestling with Xcode provisioning profiles or Android keystores\. ### Distribute Push to the App Store, Play Store, or ship direct downloads\. Perry Publish handles packaging, notarization, and submission\. ### Verify Powered by Geisterhand\. Automated UI testing across all 6 platforms\. Know your app works everywhere before your users tell you it doesn't\. Free for open\-source projects\.[Plans for teams](https://www.perryts.com/en/publish/)→ /publish Framework Comparison ## The only framework that checksevery box TypeScript compiled to native code\. Real platform widgets\. No runtime overhead\. FrameworkLanguageNative CodeNative WidgetsRuntime OverheadPerry★AOT compiled to native binary TypeScriptNoneReact NativeJIT / interpreted at runtime JS / TypeScriptHermes / V8 \+ BridgeFlutterAOT compiled, custom renderer DartDart VM \+ Skia engineKMP \+ ComposeJVM on Android, native on iOS KotlinPartial Kotlin runtime \+ SkiaSwift for AndroidNative binary, no shared UI SwiftNo shared UI Swift runtime on Android\.NET MAUIPartial AOT via Mono C\#Partial \.NET / Mono runtimeNativeScriptJS runtime, native widget access JS / TypeScriptV8 / JavaScriptCoreIonicWeb app in native wrapper JS / TypeScriptWebView \+ Capacitor ## WriteTypeScript, Ship Native Use familiar TypeScript syntax and APIs\. Perry handles the rest\. ``` // hello.tsconst greeting = "Hello, World!";console.log(greeting);// Compiles to ~2MB native executable// No runtime needed! ``` ## PerformanceComparison Native compilation delivers unmatched efficiency MetricPerryNode\.jsBunBinary Size2\-5 MB~80 MB~90 MBStartup Time~1 ms~30 ms~10 msRuntime DependenciesNoneNode\.jsBunMemory OverheadMinimalV8 \+ GCJSC \+ GC ### Benchmark Results:Up to 18x Faster Perry v0\.5\.279 vs Node\.js v25 — RUNS=11 median, Apple M1 Max \(lower is better\) Binary SizeLower is better ## GetStarted Install Perry and start compiling TypeScript to native executables ### 1Installation `$ brew tap PerryTS/perry` `$ brew install perry` Requires Homebrew\. Supports macOS arm64 and x86\_64\. ### 2Usage Compile a file `perry compile main\.ts` Compiles main\.ts to a native executable Custom output `perry compile main\.ts \-o myapp` Specify the output executable name With V8 runtime `perry compile main\.ts \-\-enable\-js\-runtime` Enable V8 for JavaScript npm package compatibility Check compatibility `perry check \./src` Validate TypeScript code for native compilation ## FeatureSupport Comprehensive TypeScript and Node\.js API coverage ### Core Language - Numbers64\-bit floating point \(f64\) - StringsUTF\-8, all common methods - Booleanstrue/false, logical operators - ArraysTyped and mixed\-type arrays - ObjectsObject literals and field access - BigInt256\-bit integer support - EnumsNumeric and string enums ### Functions - Function DeclarationNamed functions - Arrow Functions\(\) =\> \{\} syntax - Default ParametersParameters with defaults - Rest Parameters\.\.\.args syntax - ClosuresIncluding mutable captures - Higher\-Order FunctionsFunctions as arguments/returns - Async/AwaitAsync function support ### Classes - Class DeclarationBasic class syntax - ConstructorsWith parameters - Private Fields \(\#\)ES2022 \#privateField syntax - Static Methods/FieldsClass\-level members - Getters/Settersget/set accessors - Inheritanceextends keyword - Super Callssuper\(\) constructor calls ### Type System - Type AnnotationsExplicit type declarations - Type InferenceAutomatic type detection - GenericsMonomorphization \(like Rust\) - InterfacesInterface declarations - Union Typesstring \| number support - Type Guardstypeof operator - Type Aliasestype X = \.\.\. declarations ### Standard Library - fsreadFileSync, writeFileSync, existsSync, etc\. - pathjoin, dirname, basename, extname, resolve - cryptorandomBytes, randomUUID, sha256, md5 - osplatform, arch, hostname, memory info - Bufferfrom, alloc, toString, slice, copy - child\_processexecSync, spawnSync - JSON/Math/DateFull implementations ## 30\+Native npm Packages Popular npm packages reimplemented in native Rust\. No npm install, no node\_modules, just fast native code\. ### Database mysql2pgmongodbbetter\-sqlite3ioredis ### Security bcryptargon2jsonwebtokencrypto ### HTTP httphttpsaxiosnode\-fetchwsnodemailer ### Data Processing cheeriosharpzliblodash ### Date & Time dayjsmomentdate\-fnsnode\-cron ### Utilities uuidnanoidslugifyvalidatordotenvrate\-limiter\-flexible Just import and use \- Perry automatically uses the native implementation ## How ItWorks From TypeScript source to native executable in seconds HIR TransformMonomorphization Want to know how the compiler works under the hood?[Compiler internals](https://www.perryts.com/en/internals/)