Changelog
All notable changes to ShieldPress Terminal are documented here.
Source of truth in the app repo: root CHANGELOG.md (keep in sync when publishing to GitHub Pages).
[Unreleased]
Removed
- Gift / promo code redemption and its one-time redeem service. The app no longer contacts any ShieldPress server; it works fully offline except for connections you start to your own servers.
Changed
- Rewrote the Privacy Policy and Terms of Use for worldwide use (GDPR/UK GDPR, CCPA/CPRA, children, user rights, governing law, EULA), and updated the Disclaimer, Refunds, Security and purchase pages to match.
[1.0.4] - 2026-11-02
Added
- Credential Vaults: organize saved passwords and SSH keys, reuse credentials across hosts, attach multiple accounts to a host, and select an account when opening a terminal. Reconnect retains the selected account.
- Broadcast from Assistant: select connected sessions, review the exact command and accounts, and see delivery results for each session. Failed sends are not automatically retried.
- Master Password app lock, cold-start/background locking, Lock now, and persistent failed-attempt throttling alongside biometric unlocking.
- Android Mosh preview: authenticated SSH bootstrap, native UDP sessions, source-port roaming, link-contact status and complete terminal screen snapshots. Requires mosh-server, a UTF-8 locale and reachable server UDP ports.
- Android X11 preview: authenticated SSH forwarding to an offline in-app display, example GUI commands, live connection status, collapsible controls and keyboard input. Requires X11Forwarding, xauth and GUI applications on Linux.
- Optional standalone ShieldPress Preview Android build, installed alongside the regular app.
Changed
- Move SSH/Mosh selection, X11 and Broadcast into Assistant to preserve terminal space.
- Vault-aware encrypted backups (payload v2) include credential profiles and host links; legacy backups remain readable. Schema v6 adopts existing host credentials without moving secrets out of SecureStore.
- Editing a host’s login details creates a separate credential when needed, protecting shared credentials on other hosts. Deleting a host retains its vault credentials.
- Parse visible ANSI output once, merge equivalent text styles, batch SSH/Mosh UI updates and group X11 bridge packets to reduce rendering overhead.
- Keep Master Password state and biometric preferences device-local during backup/restore.
Fixed
- Honor ANSI screen erase/reset controls, including clear sequences split across native reads, and retain active text styles after clearing.
- Follow committed output size when auto-scrolling, avoiding scroll/layout races.
- Adjust the Android terminal layout around the software keyboard to keep the command composer visible.
- Deliver X11 Expose events to mapped child widgets when their parent becomes visible, fixing blank windows in applications such as xclock.
- Prevent stale X11 display messages and queued Mosh frames from repainting a stopped or cleared view.
Platform notes
- Vaults, Multiple Credentials, Broadcast, Master Password and terminal rendering changes use shared iOS/Android code. The iOS build and keyboard behavior still require device validation.
- Mosh and X11 are Android previews; native iOS support is not included. X11 is a basic 800×600 display with a US keymap, no window manager or GLX. Mosh recording is not supported in this preview.
- Master Password protects access to the app; it is not an additional vault-encryption key and has no recovery mechanism. Backups use their own encryption password.
[1.0.3] - 2026-10-22
Added
- Dedicated LAN Scan workspace with saved discovered devices, scanned IPs, search, and scan history.
- Skip addresses already checked for the same network and SSH port, with an option to rescan them.
- Animated scan progress with a background track, percentage badge, and checked-address count.
- Clear scan logs with confirmation; clearing removes saved scan results and history while keeping saved servers.
- Compact icons for Devices, Scanned IPs, and History tabs.
Changed
- Open LAN Scan from the Connections header; hide it from the bottom navigation bar.
- Disable clearing scan logs while a scan is running.
[1.0.2] - 2026-10-22
Added
- Scan LAN: select a network interface and SSH port, discover devices, and prefill new server connections from results.
- Local Network permission guidance and a shortcut to system Settings when access is blocked.
- Choose individual servers when exporting backups, including only their credentials and related server data.
Changed
- Manual backup export and import, including encrypted backups, are available on the Free plan.
- Free backup restores reject files containing more than 10 servers before changing saved data. SSH config imports reject selections that exceed available connection slots.
- Terminal command entry uses the composer: type first, then press Enter or Send to execute.
Fixed
- Align both terminal panes on iPad and synchronize their special-key toolbar height.
- Ignore empty and duplicate command submissions to prevent repeated shell prompts.
- Stream Android SSH output without waiting for a newline; preserve UTF-8 and keystroke order.
- Render horizontal shell edits, backspace, carriage returns, and line erasure consistently.
Added
- Connection diagnostics: per-stage native events and timing, last 20 in-memory reports, and redacted sharing from Settings / failed connection modal.
- Optional named tmux sessions: check availability and create/attach when connecting or reconnecting.
- Standalone SFTP connection from Files with biometric gating and host-key verification; no Terminal window required.
- Remote save review, content conflict detection, verified staged upload, same-directory rename and retained recovery copy. Uncertain mutations are not automatically replayed.
- One-hop SSH jump hosts for Terminal, SFTP and metrics; loopback-only forwarding, destination/bastion trust and parent cleanup.
- Multi-hop jump hosts: a server’s jump host may itself have its own jump host, chained up to 4 hops total; cycle detection and the hop cap are enforced both in the jump-host picker and at connect time.
- Standalone port forwarding: Server → Info → Port forwarding opens a loopback port on the device to
remoteHost:remotePortas seen from that server, over its own dedicated connection (never the Terminal/SFTP session). Per app-session only — not persisted. - Keyboard-interactive MFA/OTP: a real second interactive prompt (not the password-as-keyboard-interactive fallback) is relayed to a text-entry dialog and its answer sent back to the native auth. Never shown for silent background connects (metrics) — those just fail that attempt.
- OTA updates (
expo-updates): Settings → About → Check for updates.runtimeVersionuses thefingerprintpolicy, so a build with different native code (like this one) can never be offered a JS-only OTA — enforced automatically, not just by convention. Applying a fetched update always asks first and warns how many Terminal sessions are open; it never reloads silently. - Per-server resource alerts: a server’s connection settings can enable RAM/CPU/disk threshold notifications (fixed 90%). Checked only while the app is foregrounded, sequentially over its own dedicated silent connections (never the Terminal/SFTP/metrics session), with a per-server cooldown so a sustained breach alerts once and re-alerts only after recovering and breaching again. No real background variant — see Limits for why.
- Server schema v4:
alerts_enabled. - Server schema v3 and backup support for tmux / jump-host settings.
- ANSI color rendering: terminal output now parses SGR sequences (16/256-color, RGB truecolor, bold/dim/italic/underline/strikethrough/reverse) into styled text instead of stripping every escape sequence to plain monochrome. Non-color CSI (cursor moves, clear-screen) and OSC (title) sequences are still dropped, since output is one scrolling text buffer, not a cursor-addressable grid. Search mode falls back to plain highlighted text rather than mapping match offsets onto colored segments — a deliberate simplification, not a bug.
- Hardware-keyboard shortcuts (partial): with an external/Bluetooth keyboard (iPad, or an iPhone in a stand), physical Up/Down arrows recall command history in the input field, and Escape closes the output search bar. Modifier-combo shortcuts (Cmd+K/F/W and similar) are not included — React Native’s
TextInput.onKeyPressdoesn’t reliably expose modifier state across platforms, and adding real Cmd/Ctrl detection needs a native hardware-keyboard module this repo doesn’t have; deferred rather than shipped half-working. - Landscape keyboard-bar polish: the on-screen special-keys row (Esc/Ctrl/arrows/F-keys/…) now renders shorter/denser when the device is in landscape, so it takes noticeably less of the limited vertical space left once the software keyboard is also up. Layout logic is
width > height, so it also applies correctly to a Split View/Slide Over pane on iPad.
Added (Premium)
- Custom two-level resource alerts: Premium can set a per-server warning stop and critical stop (instead of the fixed 90% single level free plan gets), each 50-99% and at least 5 points apart. Escalation (warning→critical) always fires; de-escalation while still breached (critical→warning) stays quiet — same incident, not a new one; full recovery below the lower threshold resets both. Free plan ignores any stored custom values regardless of trial history — server-side default (
DEFAULT_THRESHOLD_PERCENT = 90) is enforced at the monitoring layer, not just hidden in the UI. Server schema v5:alert_warn_percent,alert_critical_percent. - Automatic encrypted backups (Premium): Settings → Backup → Automatic backups. Enabling it asks once for a password (stored only in the device secure keychain/keystore, same trust boundary as the existing credential store — never written to SQLite or a backup file’s own metadata) and a Daily/Weekly interval. Runs a full encrypted backup (same format as manual export) shortly after you open the app, at most once per interval — foreground-triggered only, same reasoning as resource-alert monitoring: iOS gives no reliable window for a background task to do this. Backups land in the same “Recent backups” list as manual exports.
- Session recording & playback (Premium): record a Terminal window’s raw output from the ✨ Assistant menu (“Record session”). Writes are batched to disk every 500ms (not per output chunk) as timestamped frames, auto-stops at 5MB, and keeps the 10 most recent recordings (Settings → Session recordings). Playback replays the captured frames at 1×/2×/4× speed (each frame’s wait capped at 1.5s so an idle stretch doesn’t stall playback for real minutes); ANSI codes are stripped for the plain-text player. Recordings can be shared via the OS share sheet or deleted.
- Search across every open session (Premium): Sessions tab → search icon. Searches the visible scrollback of every open session at once (not just the current tab), showing match count and a short context snippet per session; tapping a result opens that session. Free tier keeps the plain session list; tapping search shows an upgrade prompt.
- Quick-command variables (Premium): Quick Commands (Server → Snippets tab) finally has a create/edit screen — it existed in the service layer (
createQuickCommand) but had no UI to reach it before this pass; addedupdateQuickCommandtoo. Wrapping a word inturns it into a fill-in-the-blank prompt each time the command runs (both from the per-server list and the Terminal's ✨ Assistant → Quick commands panel). Free plan can still create/view/run plain quick commands (unchanged, always free) but running one containing ashows an upgrade prompt instead of sending broken literal text to the shell. PlanCompareTable.tsxand the Premium screen’s trial/purchase copy updated to list all five Premium additions from this session.
Considered and declined (this pass)
- Custom app icon (Premium): the only community Expo plugin for this (
expo-dynamic-app-icon) hasn’t been updated since mid-2023 — multiple Expo SDK majors before this app’s SDK 57 — and adding it can’t be verified in this environment (no Xcode/Android toolchain to test a prebuild against). Writing a bespoke native module for a purely cosmetic feature carries the same unverifiable-native-change risk for less justification. Deferred until either the community plugin is updated or this can be tested on a real device/CI.
Fixed (light/dark follow-up 2 — button text contrast + compare table)
constants/theme.ts: addedcolors.onAccent('#FFFFFF'in both palettes) — the correct, theme-independent text/icon color for anything painted with a solidcolors.primaryorcolors.errorfill, since those two colors are the same fixed hex in both themes (unlike backgrounds/text, which do flip). My previous pass’scolors.background/colors.textfixes for the Send/Save buttons were themselves wrong for the same reason —colors.backgroundis a light gray in light mode, nearly invisible on orange. Both now usecolors.onAccent.- Swept every other solid-
colors.primary-background button/chip/badge/FAB in the app for the same bug (icon or text coloredcolors.text, unreadable or low-contrast against orange in light mode) and moved them tocolors.onAccent: the sharedButton.tsx(used by nearly every screen’s primary/danger actions),AppDialog.tsx’s primary dialog button,AppLockGate.tsx’s unlock button,PlanUsageBar.tsx’s upgrade chip,TerminalAssistant.tsx’s ✨ FAB (when active),TerminalView.tsx’s send button and active search-match highlight,server/[id]/terminal.tsx’s Connect/Reconnect button,server/[id]/info.tsx’s accent chips,server/[id]/editor.tsx’s Save button,EditorActionBar.tsx’s Assist chip,(tabs)/index.tsx’s add-server button, andGroupPicker.tsx’s add-group button. PlanCompareTable.tsx’s alternating-row stripe was a fixed dark-navyrgba(23,29,40,0.45)— over the light theme’s near-white panel this reads as a muddy gray wash that dulls the row’s own text (this was the “chữ bị làm mờ / xám nhẹ” the user reported). Now derived fromcolors.textat low alpha, which inverts per theme. Also switched the Premium column’s hardcoded yellow tint to acolors.favorite-derived one for the same reason (consistency, not a contrast bug per se).
Fixed (light/dark follow-up)
- Send button (Terminal) and Save button (Editor) painted their icon/label in
colors.texton a fixed-orangecolors.primarybackground — in dark modecolors.textis near-white, giving weaker contrast against the mid-luminance orange than the near-black light-mode variant. Switched both tocolors.background, which inverts per theme and matches the same fix already used by the search-match highlight (TerminalView.tsx’smatchActivestyle). SessionCard.tsx’s animated “connected” sheen was a fixedrgba(255,255,255,0.14)glint — nearly invisible over the light theme’s white card background. Now derived fromcolors.text(inverts per theme) so the effect stays visible in both.
Fixed (this pass)
- Assistant sheet’s main menu (the ✨ button — Layout/focus, Special keys, history, Connect/Disconnect, Ctrl shortcuts, …) wasn’t wrapped in a
ScrollViewlike every other panel in the same component; on a short viewport (landscape, or with the software keyboard open) the bottom items were pushed off-screen with no way to scroll to them.TerminalAssistant.tsx’s menu panel now scrolls like the rest. - Several dialogs/badges hardcoded a dark tint hex (
#2A1A0C,#2A2410,#2A1212,#3A1515, …) for an icon/badge background designed to sit on a dark panel; on the light palette these rendered as an out-of-place dark square instead of a soft tint. Replaced with an alpha-suffixed version of the matching semantic color (${colors.success}22, etc.) so the tint follows whichever tone/theme is active:AppDialog.tsx(tone icon badges, destructive button, modal backdrop),ConnectionProgressModal.tsx(error box + backdrop),CodeEditor.tsx(lint issue bar),PlanCompareTable.tsx/PlanUsageBar.tsx/settings/premium.tsx(Premium badges),server/[id]/editor.tsx(unsaved-changes badge). - Note: the app’s light/dark palette itself is still decided once at process start from the OS setting (
constants/theme.ts) — not reactive to an in-session OS theme flip, and there’s still no manual Light/Dark/System override in Settings. That’s a larger, separate architectural change (most screens’StyleSheet.createcalls would need to move from module scope to a theme-aware hook) and was intentionally left out of this pass.
Fixed
- Verify SHA256 host fingerprints before authentication on both native platforms; reject missing/unapproved keys.
- Compute the iOS SHA256 fingerprint directly from the raw host key rather than relying on an unsupported NMSSH hash enum.
- Local Network permission guidance no longer misclassifies reachability failures as authentication failures.
- Preserve the last iOS address failure; bound sequential address attempts and apply configured native keepalive.
- Clean temporary SFTP read/write caches after use.
- Android build 15 reports:
connectConfiguredinvoked RN callbacks off the native modules queue (could fail in ~30–200ms with nohostKey/authstages); safer timeout parsing; prefer IPv4; emitdns/tcp; prefer keyboard-interactive. - Diagnostics: one report per attempt; shared export includes
failureClass(no raw host/error text). - iOS host-key prompt no longer freezes every other open session.
verifyHostblocked the process-wide serial NMSSH queue on the Trust/Cancel semaphore for up to 120s; any other session’s typing, SFTP,execute, or keepalive queued behind it. The wait now runs off that queue and only rejoins it to finish authentication. - iOS DNS candidate list respects
AI_ADDRCONFIG(skip AAAA with no IPv6 route) and caps candidates; the remaining connect budget is now divided fairly across attempts so an early blackholed address can no longer consume the whole budget and starve the hostname/DNS64 fallback. - iOS
readyTimeoutMsmissing or0no longer silently collapses the connect budget — and the post-connect session timeout derived from it — to 1 second. - iOS empty password is authenticated as a password, not misrouted into the key-auth branch (“Private key is missing”).
- iOS keepalive timer is cancelled before a reconnect replaces it for the same client key (previously leaked and could double-fire
keepalive_send). - iOS SFTP progress callbacks no longer divide by zero for 0-byte uploads/downloads.
- iOS jump-host tunnel pump blocks on
poll()between fds instead of busy-looping every 10ms for the tunnel’s lifetime (battery).
Validation / release notes
- Requires a new native build (16), not an OTA-only update to build 15. This build also introduces EAS Update (
fingerprintruntime-version policy) for the first time — after building 16, runeas update:configureand create thepreview/productionchannels before publishing any OTA update; until thenexpo-updatesis present but inert. - ANSI color rendering, the hardware-arrow-key history recall, and the landscape keyboard-bar layout are JS/TS-only — no native code changed for these three, so (unlike the rest of this release) they are eligible for OTA delivery once build 16 itself has shipped and the fingerprint check has a native baseline to match against.
- Android build 15 redacted reports showed fail in <250ms without
hostKey/auth— consistent with callback/setup failure before a real SSH handshake finished. - Added
npm run test:connection-features; native patch parity checks include jump-host sources. - Device/native release checklist and feature limitations:
docs/CONNECTION_FEATURES.md. - iOS native compile, iPhone network/suspension tests and end-to-end jump-host tests remain required before release.
- Known limitation kept as-is (not touched this pass, too risky to change without a device to validate against): SFTP transfers still share the same serial NMSSH queue as shell writes on iOS, so a large upload/download can still delay typing in an unrelated Terminal session. A second concurrent queue was considered and rejected — it reintroduces the exact
__stack_chk_failclass of crash builds 6–9 fixed. NativesftpChmodstill returns “Not implemented” on iOS; the JS layer already falls back toexecute("chmod …"), which works. - iOS-only known limitation of the new MFA/OTP prompt: libssh2’s keyboard-interactive callback is synchronous and runs inside the active authentication call on the shared serial queue, so (unlike the host-key wait) there’s no safe point to release that queue while the user is typing a code — other iOS sessions queue behind it for however long entry takes, bounded to 60s. Android has no equivalent limitation: each connection already runs on its own dedicated thread, so this only blocks that one connection.
- Secure Enclave-backed SSH keys were considered and are not implemented: Secure Enclave only generates non-extractable P-256 EC keys and can’t import an existing RSA/ed25519 key (the app’s actual import flow), and NMSSH/libssh2’s key-auth API takes a raw PEM string — there’s no path to hand it a hardware-backed key at all without dropping to a custom libssh2 sign callback on iOS (and a parallel Android Keystore implementation), plus a “generate a new key in the app” flow and a different backup story (the key can never leave the device). Flagging this as a separate, larger scoping conversation rather than a partial/simulated implementation.
[1.0.0] — 2026-09-05 (iOS/Android build 15)
Native TestFlight / store build. JS OTA alone is not enough for SSH fixes in this release.
Fixed (iOS SSH — build 15)
- Connect progress steps no longer fill the terminal buffer (modal only)
- Shell MOTD / prompt no longer dropped when UI listeners attach after PTY open
- Wire data listeners right after authenticate, before
openShell - Password auth falls back to keyboard-interactive (common on Ubuntu / cloud images)
- Sanitize
NSNullpassphrase / publicKey from the JS bridge (key auth) - Prefer IPv4 then IPv6 then hostname (DNS64 / IPv6-only cellular); shorter per-address timeout
- Replace NMSSH’s useless
absence of an active session/failed, with sessionwith a clear reachability message - Serialize NMSSH connect/write/exec on one queue (crash with metrics); keep shell I/O off that queue so typing is not starved
- Pause metrics while connecting; hold metrics off while an interactive shell is open
- Local Network usage string +
_ssh._tcp.Bonjour for LAN VPS on iPhone/iPad
Added / improved (editor & terminal UX)
- Local Editor tab (between Sessions / Snippets) with the same editor chrome as remote files
- Editor action bar: copy / paste / color presets; separate editor FG/BG (default white background)
- Syntax highlight for light editor theme; Assistant inserts for editor mode
- Connection progress modal (step list) for Connect / Reconnect
- Transfer history panel for SFTP; connection progress store
- Terminal focus revive (
resumeOnFocus, remountTerminalView) to reduce blank screen after leaving the tab - Buffer caps / total budget so many long-running terminals use less memory
Tooling
npm run verify:ios-ssh— patch / plugin / plist /tscgate before EASnpm run test:ssh-preflight— broader local preflight (42 checks); cannot replace a device SSH test
Notes
- App is already React Native + Expo SDK 57 (dev client / EAS). Expo Go cannot ship the custom SSH native module.
- Staying on Expo does not by itself make SSH smoother; smoothness comes from native I/O, buffer limits, and serialising libssh2 — which this build targets.
[1.0.0] — earlier TestFlight builds (6–14)
Fixed
- Build 6 crash: concurrent connect + metrics (
__stack_chk_fail) - Builds 7–9: serial NMSSH queue (later refined so shell read does not block writes)
- Build 10: “connected but cannot type” (shell was on the same serial queue as
writeToShell) - Builds 11–12: IPv4 preference + clearer connect errors; Local Network permission
- Build 13–14: candidate host list + auth hardening (superseded by 15)
Added (product baseline through early TestFlight)
- 30-day free Premium trial (one per device)
- In-app policy links → GitHub Pages (
LEGAL_URLS) - Public docs: privacy, terms, disclaimer, security, refunds, guide, purchase pages
- Offline Gift Code redemption (Ed25519; optional one-time Worker)
- Biometric lock (Face ID / fingerprint) for Connect and backup export
- Live server metrics: RAM, CPU, DISK, net down/up (hideable)
- SSH host key trust-on-first-use; Known Hosts under Settings
- SFTP upload / download / rename / chmod; mode + owner:group in list
- Auto-reconnect on write failure; Reconnect dialog
- Backup history (5 newest); Clear cache; landscape / tablet layouts
- Terminal special keys, clipboard paste, PTY resize
- Editor line numbers, path header, empty-state CTAs
Security notes (gift codes)
- Guide:
docs/GIFT_CODES.md - Codes signed offline with Ed25519; app embeds public key only
- Optional Cloudflare Worker burn list via
expo.extra.giftRedeemUrl - Promotional free codes — not an IAP substitute
[1.0.0] — 2026-09 (initial product)
Added
- Local-first SSH terminal, SFTP browser, and remote file editor
- Server list, sessions, snippets / quick commands
- Lifetime Premium gates (connections, windows, encrypted backup)
- Settings hub (Premium, Terminal appearance, Backup, About)
- Custom in-app dialogs (no system
Alert) - EAS profiles; app icon / splash (
#DF7B19)