# Status and limitations

Platform support, feature restrictions, and distribution limits.

Source: https://legend.so/spark/limitations/

Spark 0.0.1 primarily targets macOS 14+ on Apple Silicon.

## [What works where](https://legend.so/spark/limitations/#what-works-where)

| Target | Available workflow | Limits |
| --- | --- | --- |
| macOS 14+, Apple Silicon | Spark Runner, custom development builds, standalone apps, signing/notarization, and whole-app updates | Check feature availability in your app |
| macOS 14+, Intel x64 | Source tooling targets builds, Runner registration/downloads, and packaging | Native compilation, runtime behavior, and signed distribution still need validation; the published Runner is ARM64 only |
| Windows 11, x64/ARM64 | Local source Runner and custom development builds | Native compilation and runtime behavior still need validation; no hosted Runner or production packaging workflow |
| iOS / Android / web | Expo workflows and selected shared API/UI adapters | Desktop windows, files, menus, and processes are not universal capabilities |
| Linux / Mac App Store | No supported workflow | Unsupported |

## [Feature restrictions](https://legend.so/spark/limitations/#feature-restrictions)

-   Common UI controls use different platform implementations. Windows `SegmentedControl` is unsupported.
-   Search, sidebar, split-view, settings-window composition, and SF Symbols are macOS capabilities. `GlassView`'s native effect requires macOS 26.
-   Command routing and low-level keyboard APIs require macOS. The native Codex supervisor is also macOS-only.
-   Standalone media sessions for an external playback engine are unsupported on mobile.
-   Secure storage is unavailable on web.

Check feature-specific availability and permissions before offering a capability. See [native UI](https://legend.so/spark/ui/), [integrations](https://legend.so/spark/integrations/), and [known Windows issues](https://github.com/LegendApp/legend-spark/blob/main/docs/windows-issues.md) for details.

## [Standalone apps and updates](https://legend.so/spark/limitations/#standalone-apps-and-updates)

macOS build, Developer ID signing, notarization, and whole-app update tooling are available. Test installation, startup, update/relaunch, and rejection of older builds with your signed app and update feed. See [packaging and updates](https://legend.so/spark/distribution/).

Windows production builds, signing, and MSIX packaging are unsupported.

## [Architecture limits](https://legend.so/spark/limitations/#architecture-limits)

-   Application JavaScript runs in Hermes. Node built-ins and Electron main-process APIs are unavailable.
-   Helpers are app-supplied, target-specific executables requiring a custom binary. They are not persistent OS services.
-   Spark SQLite/WebView/audio/UI contracts expose supported subsets, not complete backend APIs.
-   Expo Router integration, declarative route-based window navigation, and a broad universal UI catalog are not supported. `createWindowsNavigator` provides named-window component coordination.
-   Frame → Spark migration requires rebuilding matching native runtimes. Old prototype data, credentials, and OS registrations are not automatically migrated. See [migration](https://legend.so/spark/migration/).

[View Markdown](https://legend.so/spark/limitations.md)[Report a documentation correction](https://github.com/LegendApp/legend-docs/issues/new?title=Docs%3A+Status+and+limitations&body=Page%3A+https%3A%2F%2Flegend.so%2Fspark%2Flimitations%0A%0AWhat+is+incorrect+or+missing%3F%0A%0AExpected+behavior+or+supporting+source%3A%0A)