SUMMARY.md

Summary

Introduction

---

Getting Started

• Installation
• Hello World
• First Native App
• Project Configuration

Language

• Supported Features
• Type System
• Decorators
• Limitations

npm Packages

• Porting Packages (experimental)
• Native Bindings — Overview
  • Authoring a Native Binding
  • perry-ffi ABI Reference
  • Manifest Schema (spec v1)

Multi-Threading

• Overview
• parallelMap
• parallelFilter
• spawn

Native UI

• Overview
• Widgets
• Layout
• Styling
• State Management
• Events
• Canvas
• Menus
• Tray Icon
• Dialogs
• Table
• Animation
• Multi-Window
• Theming
• Camera
• WebView

Terminal UI

• Overview
• Widgets
• Hooks
• Examples

Platforms

• Overview
• macOS
• iOS
• visionOS
• tvOS
• watchOS
• Android
• HarmonyOS NEXT
• Windows
  • Windows 7 Compatibility
• Linux (GTK4)
• Web
• WebAssembly

Standard Library

• Overview
• File System
• HTTP & Networking
• Databases
• Cryptography
• Utilities
• Other Modules
• API Reference (auto-generated)

Internationalization

• Overview
• Interpolation & Plurals
• Formatting
• CLI Tools

Auto-Update

• Overview

System APIs

• Overview
• Preferences
• Keychain
• Notifications
• Audio Capture
• Media Playback
• Geolocation & Image Picker
• Background Tasks
• Other

Widgets

• Widgets
  • Creating Widgets
  • Components & Modifiers
  • Configuration
  • Data Fetching
  • Cross-Platform Reference
  • watchOS Complications
  • Wear OS Tiles

Plugins

• Overview
• Creating Plugins
• Hooks & Events
• Native Extensions
• App Store Review

Testing

• Geisterhand (UI Fuzzer)

CLI Reference

• Commands
• Compiler Flags
• Fast-math (--fast-math)
• Dynamic Stdlib Dispatch
• JS Runtime Opt-In
• PERRY_SANDBOX_BUILDRS
• --emit-attest (binary attestation sidecar)
• --emit-sandbox
• --lockdown
• Egress Allowlist (allowedHosts)
• Per-Package Capabilities (perry.permissions)
• perry audit --sbom
• Host Allowlist (nativeLibrary, compilePackages)
• perry.toml Reference

---

Internals

• Memory Model

Contributing

• Architecture
• Building from Source