Neon Vision Editor

A native editor for markdown, notes, and code across macOS, iPhone, and iPad.

Minimal by design. Quick edits, fast file access, no IDE bloat.

Download: GitHub Releases · App Store · TestFlight

Status: active release
Latest release: v0.9.6 Next release target: v0.9.8 Platform target: macOS 26 (Tahoe) compatible with macOS Sequoia Apple Silicon: tested / Intel: not tested Direct GitHub release: v0.9.7 / App Store and TestFlight availability varies by platform and review status Last updated (README): 2026-07-24 for latest release v0.9.6

• v0.9.7: Makes macOS document opening, session restoration, preview changes, and external refreshes safer on current macOS releases by avoiding synchronous TextKit and AppKit layout work during a document transition.
• v0.9.7: Preserves the editor context after a document transition—line numbers, minimap, caret position, scroll position, and visible source—without asking AppKit to lay out the editor while it is already tracking a layout pass.

• Coalesces the final editor refresh into one post-layout operation, keeping document changes responsive while the source pane, preview, sidebar, line numbers, and minimap settle together.

• v0.9.6: Restores each macOS editor window at its own last-used size and position without briefly showing the smaller fallback window first.
• v0.9.6: Makes the larger first-launch window size a fallback only; once you resize a window, that exact visible frame is retained for the next launch.

• When several editor windows were open, macOS now restores their individual frames after you choose whether to reopen all windows or only the first.

• Jump: Install | Features | Contributing
• Quick install: GitHub Releases, App Store, TestFlight
• Need help quickly: Troubleshooting | FAQ | Known Issues

1. git clone https://github.com/h3pdesign/Neon-Vision-Editor.git
2. cd Neon-Vision-Editor
3. xcodebuild -project "Neon Vision Editor.xcodeproj" -scheme "Neon Vision Editor" -destination 'platform=macOS,name=My Mac' build
4. open "Neon Vision Editor.xcodeproj" and run, then use Cmd+P for Quick Open.

Start Here · Release Channels · Core Workflows · Download Metrics · Project Documentation · Features

Release Spotlight · Platform Matrix · Roadmap (Near Term) · Troubleshooting · FAQ · Changelog · Contributing Quickstart · Support & Feedback

Channel	Best for	Delivery	Current status
	Direct notarized builds and fastest stable updates	GitHub Releases	v0.9.7 release docs current; v0.9.7 direct download current
	Apple-managed install/update flow	App Store	Check the platform listing for current availability
	Early testing of upcoming changes	TestFlight	Newest beta availability may vary by review state

Release Download + Traffic Trend

Styled line chart shows per-release totals with 14-day traffic counters for clones and views.

Prebuilt binaries are available on GitHub Releases.

The direct GitHub release is currently ahead of the App Store version. The App Store version may temporarily lag while updates are in Apple review.

Install the latest release directly:

curl -fsSL https://raw.githubusercontent.com/h3pdesign/Neon-Vision-Editor/main/scripts/install.sh | sh

Install without admin password prompts (user-local app folder):

curl -fsSL https://raw.githubusercontent.com/h3pdesign/Neon-Vision-Editor/main/scripts/install.sh | sh -s -- --appdir "$HOME/Applications"

Homebrew detects Neon Vision Editor as a cask, so either command works:

brew install neon-vision-editor

Or use the explicit cask form:

brew install --cask neon-vision-editor

Cask source: Homebrew/homebrew-cask

If Homebrew asks for an admin password, it is usually because casks install into /Applications. Use this to avoid that:

brew install --cask --appdir="$HOME/Applications" neon-vision-editor

The direct macOS build from GitHub bundles an optional nve helper for terminal workflows. It is not included in the Mac App Store build. Install it only when you want a shell command:

1. Open Settings > Support.
2. Copy the Command Line Helper install command.
3. Run it in Terminal to link the bundled helper into $HOME/bin.

nve README.md
nve --wait --new-window "Neon Vision Editor/UI/ContentView.swift"
nve --line 42 "Neon Vision Editor/UI/ContentView.swift" # validates the line flag; cursor placement is not yet supported

Development builds can also link the repository copy:

mkdir -p "$HOME/bin"
ln -sf "$PWD/scripts/nve" "$HOME/bin/nve"

Permission model: the helper is optional and user-linked. It calls macOS Launch Services through /usr/bin/open and does not read file contents itself. Neon Vision Editor handles the document-open request inside the sandbox with user-selected read/write file access and security-scoped file access. It does not require Full Disk Access, Accessibility access, administrator permission, background services, or telemetry. See docs/CommandLineHelper.md.

_{Project Sidebar keeps Files, Search, Git, and Terminal in one stable surface. Remote Sessions stay opt-in and user-triggered. Markdown formatting, preview, and export stay in one contextual flow.}

Neon Vision Editor keeps the surface minimal and focuses on fast writing/coding workflows. Platform-specific availability is tracked in the Platform Matrix section below.

Editing Core

Navigation & Preview

Platform, Output & Customization

Safety & Privacy

• Fast loading for regular and large text files with tabbed editing.
• Files below 100 MB remain editable. The app starts a lightweight file-loading profile at 2 MB and can enable Large File Mode earlier for documents with high character or line counts.
• Large File Mode favors responsive opening, scrolling, and typing: full-document syntax analysis, minimap, preview, symbols, word count, and diff can be deferred or temporarily unavailable. The active mode and file size are shown in the editor status UI.
• Choose Standard for normal processing, Responsive for chunked installation and deferred work, or Plain Text when an unstyled editor is the safest choice for an unusually large document.
• Files at 100 MB or more open as a clearly marked, read-only Partial Open. Neon reads only the first 4 MB, ending at a line boundary where possible; it never loads the full file into the editor buffer or permits saving the partial content over the source.
• Broad Swift 6-ready syntax highlighting (including TeX/LaTeX), inline completion with Tab-to-accept, and regex Find/Replace with Replace All.
• Optional Code Minimap gives a compact file overview, click-to-jump navigation, and a draggable viewport marker without changing the default editor surface.
• Invisible-character markers on iPhone and iPad render in a lightweight overlay so spaces, tabs, and newlines stay aligned while scrolling.
• Trackpad pinch on macOS and touch pinch on iPhone, iPad, and Apple Vision Pro adjust editor font size while retaining the normal font controls.
• Optional Vim workflow support and starter templates for common languages.

• Quick Open (Cmd+P), project sidebar navigation, and recursive project tree rendering.
• The macOS Project Sidebar uses a single Files/Search/Git/Terminal glass rail with clearer active and inactive states, visible Git change counts, compact file-status rows, and a 450 pt default width.
• The macOS project sidebar includes a Terminal tab that keeps output while switching tabs, offers project/home working-directory choices, and provides clear/restart controls.
• scripts/nve opens files from the terminal and supports --wait, --new-window, and --line compatibility flags.
• Find in Files keeps results visible on Mac and iPad when a match opens, while replacement targets start unselected by default.
• Remote Sessions are opt-in: macOS owns SSH-key login and can publish an attach code so iPhone, iPad, and Apple Vision Pro can browse, open, edit, and explicitly save supported remote text files through the Mac-hosted broker.
• Project quick actions (Expand All / Collapse All), recent project folders, supported-files-only filtering, and default ignored heavy folders (.git, .build, node_modules, DerivedData).

• Shared files stay synchronized in already-open tabs when iCloud Drive, a network folder, or another app delivers changes. Clean tabs refresh automatically; dirty tabs require Keep Local, Reload from Disk, or Compare, and the status area reports progress and files needing review.
• iCloud Drive or the network folder provides document transport; Neon Vision Editor observes, refreshes, and protects conflicts without uploading editor contents to its own service.
• Optional iCloud Appearance & Theme Sync keeps appearance, theme colors, custom theme data, formatting toggles, and Markdown preview theme behavior aligned across signed-in devices.
• Appearance-sync status includes the latest local iCloud result and timestamp. That settings service does not sync documents, API tokens, remote sessions, or editor contents.

• Native side-by-side diff view for Compare with Disk and Compare Open Tabs workflows, with change navigation.
• Cross-platform Save As… and Close All Tabs with confirmation.
• Remote saves are explicit and conflict-aware; if the remote revision changes, the app offers a compare-before-reload path instead of overwriting silently.

• Contextual Markdown formatting provides inline actions, five heading levels, lists, quote/code tools, and structural insertion; iPhone presents the full set from a compact Aa control.
• One opt-in toolbar control opens and closes Markdown, HTML, and SVG previews. macOS plus regular-width iPad and visionOS layouts use inline panes; iPhone uses a preview sheet.
• Markdown previews provide 23 templates and GitHub Flavored Markdown support on macOS, iPhone, and iPad. Apple Vision Pro uses dedicated System Glass, Paper, Slate, and Ink reader surfaces.
• .svg files support XML editing, bracket help, and rendered SVG Preview on all platforms.
• Markdown and Swift source exports declare their content types correctly on iOS and iPadOS.
• Unsupported-file open/import safety guards, remote text-file limits, and session restore for previously opened project folder.

• Built-in editor palettes include Neon Glow, Neon Flow, Neon Voltage, Laserwave, Cyber Lime, Prism Daylight, Dracula, One Dark Pro, Nord, Tokyo Night, Gruvbox, Arc, Aurora, Horizon, Midnight, Mono, Paper, Solar, Pulse, and Mocha, plus Custom colors.
• Grouped settings include theme and formatting controls, optional iCloud appearance sync, shortcut customization, and platform-specific preview presentation.
• Code Snapshot exports styled editor captures; AI Activity Log diagnostics remain available on macOS.

• Shared-file sync without a proprietary cloud: keep a document open on multiple devices through iCloud Drive or a network folder, and Neon Vision Editor follows externally delivered changes. Clean tabs refresh automatically; dirty tabs stop for Keep Local, Reload from Disk, or Compare, with progress and review status shown in the editor.
• iCloud Drive or the network folder remains the sync transport; Neon Vision Editor provides the responsive open-tab detection, refresh, and conflict-protection layer rather than uploading document contents itself.
• Major Project Sidebar redesign: a single Files/Search/Git/Terminal glass rail, clearer inactive states, visible Git change counts, and compact file-status rows.
• Markdown editing now has a contextual, collapsible formatting surface with direct inline actions, five heading levels, lists, quote/code tools, and a compact Aa control on iPhone.
• Markdown, HTML, and SVG previews are opt-in through one toolbar control, close cleanly, and adapt between inline panes and the iPhone preview sheet.
• Files at 100 MB or above now open as a clearly marked, read-only partial preview of the first 4 MB, protecting memory while preserving a useful inspection workflow.
• Trackpad and touch pinch gestures adjust editor font size; the minimap activates more reliably after tab changes and keeps its draggable viewport marker in sync.
• GitHub releases publish the signed app build number in their notes, allowing the macOS updater to distinguish newer builds that reuse the same release tag.

flowchart LR
  Mac["Platform: macOS shell (SwiftUI + AppKit bridges)"]
  Touch["Platform: iOS/iPadOS/visionOS shell (SwiftUI + UIKit bridges)"]
  ACT["App Layer: user actions (toolbar/menu/shortcuts)"]
  VM["App Layer: EditorViewModel (@MainActor state owner)"]
  CMD["App Layer: serialized tab commands + resource identity"]
  TEXT["Core: native NSTextView/UITextView editor bridges"]
  DOC["Core: document load/save + conflict pipeline"]
  OBS["Core: NSFilePresenter open-document observation"]
  HL["Core: syntax highlighting + runtime limits"]
  STRUCT["Core: CSV/TSV, plist + crash-report modes"]
  PREV["Core: Markdown/HTML/SVG preview + PDF export"]
  MINI["Core: code minimap snapshot builder"]
  NAV["Core: project index + find/diff workflows"]
  REMOTE["Core: RemoteSessionStore (Mac host + attach clients)"]
  DESKTOP["Core: GitService + PTY terminal (macOS-only)"]
  STORE["Infra: tabs + session restore store"]
  PREFS["Infra: settings + persistence"]
  SEC["Infra: SecureTokenStore (Keychain)"]
  POLICY["Infra: ReleaseRuntimePolicy"]
  MAS["Distribution: App Store target (updater-free)"]
  DIRECT["Distribution: direct macOS target (Sparkle + signed appcast)"]

  Mac --> ACT
  Touch --> ACT
  ACT --> VM
  VM --> CMD
  CMD --> STORE
  VM --> TEXT
  VM --> DOC
  DOC --> OBS
  DOC --> STORE
  VM --> HL
  VM --> STRUCT
  VM --> PREV
  VM --> MINI
  VM --> NAV
  VM --> REMOTE
  VM --> DESKTOP
  VM --> PREFS
  PREFS --> STORE
  VM --> SEC
  REMOTE --> SEC
  Mac --> MAS
  Mac --> DIRECT
  Touch --> MAS
  MAS --> POLICY
  DIRECT --> POLICY

  classDef platform stroke:#2563EB,stroke-width:3px,fill:transparent,font-family:ui-monospace\, SFMono-Regular\, Menlo\, Monaco\, Consolas\, Liberation Mono\, monospace,font-size:13px;
  classDef app stroke:#059669,stroke-width:3px,fill:transparent,font-family:ui-monospace\, SFMono-Regular\, Menlo\, Monaco\, Consolas\, Liberation Mono\, monospace,font-size:13px;
  classDef core stroke:#EA580C,stroke-width:3px,fill:transparent,font-family:ui-monospace\, SFMono-Regular\, Menlo\, Monaco\, Consolas\, Liberation Mono\, monospace,font-size:13px;
  classDef infra stroke:#9333EA,stroke-width:3px,fill:transparent,font-family:ui-monospace\, SFMono-Regular\, Menlo\, Monaco\, Consolas\, Liberation Mono\, monospace,font-size:13px;
  classDef distribution stroke:#DB2777,stroke-width:3px,fill:transparent,font-family:ui-monospace\, SFMono-Regular\, Menlo\, Monaco\, Consolas\, Liberation Mono\, monospace,font-size:13px;

  class Mac,Touch platform;
  class ACT,VM,CMD app;
  class TEXT,DOC,OBS,HL,STRUCT,PREV,MINI,NAV,REMOTE,DESKTOP core;
  class STORE,PREFS,SEC,POLICY infra;
  class MAS,DIRECT distribution;

• EditorViewModel is the single UI-facing orchestration point per window/scene.
• Serialized tab commands separate a UI tab from the document resource it represents, preserving per-document cursor and viewport state across asynchronous loads and refreshes.
• Open local documents use NSFilePresenter events and bounded metadata/content checks. Clean buffers refresh in place; dirty buffers enter Keep Local, Reload from Disk, or Compare.
• Native editor bridges own TextKit/UIKit allocation and scrolling. SwiftUI owns pane allocation, including the macOS wrapped source/preview split.
• File access, parsing, diffing, structured snapshots, and other heavy work stay off the main actor; UI state mutations return to @MainActor.
• Platform shells stay thin. visionOS shares the UIKit-family editor while adapting presentation for spatial layouts.
• Remote sessions stay opt-in; macOS owns SSH and broker hosting while iPhone, iPad, and Apple Vision Pro attach as clients.
• App Store builds are updater-free. The separate direct macOS target links Sparkle and consumes the signed GitHub Pages appcast.
• Security-sensitive credentials and SSH-key bookmarks remain in Keychain (SecureTokenStore), not plain prefs.
• Color key: blue = platform shell, green = app orchestration, orange = core services, purple = infrastructure, pink = distribution products.

Full architecture reference: ARCHITECTURE.md. The reference tracks the current Swift 6 cross-platform structure, platform guards, editor rendering paths, performance rules, distribution boundaries, and release verification workflow.

• Keep UI mutations on the main thread (@MainActor) and heavy work off the UI thread.
• Keep window/scene state isolated to avoid accidental cross-window coupling.
• Keep security defaults strict: tokens in Keychain, no telemetry by default.
• Keep platform wrappers thin and push shared behavior into common services.

Neon Vision Editor shares its editor core across macOS, iPhone, iPad, and Apple Vision Pro. Platform-specific controls adapt to available space and input rather than exposing desktop-only workflows on touch devices.

Desktop-only workflows: Git, the PTY Terminal, and SSH-hosted Remote Sessions run only on macOS. iPhone, iPad, and Apple Vision Pro remain editor, preview, and Remote Session client surfaces.

Availability key: full native workflow · layout adapts to space and input · touch-first presentation · local desktop capability

• Native text editing, syntax highlighting, line wrap controls, bracket helper, and large-file safeguards.
• Opt-in Preview for Markdown, HTML, and SVG documents; previews are closed by default and use the same toolbar visibility control.
• Markdown formatting that wraps selections or inserts paired markers without one; heading, list, quote, code, link, image, and table actions are available from an adaptive control surface.
• Optional Code Minimap for supported languages, with viewport navigation and a draggable marker where space permits.
• Close All Tabs confirmation, unsupported-file safety alerts, and grouped Settings cards.

Capability	macOS	iPhone	iPad	Apple Vision Pro	Notes
Quick Open Cmd+P	Keyboard and menu	Hardware keyboard	Keyboard and menu	Hardware keyboard	Keyboard-first navigation remains available whenever a hardware keyboard is connected.
Project workspace	Files/Search/Git/Terminal rail	File workflow	Files/Search workflow	Spatial workspace	Git and Terminal execute only on macOS.
Find in Files	Sidebar	Sheet	Sidebar	Panel	On Mac and iPad, results remain visible while opening a match.
Markdown formatting	Collapsible toolbar below tabs	Aa status-row menu	Collapsible toolbar below tabs	Collapsible toolbar below tabs	Direct Bold, Italic, Link, Quote, and Code actions; structural actions and five heading levels remain available in menus.
Preview Markdown, HTML, SVG	Inline split pane	Full-screen sheet	Inline pane in regular width	Inline pane	The eye control is enabled only for supported documents and also closes the active preview.
Preview appearance	Templates and backgrounds	Templates and compact controls	Templates and backgrounds	System Glass, Paper, Slate, or Ink	visionOS intentionally uses its own reader surfaces instead of the full Markdown template collection.
Font-size gesture	Trackpad pinch	Touch pinch	Touch pinch	Touch pinch	Gestures adjust editor font size from 10 to 28 pt and retain the regular font-size controls.
Code Minimap	Opt-in	Opt-in	Opt-in	Opt-in	Available for supported languages; it stays hidden for document types where a minimap is not useful.
Diff workflows	Inline	Sheet	Inline	Panel	Compact presentations avoid taking over narrow touch layouts.
Git and Terminal	Local Git and PTY terminal	--	--	--	These use local macOS executables and are deliberately not exposed on mobile or spatial platforms.
Remote sessions	SSH owner and broker host	Broker attach client	Broker attach client	Broker attach client	Remote access is opt-in; iPhone, iPad, and visionOS explicitly save through a Mac-hosted session.
Save and export	Native Save As and export	System exporter	System exporter	System exporter	iPhone and iPad export Markdown and Swift with their declared content types.

• Notarized release pipeline: release-notarized.yml
• Pre-release verification gate: pre-release-ci.yml
• Security scanning: CodeQL workflow
• Homebrew cask sync: update-cask.yml

More release integrity details: Release Integrity

• macOS
• iPad
• iPhone
• Source image index for docs: docs/images/README.md
• App Store gallery: Neon Vision Editor on App Store
• Latest release assets: GitHub Releases

Light editor workspace with symbol navigation	Wide light editor workspace with toolbar actions
Compact light editor workspace with focused code view	Light editor workspace with code minimap

Project navigation and editing workflow on iPad

Markdown preview workflow in the editor context

Editing workflow with syntax highlighting and accessory bar	Overflow menu actions in the editor workflow
Markdown preview sheet with template, PDF mode, and export action	Theme color editing on iPhone

• focuses on editor interaction polish, Markdown preview stability, local custom AI endpoints, sidebar terminal improvements, and release workflow hardening. Tracking: Release v0.9.7

• targets post-0.9.7 stabilization: App Store review follow-up, README/release metadata freshness, preview polish, and small cross-platform editor fixes. Tracking: Milestones

• larger workflow expansion after the current cross-platform editor baseline is verified, with remote workflows and navigation surfaces kept opt-in until they are fully hardened.

• Open known issues (live filter): label:known-issue

1. Markdown preview not visible: use the preview action from an open Markdown file; iPhone presents preview in a sheet, while macOS and iPadOS can show it inline.
2. Shortcut not working on iOS: connect a hardware keyboard for shortcut-based flows like Cmd+P.
3. Sidebar/layout feels cramped on iPad: switch orientation or close side panels before preview.
4. Settings feel off after updates: quit/relaunch app and verify current release version in Settings.
5. Remote connection refused on a local Mac target: enable System Settings > General > Sharing > Remote Login, then start the Remote session again.

• Theme and appearance: Settings > Designs
• Appearance/theme iCloud sync: Settings > Allgemein/General > Window
• Editor behavior (font, line height, wrapping, snippets, minimap): Settings > Editor
• Startup/session behavior: Settings > Allgemein/General
• Remote sessions: Settings > Mehr/More > Remote or Settings > Remote on wider layouts
• Support and purchase options: Settings > Mehr/More (platform-dependent)

• Does Neon Vision Editor support Intel Macs?
  Intel is currently not fully validated. If you can help test, see Help wanted: Intel Mac test coverage.
• Can I use it offline?
  Yes for core editing. Network is only used for explicit actions such as selected AI providers, update checks, GitHub release downloads, or opt-in Remote Sessions.
• Do I need AI enabled to use the editor?
  No. Core editing, navigation, and preview features work without AI.
• Where are tokens stored?
  In Keychain via SecureTokenStore, not in UserDefaults.

All shortcuts use Cmd (⌘). iPhone, iPad, and Apple Vision Pro require an external hardware keyboard. The table shows defaults; selected editor shortcuts can be customized in Settings > Shortcuts.

Availability key: assigned shortcut · external keyboard required · desktop command

Shortcut	Action	macOS	iPhone	iPad	Apple Vision Pro
Cmd+N	New Window		--	--	--
Cmd+T	New Tab
Cmd+O	Open File
Cmd+Shift+O	Open Folder
Cmd+S	Save
Cmd+Shift+S	Save As
Cmd+W	Close Tab		--		--
Cmd+X, Cmd+C, Cmd+V, Cmd+A	Cut, Copy, Paste, Select All
Cmd+Z, Cmd+Shift+Z	Undo, Redo
Cmd+B, Cmd+I, Cmd+K	Bold, Italic, Link in Markdown		--		--

Shortcut	Action	macOS	iPhone	iPad	Apple Vision Pro
Cmd+F, Cmd+G	Find, Find Next
Cmd+Shift+F	Find in Files
Cmd+P	Quick Open		--	--	--
Cmd+L	Go to Line		--	--	--
Cmd+Shift+J	Go to Symbol		--	--	--
Cmd+Option+S	Toggle Sidebar
Cmd+Option+L	Toggle Line Wrap
Cmd+Option+M	Toggle Code Minimap		--	--	--
Cmd+,, Cmd+?	Settings, Toolbar Help

Shortcut	Action	Availability
Cmd+D	Add Next Match
Cmd+Shift+D	Brain Dump Mode
Cmd+Shift+V	Toggle Vim Mode
Cmd+Shift+G	Suggest Code
Cmd+Shift+L	AI Activity Log
Cmd+Shift+U	Inspect whitespace at caret

Vim navigation is also available on iPad with a hardware keyboard after enabling Vim mode; arrow keys and the standard Vim movement keys work in Normal mode.

Latest stable: v0.9.7 (2026-07-24)

timeline
    title Neon Vision Editor — recent release story
    22 July 2026 : v0.9.4 · Shared work, safely
                : Adds a lightweight shared-file sync experience — when iCloud Drive, a network folder, or another app updates an open file, clean tabs refresh automatically while unsaved edits remain protected by the existing review flow.
    23 July 2026 : v0.9.5 · A more deliberate workflow
                : Converts plain text to a reviewable, source-preserving Markdown proposal using Apple Intelligence or an explicitly configured AI provider, with cancellation and a 30-second safety limit.
    23 July 2026 : v0.9.6 · Windows that remember
                : Restores each macOS editor window at its own last-used size and position without briefly showing the smaller fallback window first.
    24 July 2026 : v0.9.7 · Safer document transitions
                : Makes macOS document opening, session restoration, preview changes, and external refreshes safer on current macOS releases by avoiding synchronous TextKit and AppKit layout work during a document transition.

The recent release arc is about continuity: files that change outside the app, workflows that stay reviewable, windows that return where you left them, and document transitions that preserve your editing context. The full record remains in CHANGELOG.md.

• Full release history: CHANGELOG.md
• Latest release: v0.9.6
• Compare recent changes: v0.9.6...v0.9.7

• Intel Mac support is not fully validated yet.
• Vim mode is intentionally lightweight, not full Vim emulation.
• iPhone and iPad workflows still offer a smaller feature set than macOS.

• Privacy policy: PRIVACY.md.
• API keys are stored in Keychain (SecureTokenStore), not UserDefaults.
• Network traffic uses HTTPS.
• No telemetry.
• External AI requests only occur when code completion is enabled and a provider is selected.
• Remote Sessions are opt-in and user-triggered; when enabled, broker payloads are encrypted and SSH-key bookmarks stay in Keychain.
• Security policy and reporting details: SECURITY.md.
• New repository commits are SSH-signed; older historical commits may still predate commit signing.
• Local SSH-signature verification uses a private allowed-signers file outside the repository.

• Tag: v0.9.7
• Tagged commit: release tag target
• Verify local tag target:

git rev-parse --verify v0.9.7

• Verify downloaded artifact checksum locally:

shasum -a 256 <downloaded-file>

• Verify local SSH commit signatures in this clone:

git config --local gpg.ssh.allowedSignersFile "$HOME/.config/git/allowed_signers"
git log --show-signature -1

• Stable: tagged GitHub releases intended for daily use.
• Beta: TestFlight builds may include in-progress UX and platform polish.
• Cadence: fixes/polish can ship between minor tags, with summary notes mirrored in README and CHANGELOG.md.

• Designed and tested for macOS 26 (Tahoe), with compatibility work for macOS 15 Sequoia.
• Xcode deployment target: macOS 15.0; iOS/iPadOS 18.6.
• Apple Silicon recommended

• Xcode with the macOS 26 SDK/toolchain for current release assets and icon payloads.
• iOS and iPadOS simulator runtimes installed in Xcode for cross-platform verification

If you already completed the Start in 60s (Source Build), you can open and run directly from Xcode.

git clone https://github.com/h3pdesign/Neon-Vision-Editor.git
cd Neon-Vision-Editor
open "Neon Vision Editor.xcodeproj"

Contributor guide: CONTRIBUTING.md

1. Fork the repo and create a focused branch.
2. Implement the smallest safe diff for your change.
3. Build on macOS first.
4. Run cross-platform verification script.
5. Open a PR with screenshots for UI changes and a short risk note.
6. Link to related issue/milestone and call out user-visible impact.

git clone https://github.com/h3pdesign/Neon-Vision-Editor.git
cd Neon-Vision-Editor
xcodebuild -project "Neon Vision Editor.xcodeproj" -scheme "Neon Vision Editor" -destination 'platform=macOS,name=My Mac' build

Lock-safe cross-platform verification (sequential macOS + iOS Simulator + iPad Simulator):

scripts/ci/build_platform_matrix.sh

Share what works well and what should improve for both the app and the README.

Share positive feedback  ·  Share negative feedback

• Questions and ideas: GitHub Discussions
• Project board (Now / Next / Later): Neon Vision Editor Roadmap
• Known issues: Known Issues Hub #50
• Contributor entry points: good first issue | help wanted
• Issue filters: enhancement | known-issue | regression

Keep it free, sustainable, and improving.

• Neon Vision Editor will always stay free to use.

• No subscriptions and no paywalls.

• Keeping the app alive still has real costs: Apple Developer Program fee, maintenance, updates, and long-term support.

• Optional Support Tip (Consumable): $4.99 and can be purchased multiple times.

• Your support helps cover Apple developer fees, bug fixes and updates, future improvements and features, and long-term support.

• Thank you for helping keep Neon Vision Editor free for everyone.

• In-app support tip: Settings > Mehr/More (platform-dependent)

• External support: Buy Me a Coffee

• External support: Patreon

• h3p apps portal for docs, setup guides, and release workflows: >h3p apps

• External support: PayPal

• Discussions categories: Ideas | Q&A | Showcase

To auto-increment Xcode CURRENT_PROJECT_VERSION on every commit:

scripts/install_git_hooks.sh

Neon Vision Editor is licensed under the Apache License, Version 2.0. See LICENSE.

The project moved to Apache-2.0 because it keeps the same permissive open-source model while adding an explicit patent grant and patent-termination protection for contributors and downstream users. This better matches a developer tool that may receive contributions, integrations, and commercial redistribution over time.