# Roadmap This plan lists what NSGo may still take from NSH's 0.5.0 release (tag `v0.5.0`, `f4d68f7f`, 2026-11-11), 563 commits past 0.4.0, in the order to build it, each with tests of NSGo's own. Each item names its NSH reference and the result that finishes it. What exists is in [ARCHITECTURE.md](../ARCHITECTURE.md), and what NSGo leaves out on purpose in [NSGo and NSH](architecture/nsh.md#what-nsgo-leaves-out). Design questions that block an item are in [Open questions](../ARCHITECTURE.md#open-questions). References are files in `nsh/docs/dev/` unless they give a path from `nsh/`, NSH's checkout beside the repository, with the section to read in brackets, or NSH's pull requests (#931) where no page describes the work. [Reading NSH's releases](architecture/nsh.md#reading-nshs-releases) says how to rebuild this plan for NSH's next release. ## Performance against NSH's baselines NSH records what its hot paths cost (`data-table.md` (Performance), `performance.md`, `web.md`), and NSH's own build on each machine is the measure: the gallery's scenarios (`examples/gallery/perf_test.go`) run the same steps as an `nsh test` file there ([performance](architecture/performance.md#keeping-frames-cheap) says how and lists the readings of 2026-11-09). Headless, in headless Chrome, on macOS for the DataTable and the stack, and in the iOS simulator, NSGo costs what NSH does or less. 0.5.0 rewrote `performance.md`, made lists and scroll views cheaper (#1304, #1310, #1371) and Windows' frames and canvases (#1661): Linux, the Android emulator and macOS were measured again against its build (2026-11-12), and Windows, the iOS simulator and headless Chrome still are before an item here closes. What is left: | Item | NSH reference | Done when | | --- | --- | --- | | Animated layers on macOS | `performance.md` (The performance monitor) | The gallery's Animations page costs on macOS what NSH's does, measured at 120 Hz on a Mac whose screen is unlocked and nothing else runs: against 0.5.0, with another workspace's simulator busy, the monitors read 6–15% of a core and 0.3–0.8 ms a frame against 10–14% and 0.6 ms (2026-11-12), against 0.4.0 13–15% and 1.1–1.5 ms against 8% and 0.5 ms (2026-11-09). NSGo's samples spent frames in AppKit's window layout pass (`_findAnySubviewNeedingAutoLayoutEngine`), which NSH's do not | | GTK frames | `performance.md` (Linux) | The DataTable's scroll costs on Linux what NSH's does (5.5 ms a frame and 51% of a core against NSH 0.5.0's 1.6 ms and 22–23%), and its ticks and the stack's slides too (16% and 10% against 9% and 7%, 2026-11-12); most of a scrolling frame is GTK's own snapshot and rendering under its main loop | | Windows and Android | `data-table.md` (Performance) | The DataTable's scroll and the stack's slides on Windows (41–44% and 28–29% against NSH 0.4.0's 30–32% and 20–22%, 2026-11-09; 0.5.0's waits for a signed-in session) and the DataTable's scroll on Android (118–126% against NSH 0.5.0's 110% on the emulator, its ticks 69–70% against 68%, 2026-11-12) cost what NSH's do; and on a Pixel 10 Pro the table holds about NSH's ~870 views, commits at 3 and 7 ms at the median and 90th percentile, and slides on whole pixels | | Android list frame pacing | NSGo's [#358](https://github.com/nsgo-dev/nsgo/issues/358) | Trace the custom fling and a platform list with recycled, variable-height text rows on physical 60 and 120 Hz devices, comparing frame intervals and missed frames; the reported uneven scrolling has not been profiled | | Partial frames on Windows, Android and the web | `windows.md` (Partial frames), `canvas.md`, #1661 | A Windows canvas redraws only what its animated values change, skipping paints that cannot change a pixel, and a view outside a frame's damage paints none of its own decoration; Android's and the web's canvases redraw only the changed area too, where they redraw the whole canvas now | ## Services and components since 0.4.0 What NSH added between 0.4.0 and 0.5.0 that NSGo has not, in the order to build it. | Item | NSH reference | Done when | | --- | --- | --- | | Notifications on screens | #931, #1373 | With the permission granted, a notification shows, its press reaches the app and the badge shows on a Mac, an iPhone, Windows in a signed-in session and an Android 13 device, and a toast pressed after the app ended starts it through a COM activator; so far Linux and the Android emulator (API 29) showed and closed one, macOS, iOS's simulator and the web answered the permission without asking, and Windows, over SSH, reached its notifier, which reports the platform unavailable there (2026-11-12) | | Sounds and audio | `audio-design.md` (The API, The platforms) | A sound `audio.LoadSound` loads and an `audio.Player`, NSH's `AudioPlayer`, play on macOS, iOS, Windows, Linux, Android and the web as [audio playback](architecture/audio.md#delivery) says issue #36 closes, and the gallery gives each kind of moment a sound; so far the package, core's part and `nsgotest`'s fake exist, macOS and iOS play them, iOS not yet on a device, and every other platform reports `Env.CanPlayAudio` false (2026-11-15) | | Haptics felt | #1328 | `mobile.PlayHaptic` is felt on an iPhone and an Android phone; so far it ran in the iOS simulator and the Android emulator, which have none (2026-11-12) | | Biometric authentication | #55 | `core` asks for enrolled Face ID, Touch ID or Android biometrics and reports authentication results through LocalAuthentication and BiometricPrompt, with nsgotest fakes and sandbox capability checks | | More of a web view's loads | #1038, #1028, #1233, #1496, #1439 | A load carries the app's request headers, `Incognito` keeps the website data in memory, the app serves URL schemes of its own to its pages, a page from the app's own files loads on macOS, and `Env` says where the platform shows no web view | | Microphones and cameras in web views checked | #1559 | A page of a web view with `Media` records with the microphone and the camera once the user allows it on a Mac, an iPhone, an Android phone and in Chrome, and refuses a device left out; so far Linux's WebKitGTK with its mock devices and WebView2 with Chromium's fake ones were checked by their native tests, and on the Android emulator (API 29) a page asking for the microphone brought up the system's prompt, reached the device once `RECORD_AUDIO` was granted, whose emulated microphone could not be read, and was refused the camera (2026-11-15) | | Selections as Markdown and HTML | #1045 | A selectable area's selection reads as plain text, Markdown or HTML, as the text view parsed it | | Where links go | #1370, #1126 | Hovering a `Link`, a text view's link or a rich editor's shows where it goes, its host kept whole and its path shortened, in the hint overlay, and a link's press reports the modifier keys held | | An emoji picker | `components.md` (Emoji pickers) | `base.EmojiPicker` searches every emoji by its names in the app's languages, its words through `base/locales`, with a styled form in `ui` | | Rich text by touch | `rich-editor.md`, #1368 | A `RichEditor` selects by touch with handles and the system's edit menu on iOS and Android, as inputs do | | SVG on canvases | `canvas.md`, #1291 | A `Drawing` draws an SVG image at a size, its text drawn by the platform's text engine | | Scroll handles on phones | #1401 | A long scroll view on iOS and Android shows a handle the user drags along either axis | | Layout springs by their physics | `api-naming.md` (Spring), #1305, #1553 | A layout transition's spring takes a response and a damping ratio, as gpui-base's `Spring`, and runs until it settles rather than for a duration, and a spring given a new target moves on from its last frame | | The mouse's release | `elements.md` (`onMouseUp`), #1446 | `OnMouseUp` reports which button was released over a view on the desktops and the web, so a canvas can open its menu on a secondary click's release | | Pointer variants | `styles.md`, #1539 | `pointer-fine:` and `pointer-coarse:` classes style a subtree for a mouse or a touch screen, as CSS's `pointer` does, chosen by the app's classes rather than by `core` | | Icons in native menus | #929 | A `desktop.MenuItem` shows an icon in macOS's, Windows' and Linux's menus | | Image memory | #1330, #588 | The app sets how many encoded image bytes stay in memory, and every backend's cache keeps to it; web, mini-program and HarmonyOS canvas caches and Windows/Linux shader texture caches still need bounds | | Pixel buffers everywhere | `images.md` (Pixel buffers), [#107](https://github.com/nsgo-dev/nsgo/issues/107) | An `Image` whose `ImageSource.Pixels` are rewritten at every display frame shows each frame with none blank at 960x540 and 1920x1080 at 60 fps on macOS, Windows and Linux, its cost recorded as in `performance.md`; Android and the web swap each frame's PNG in place with no blank frame, where today each version loads as a new image, blank until it decodes; a hidden or minimized window copies no pixels, as #107 asks, where today the core copies every version it commits; Android's, HarmonyOS's and mini programs' canvases draw pixels, and HarmonyOS and mini programs show them in image views; so far the core copies pixels once per version for image views and canvases, Apple, Windows and Linux draw them at once, the web and Android through a PNG, and only Apple's image views and Linux's drawing were checked, headless (2026-11-17); Windows was only built | | A terminal backend | `tui.md` | An app runs in a terminal, its views drawn in cells and its keys, mouse and resizes read from it, under `nsgo dev` and `nsgo test`; `base/terminal` stays the terminal shown inside an app | | The app's address on the web | `web.md`, #982, #1158, #1447, #1448 | A web app reads and sets its address, each set a history entry when it asks, so a reload or a shared link opens the page it names, and a back onto the page's own entry leaves the app | | Published sites | #1130, #997 | `nsgo build -target web` writes a site: headings are `h1` to `h6`, links `` a middle click opens, each page has its title and description, and the files can be served from a CDN's URL | | Packaged Apple apps' logs | `macos.md` (Packaged apps' logs), #1655 | A macOS or iOS app opened from Finder, the Dock or the Home screen writes its warnings and errors to the unified log under its bundle ID, reached through purego, where its stderr goes nowhere now | | Package settings | #1654, #1548, #1460 | `nsgo.yaml` raises an Apple package's minimum system version, never below the runtime's, gives Windows, Linux and Android icons of their own, and lets an Android app load plain HTTP | | Store uploads | `tooling.md` (Releases), #1052, #1054 | A command uploads the store packages `build -channel store` makes to TestFlight and Play's internal track, named apart from `nsgo publish`, which signs TSX packages | ## Remote push NSGo's own, beyond NSH's notifications: a server reaching the app ([remote push](architecture/remote-push.md), [#59](https://github.com/nsgo-dev/nsgo/issues/59)), waiting on its [open question](../ARCHITECTURE.md#open-questions). | Item | Reference | Done when | | --- | --- | --- | | Remote push notifications | APNs, Firebase Cloud Messaging | An iOS app, a macOS app and an Android app register, report their token and receive a data push and a pressed notification's payload from APNs' sandbox or a test FCM project, through one provider-neutral `core` API | ## Sign-in sessions NSGo's own, beyond NSH: OAuth sign-in in the system's authentication session ([sign-in sessions](architecture/services.md#sign-in-sessions), [#355](https://github.com/nsgo-dev/nsgo/issues/355)). | Item | Reference | Done when | | --- | --- | --- | | Sign-in on devices | `ASWebAuthenticationSession`, RFC 8252 | On an iPhone, a Mac, Windows, Linux and in Chrome a PKCE sign-in against a test provider returns its callback with its `code` and `state`, and closing the session answers cancelled; so far `core`, `nsgotest`, TSX and the gallery ran headless and the loopback server answered real requests in its tests, and the macOS, iOS, tvOS, Windows, Linux and web backends were only built (2026-11-16) | | Sign-in on Android | Custom Tabs, `Intent.getData` | The runtime opens the URL in a Custom Tab, falling back to the browser, and an activity it declares for the app's scheme hands the redirect back, once [the app's own links](#widgets) and [opened links elsewhere](#app-clips) reach a running Android app; a session ends unavailable there now, with `classes.dex` rebuilt | | Google's ID tokens on Android | `androidx.credentials`, `GetGoogleIdOption` | Credential Manager signs in with Google, which needs a Google library and so waits on the same adapter decision as FCM ([remote push](architecture/remote-push.md#open-decisions)); the session above serves other providers | | The app's own scheme on desktops | #262 | Windows and Linux catch a redirect to a scheme the app registers, once #262 lets one reach the running app, where they serve loopback redirects alone now | | Sign-in on watchOS | `ASWebAuthenticationSession` | The SwiftUI host starts a session from watchOS 6.2, where a session ends unavailable now; tvOS has no such session | | Popups their provider cuts off | `Cross-Origin-Opener-Policy` | A web sign-in completes with a provider whose page sends a COOP that cuts the popup off from the page, which then reads the popup as closed and ends the session cancelled: the page served at the redirect hands its address back over a `BroadcastChannel` instead | | Sign-in in mini programs | `wx.login` and the platforms' own | A mini program signs in through its platform's login, where a session ends unavailable now | ## Location and motion NSGo's own, for [#56](https://github.com/nsgo-dev/nsgo/issues/56) ([location and motion](architecture/location-motion.md)): fixes, streams and motion samples, scoped to the code that asks, under `core.PermissionLocation`, `PermissionBackgroundLocation` and `PermissionMotion`. | Item | Reference | Done when | | --- | --- | --- | | Location and motion on phones | `CLLocationManager`, `CMMotionManager`, `LocationManager`, `SensorManager` | The gallery's System page, the permission granted, gets a one-shot fix and a stream and accelerometer, gyroscope and device-motion samples at the rate it asks on an iPhone, an Android 9 device and one on API 31 or later, a phone lying face up reading +9.81 m/s² on z on both; a denied permission reaches the app as denied, and `nsgotest` grants, denies and feeds fixes and samples headless; so far `core`, `nsgotest`, TSX and the gallery ran headless, and a probe on Android 12 on a Pixel 3 XL, fed a test provider's fixes, read the permissions without a prompt, asked for location with the system's, got a fresh fix, a precise background stream that kept the app running after its task was removed and ended it when stopped, a coarse cached fix marked approximate, and accelerometer and device-motion samples reading +9.8 m/s² on z lying face up; the iOS backend was only built (2026-11-16) | | Location on Macs and TVs | `CLLocationManager` | A notarized macOS build and a Mac App Store build get fixes, with the location entitlement `nsgo build` claims, and a tvOS app a one-shot fix, its streams reporting unavailable; so far a macOS build wrote `UIBackgroundModes` as an array, read location as not asked without a prompt, failed a fix without it as not allowed and answered motion unavailable (2026-11-16) | | Location and motion elsewhere | Geolocation API, `DeviceMotionEvent`, `Windows.Devices.Geolocation`, GeoClue | The web, Windows and Linux give location fixes, and the web motion samples, where they report both unavailable now | | The sensors' settings | `UIApplicationOpenSettingsURLString`, `Privacy_LocationServices`, `ACTION_APPLICATION_DETAILS_SETTINGS` | `OpenPermissionSettings` opens location's and motion's settings on macOS and Android too, where only iOS opens the app's page now | | More sensor services | `CLMonitor`, `CMPedometer`, `TYPE_STEP_COUNTER`, `CMAltimeter` | Geofencing, steps, activity recognition, the barometer, a temporary precise-location request and bounded background motion get scoped APIs of their own | ## Bluetooth NSGo's own design for [#58](https://github.com/nsgo-dev/nsgo/issues/58) ([Bluetooth Low Energy](architecture/bluetooth.md)), which waits on its [open questions](../ARCHITECTURE.md#open-questions). | Item | Reference | Done when | | --- | --- | --- | | Bluetooth Low Energy | Core Bluetooth, Android's `BluetoothLeScanner` and `BluetoothGatt` | A provider-neutral central-role API covers scanning, GATT discovery, reads, writes and subscriptions on iOS, macOS and Android, every other target reporting it unavailable through `Env`, with background behavior following the Android lifecycle decision; so far only the design exists, its questions open (2026-11-15) | ## Keyboard, popups and screen readers What 0.5.0 changed in how the keyboard's focus, popups and assistive technology behave, which NSGo's `core` and `base` follow from 0.4.0 still ([interaction](architecture/interaction.md), [components](architecture/components.md)). | Item | NSH reference | Done when | | --- | --- | --- | | Context menus from any input | `elements.md`, #978, #1098, #1544, #1555, #1610 | The menu key, Shift+F10 and a screen reader's menu action open a view's context menu; a held finger or pen opens a `ContextMenu` on any device and a mouse never; a secondary click outside closes overlays; a second one on the trigger opens it again where it lands; and `ContextMenuEvent` names its pointer | | Modified keyboard activation on mobile | [#398](https://github.com/nsgo-dev/nsgo/issues/398) | Focused pressables on Android and iOS/tvOS receive Space and Return from a physical keyboard with their modifiers after the keymap; Android currently falls back to native key dispatch, and iOS/tvOS handles the remote's select without keyboard modifiers. Desktop and web checkbox callbacks preserve them, while watchOS and mini programs have no physical-keyboard activation path | | Software Return on iOS | NSGo's [#414](https://github.com/nsgo-dev/nsgo/issues/414); `ios/input.go` | A software keyboard's Return reaches `KeyAlways` before `textFieldShouldReturn:` or a text view's newline submits or blurs it; Android's IME actions and committed newlines use its hardware key matcher, while iOS still matches only hardware keys | | Key downs on mobile | [#287](https://github.com/nsgo-dev/nsgo/issues/287), [interaction](architecture/interaction.md#keyboard-focus) | A focused `View.OnKeyDown` hears a physical keyboard's keys and modifiers before the keymap on Android (`NsgoView`'s `dispatchKeyEvent`, which needs a synchronous answer from Go through the Protocol) and iOS/tvOS (`pressesBegan`), consuming the key when it returns true, as on desktops and the web; both report nothing now, and `nsgotest` delivers it in every environment | | Mobile test editing keys | NSGo's [#414](https://github.com/nsgo-dev/nsgo/issues/414), [#415](https://github.com/nsgo-dev/nsgo/issues/415) | iOS's test host routes Return and Backspace through the software keyboard and select-all directly, and Android's test agent offers Control shortcuts to the editor before the root keymap; align their native editing paths with `KeyAlways` and run the shared `internal/testhost/testdata/keys` regressions there, as on desktops | ## From NSGo's issues What NSGo's own issues ask for beyond NSH's releases, each issue where its design is discussed. | Item | Reference | Done when | | --- | --- | --- | | Mention completion in Composer | [#46](https://github.com/nsgo-dev/nsgo/issues/46), [mention completion](architecture/mention-completion.md) | The test that presses a row, run with `nsgo test -target` in the iOS simulator and the Android emulator, where the platform's own keyboard-dismissing tap runs, finds the row inserted and the field still focused | | Scheduled notifications | [#356](https://github.com/nsgo-dev/nsgo/issues/356) | On an iPhone and an Android phone, the app killed, a notification scheduled a minute ahead shows, showing it again by its ID moves it, closing it stops it and its press starts the app with its ID; on Android a pending one shows after a reboot, exact with `SCHEDULE_EXACT_ALARM` granted and within Doze's window without it; and a Mac in an app bundle and Windows in a signed-in session show one with the app quit; so far it ran only in `nsgotest` and pure-logic tests, and the backends were only built (2026-11-16) | | A rotation's safe area with its size on iOS | [#275](https://github.com/nsgo-dev/nsgo/issues/275) | The iOS backend, which reports the safe area from `safeAreaInsetsDidChange` and the size from `layoutSubviews` as separate messages, sends a safe area that changes with the size together with it through `ResizeWithEnvironment`, as Android's `RESIZE` carries it, and an iPhone rotated under a probe never runs an effect with one orientation's safe area and the other's size | | Videos the platform pauses | [#276](https://github.com/nsgo-dev/nsgo/issues/276), [videos](architecture/native-views.md#videos) | Windows' drawn bar, GTK's controls and the browser's report the pauses and plays they make through `Video.OnPause` and `Video.OnPlay` and keep them until `Paused` changes, as Apple's and Android's backends do; and on an iPhone a call, unplugged headphones and Control Center each report once with their reason, the call's video playing on as it ends; and unplugged headphones on an Android phone; so far a Mac checked the player's own pause and play, a Pixel its controls, an alarm's transient focus, which played the video on, and another app's lasting one, and iOS's are built and run on no device (2026-11-16) | | Finished videos on every player | [#443](https://github.com/nsgo-dev/nsgo/issues/443), [videos](architecture/native-views.md#videos) | `TestFinishedVideoWaitsForReplay` passes on iOS, tvOS and Linux: a finished video stays stopped through unrelated properties, a pause followed by play replays it, a seek resumes at its target only while unpaused, and another source opens afresh; it passes on macOS, Android 28 and 35 emulators, headless Chrome and, with a video-only MP4 in place of its WAV on a machine with no audio device, Windows 11, while iOS and tvOS have only been built, and Linux's native suite covers configuration, replay, seek and a replay from GTK's controls (2026-11-17) | | Transparent videos everywhere | [#569](https://github.com/nsgo-dev/nsgo/issues/569), [videos](architecture/native-views.md#videos) | A transparent clip shows the views behind it on Android (a `TextureView` that is not opaque, where a decoder keeps the alpha), the web (`