KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

Neon-Vision-Editor

★ 381 Open GitHub ↗

A native Swift editor for code and Markdown across macOS, iPadOS, iOS, and visionOS.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

&nbsp;

&nbsp;

Neon Vision Editor

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

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

&nbsp;

Download:
 <a href="https://github.com/h3pdesign/Neon-Vision-Editor/releases">GitHub Releases</a>
 ·
 <a href="https://apps.apple.com/de/app/neon-vision-editor/id6758950965">App Store</a>
 ·
 <a href="https://testflight.apple.com/join/YWB2fGAP">TestFlight</a>

> Status: **active release**  
> Latest release: **v1.4.6**
> Next release target: **v1.4.7**
> Platform target: **macOS 26 (Tahoe)** compatible with **macOS Sequoia**
> Apple Silicon: tested / Intel: not tested
> Direct GitHub release: **v1.4.6** / App Store and TestFlight availability varies by platform and review status
> Last updated (README): **2026-08-17** for latest release **v1.4.6**

## What's New in v1.4.5 and v1.4.6

### Why Upgrade

- v1.4.6: Gives Finder Quick Look previews meaningful syntax colors across more supported languages and file types.
- v1.4.6: Keeps compact Finder previews focused on content while retaining navigation controls in the full Quick Look window.
- v1.4.6: Makes Markdown preview controls clearer, consistently aligned, and easier to identify.

### v1.4.6 Highlights

- Adds dedicated Quick Look highlighting for SQL, TeX, configuration files, strings files, delimited data, logs, notebooks, Dockerfiles, and Makefiles.
- Adds a post-release documentation workflow that waits for publication to settle, repairs release drift, validates the result, and creates a signed update when needed.

### v1.4.5 Context

- v1.4.5: Keeps the macOS virtual editor writable across its full width after changing sidebars or Markdown preview.
- v1.4.5: Restores line wrapping immediately when the editor viewport changes.
- v1.4.5: Preserves fast tab switching while correcting viewport reflow.

### v1.4.5 Highlights

- Makes the active editor viewport width authoritative for virtual-row layout and fragment caching.

## Start Here

- Jump: [Install](#install) | [Features](#features) | [Contributing](#contributing-quickstart)
- Quick install: [GitHub Releases](https://github.com/h3pdesign/Neon-Vision-Editor/releases), [App Store](https://apps.apple.com/de/app/neon-vision-editor/id6758950965), [TestFlight](https://testflight.apple.com/join/YWB2fGAP)
- Need help quickly: [Troubleshooting](#troubleshooting) | [FAQ](#faq) | [Known Issues](#known-issues)

### Start in 60s (Source Build)

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.

| For | Not For |
|---|---|
| Fast native editing across macOS, iOS, iPadOS | Full IDE workflows with deep refactoring/debugger stacks |
| Markdown writing and script/config edits with highlighting | Teams that require complete Intel Mac validation today |
| Users who want low overhead and quick file access | Users expecting full desktop-IDE parity on iPhone |

## Table of Contents

<a href="#start-here">Start Here</a> ·
 <a href="#release-channels">Release Channels</a> ·
 <a href="#core-workflows">Core Workflows</a> ·
 <a href="#download-metrics">Download Metrics</a> ·
 <a href="#project-documentation">Project Documentation</a> ·
 <a href="#features">Features</a>


 <a href="#release-spotlight">Release Spotlight</a> ·
 <a href="#platform-matrix">Platform Matrix</a> ·
 <a href="#roadmap-near-term">Roadmap (Near Term)</a> ·
 <a href="#troubleshooting">Troubleshooting</a> ·
 <a href="#faq">FAQ</a> ·
 <a href="#changelog">Changelog</a> ·
 <a href="#contributing-quickstart">Contributing Quickstart</a> ·
 <a href="#support--feedback">Support & Feedback</a>

## Release Channels

<div align="center">
 <table>
 <thead>
 <tr>
 <th>Channel</th>
 <th>Best for</th>
 <th>Delivery</th>
 <th>Current status</th>
 </tr>
 </thead>
 <tbody>
 <tr>
 <td><img alt="Stable" src="https://img.shields.io/badge/Stable-22C55E?style=flat-square"></td>
 <td>Direct notarized builds and fastest stable updates</td>
 <td><a href="https://github.com/h3pdesign/Neon-Vision-Editor/releases">GitHub Releases</a></td>
 <td>v1.4.6 release docs current; v1.4.6 direct download current</td>
 </tr>
 <tr>
 <td><img alt="Store" src="https://img.shields.io/badge/Store-0A84FF?style=flat-square"></td>
 <td>Apple-managed install/update flow</td>
 <td><a href="https://apps.apple.com/de/app/neon-vision-editor/id6758950965">App Store</a></td>
 <td>Check the platform listing for current availability</td>
 </tr>
 <tr>
 <td><img alt="Beta" src="https://img.shields.io/badge/Beta-F59E0B?style=flat-square"></td>
 <td>Early testing of upcoming changes</td>
 <td><a href="https://testflight.apple.com/join/YWB2fGAP">TestFlight</a></td>
 <td>Newest beta availability may vary by review state</td>
 </tr>
 </tbody>
 </table>
</div>

## Download Metrics

Release Download + Traffic Trend

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

 <img alt="Unique cloners (14d)" src="https://img.shields.io/static/v1?label=Unique+cloners+%2814d%29&message=650&color=7C3AED&style=for-the-badge">
 <img alt="Unique visitors (14d)" src="https://img.shields.io/static/v1?label=Unique+visitors+%2814d%29&message=243&color=0EA5E9&style=for-the-badge">


 <img alt="Clone snapshot (UTC)" src="https://img.shields.io/static/v1?label=Clone+snapshot+%28UTC%29&message=2026-08-17&color=334155&style=flat-square">
 <img alt="View snapshot (UTC)" src="https://img.shields.io/static/v1?label=View+snapshot+%28UTC%29&message=2026-08-17&color=334155&style=flat-square">

## Project Documentation

| Document | Purpose |
|---|---|
| [`CHANGELOG.md`](CHANGELOG.md) | Full release history and milestone issue coverage |
| [`ARCHITECTURE.md`](ARCHITECTURE.md) | Current cross-platform architecture, ownership boundaries, performance rules, and verification model |
| [`CONTRIBUTING.md`](CONTRIBUTING.md) | Local setup, build, and contribution workflow |
| [`PRIVACY.md`](PRIVACY.md) | Privacy guarantees and data-handling policy |
| [`SECURITY.md`](SECURITY.md) | Security policy and responsible disclosure |
| [`release/`](release/) | TestFlight, App Store, and release preflight checklists |

## Who Is This For?

| Best For | Why Neon Vision Editor |
|---|---|
| Quick note takers | Fast native startup and low UI overhead for quick edits |
| Markdown-focused writers | Clean editing with quick preview workflows on Apple devices |
| Developers editing scripts/config files | Syntax highlighting + fast file navigation without full IDE complexity |

## Why This Instead of a Full IDE?

| Advantage | What It Means |
|---|---|
| Faster startup | Lower overhead for short edit sessions |
| Focused surface | Editor-first workflow without project-system bloat |
| Native Apple behavior | Consistent experience on macOS, iOS, and iPadOS |

## Download

Prebuilt binaries are available on [GitHub Releases](https://github.com/h3pdesign/Neon-Vision-Editor/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.

| Channel | Platform | Best For | Download | Release Track | Notes |
|---|---|---|---|---|---|
| **Stable** | macOS | Direct notarized builds and fastest stable updates | [GitHub Releases](https://github.com/h3pdesign/Neon-Vision-Editor/releases) | **v1.4.6** | Current direct download |
| **Store** | iOS / iPadOS / macOS / visionOS | Apple-managed installs and updates | [Neon Vision Editor on the App Store](https://apps.apple.com/de/app/neon-vision-editor/id6758950965) | **v0.7.8** | Current public App Store listing |
| **Store Review** | macOS | Corrected App Store update | App Store Connect review | **v1.2.6** | Resubmitted after review fixes |
| **Beta** | iOS / iPadOS / macOS | Testing upcoming changes before stable | [TestFlight Invite](https://testflight.apple.com/join/YWB2fGAP) | **v1.4.6** | Early access builds for feedback; availability may vary by review state |

## Install

### Quick install (curl)

Install the latest release directly:

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

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

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

### Homebrew

Install the official Homebrew cask:

```bash
brew install neon-vision-editor
```

The explicit cask form is equivalent:

```bash
brew install --cask neon-vision-editor
```

Cask source: [Homebrew/homebrew-cask](https://github.com/Homebrew/homebrew-cask/blob/HEAD/Casks/n/neon-vision-editor.rb)

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

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

### GitHub macOS command line helper

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`.

```bash
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:

```bash
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`](docs/CommandLineHelper.md).

## Core Workflows

<img alt="Project Sidebar" src="https://img.shields.io/badge/Project%20Sidebar-Glass%20Rail%20Redesign-0891B2?style=for-the-badge">
 <img alt="Find in Files" src="https://img.shields.io/badge/Find%20in%20Files-Stays%20Open-2563EB?style=for-the-badge">
 <img alt="Markdown Preview" src="https://img.shields.io/badge/Markdown-Formatting%20%2B%20Preview-DB2777?style=for-the-badge">
 <img alt="Remote Sessions" src="https://img.shields.io/badge/Remote%20Sessions-Opt--In%20Broker-0F766E?style=for-the-badge">
 <img alt="Code Minimap" src="https://img.shields.io/badge/Code%20Minimap-Optional%20Navigation-9333EA?style=for-the-badge">
 <img alt="Quick Open" src="https://img.shields.io/badge/Quick%20Open-Fast%20File%20Jump-7C3AED?style=for-the-badge">

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.

## Features

Neon Vision Editor keeps the surface minimal and focuses on fast writing/coding workflows.
Platform-specific availability is tracked in the [Platform Matrix](#platform-matrix) section below.

Editing Core


 <img alt="Fast Editing" src="https://img.shields.io/badge/Fast%20Editing-Tabbed%20%2B%20Large%20Files-22C55E?style=for-the-badge">
 <img alt="Invisible Characters" src="https://img.shields.io/badge/Invisible%20Chars-iPhone%20%2B%20iPad%20Aligned-14B8A6?style=for-the-badge">
 <img alt="Tabs" src="https://img.shields.io/badge/Tabs-Double--Click%20Close-4F46E5?style=for-the-badge">
 <img alt="Syntax Highlighting" src="https://img.shields.io/badge/Syntax-Swift%206%20Ready-0A84FF?style=for-the-badge">
 <img alt="TeX Support" src="https://img.shields.io/badge/TeX%2FLaTeX-Syntax%20Highlighting-14B8A6?style=for-the-badge">
 <img alt="Regex Find Replace" src="https://img.shields.io/badge/Find%20%26%20Replace-Regex%20Ready-F59E0B?style=for-the-badge">
 <img alt="Code Minimap" src="https://img.shields.io/badge/Code%20Minimap-Off%20By%20Default-9333EA?style=for-the-badge">
 <img alt="Vim Mode" src="https://img.shields.io/badge/Vim%20Mode-Hardware%20Keyboard-059669?style=for-the-badge">


 Navigation & Preview


 <img alt="Quick Open" src="https://img.shields.io/badge/Quick%20Open-Cmd%2BP-7C3AED?style=for-the-badge">
 <img alt="Project Sidebar" src="https://img.shields.io/badge/Project%20Sidebar-Files%20%2F%20Search%20%2F%20Git%20%2F%20Terminal-0891B2?style=for-the-badge">
 <img alt="Terminal Sidebar" src="https://img.shields.io/badge/Terminal-Sidebar%20Session-6366F1?style=for-the-badge">
 <img alt="CLI" src="https://img.shields.io/badge/CLI-nve%20Helper-111827?style=for-the-badge">
 <img alt="Indexed Search" src="https://img.shields.io/badge/Find%20in%20Files-No%20Default%20Replace%20Selection-2563EB?style=for-the-badge">
 <img alt="Diff View" src="https://img.shields.io/badge/Diff%20View-Stable%20Sidebar%20Width-16A34A?style=for-the-badge">
 <img alt="Preview" src="https://img.shields.io/badge/Preview-Markdown%20%2F%20HTML%20%2F%20SVG%20%2F%20PDF%20%2F%20PNG-DB2777?style=for-the-badge">
 <img alt="Markdown PDF Export" src="https://img.shields.io/badge/Markdown%20PDF-Paginated%20%2B%20One--Page-7C3AED?style=for-the-badge">
 <img alt="Remote Sessions" src="https://img.shields.io/badge/Remote-Browse%20%2B%20Explicit%20Save-0F766E?style=for-the-badge">


 Platform, Output & Customization


 <img alt="Cross Platform" src="https://img.shields.io/badge/Cross--Platform-macOS%20%7C%20iOS%20%7C%20iPadOS%20%7C%20visionOS-2563EB?style=for-the-badge">
 <img alt="Text Export" src="https://img.shields.io/badge/Text%20Export-Markdown%20%2B%20Swift%20Types-0A84FF?style=for-the-badge">
 <img alt="Code Snapshot" src="https://img.shields.io/badge/Code%20Snapshot-Share%20Images-F97316?style=for-the-badge">
 <img alt="Themes" src="https://img.shields.io/badge/Themes-25%20Palettes%20%2B%20Custom-DB2777?style=for-the-badge">
 <img alt="Shared File Sync" src="https://img.shields.io/badge/Shared%20Files-Open%20Tab%20Sync-14B8A6?style=for-the-badge">
 <img alt="iCloud Settings Sync" src="https://img.shields.io/badge/iCloud-Appearance%20%2B%20Themes-0EA5E9?style=for-the-badge">


 Safety & Privacy


 <img alt="Safety" src="https://img.shields.io/badge/Safety-Unsupported%20File%20Guards-EA580C?style=for-the-badge">
 <img alt="Safe Mode" src="https://img.shields.io/badge/Safe%20Mode-Startup%20Recovery-E11D48?style=for-the-badge">
 <img alt="Privacy" src="https://img.shields.io/badge/Privacy-No%20Telemetry-111827?style=for-the-badge">

### Current Feature Coverage

- **Editing utilities:** configurable iPhone/iPad keyboard actions, Copy Current Editor Reference, and Sort & Deduplicate Lines complement the regular save, find, undo, redo, and formatting commands.
- **Languages and structured documents:** Swift 6-ready highlighting includes TeX/LaTeX and Typst/CeTZ-aware editing; CSV/TSV, property lists, Apple crash reports, and recognized logs can switch between structured and raw-text views, and plain text can be transformed into validated JSON through an explicit AI-assisted action.
- **Project and preview workflows:** project-level Markdown/PDF cards reuse the project index for bounded excerpts and thumbnails, while Markdown, HTML, SVG, PDF, and PNG previews remain integrated with the editor.
- **macOS integration:** the embedded Quick Look extension previews supported Markdown and source files in Finder, and detached Markdown previews can use the same glass treatment without changing editor content.
- **Latest stable additions (v1.4.6):** Adds dedicated Quick Look highlighting for SQL, TeX, configuration files, strings files, delimited data, logs, notebooks, Dockerfiles, and Makefiles; Adds a post-release documentation workflow that waits for publication to settle, repairs release drift, validates the result, and creates a signed update when needed.

### Editing Core

- 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.
- The v1.4.0 text-rendering core uses a backend-neutral `EditorDocument` contract and a virtualized bounded viewport on macOS. The renderer draws the active window, requests new windows around the scroll anchor, preserves caret/selection positions, and rejects stale viewport generations instead of rebuilding the entire text buffer.
- macOS uses a native-free virtual renderer for every editable file. It draws only the bounded viewport with Core Text `CTLine` objects, caches visible line layouts, applies syntax colors only to visible lines, and swaps bounded windows around the scroll anchor. File-backed documents finish indexing before this renderer activates, so scrolling never grows an index or projects a complete document string. iOS/iPadOS/visionOS retain their separate `UITextView` editor path.
- 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 and Typst/CeTZ), 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.
- Scrolling the iPhone editor dismisses the software keyboard; iPad keeps the keyboard available while scrolling for its pointer and hardware-keyboard workflows.
- 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.

### Navigation & Workflow

- 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 Terminal tab is available only in the direct macOS build.
- The direct macOS project sidebar includes a Terminal tab that keeps output while switching tabs, offers project/home working-directory choices, and provides clear/restart controls. The App Store macOS build omits the PTY terminal and Python project runner.
- `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, file filters for All Files, Modified, Images, PNG, PDF, and Markdown, and default ignored heavy folders (`.git`, `.build`, `node_modules`, `DerivedData`).

### Settings & Sync

- 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.

### Compare & Save

- 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.

### Preview, Platform, and Safety

- 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. PDF and PNG documents open native previews automatically from toolbar, macOS context-menu/Launch Services, paste/drop, and restored tabs; macOS plus regular-width iPad and visionOS use inline panes while iPhone uses a preview sheet.
- PDF text highlighting stores lightweight page geometry and selected text separately from the source PDF. Notes use the existing editor on the left and may reuse the existing Markdown preview beside the PDF; note preview is off by default and empty notes create no file or Save As dialog.
- 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.

### Customization & Diagnostics

- 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.

## Release Spotlight

- **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.
- Large documents below 100 MB remain editable through the file-backed viewport path; files at 100 MB or above 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.

## Architecture At A Glance

```mermaid
flowchart TB
  subgraph PLATFORM[Platform shells]
    MAC["macOS: SwiftUI + AppKit"]
    TOUCH["iPhone/iPad/visionOS: SwiftUI + UIKit"]
  end

ACTIONS["User actions: toolbar, menu, shortcuts"]
  VM["EditorViewModel (@MainActor, per window)"]
  COMMANDS["Serialized tab commands + resource identity"]
  REVISIONS["Targeted tab revisions: structure, content, metadata, persistence"]

subgraph DOCUMENTS[Document lifecycle]
    DOC["EditorDocument: load, save, conflict pipeline"]
    FBD["FileBackedTextDocument: disk bytes + replacement pieces"]
    INDEX["Complete line index before activation"]
    OBS["NSFilePresenter: external-change observation"]
  end

subgraph RENDERING[Editor rendering]
    MACVIEW["macOS VirtualEditorView: Core Text bounded viewport"]
    VIEWPORT["Bounded read/decode around scroll anchor"]
    UIKITTEXT["UIKit CustomTextEditor: UITextView input"]
  end

SERVICES["Highlighting, minimap, TOC/preview, structured data, navigation"]
  INFRA["Session store, preferences, Keychain, runtime policy"]
  DIST["App Store target / direct macOS target with Sparkle"]

MAC --> ACTIONS
  TOUCH --> ACTIONS
  ACTIONS --> VM --> COMMANDS --> REVISIONS
  REVISIONS --> DOC
  REVISIONS --> MACVIEW
  REVISIONS --> UIKITTEXT
  DOC --> FBD --> INDEX --> MACVIEW --> VIEWPORT
  DOC --> OBS
  VM --> SERVICES
  VM --> INFRA
  MAC --> DIST
  TOUCH --> DIST

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 ACTIONS,VM,COMMANDS,REVISIONS app;
  class DOC,FBD,INDEX,OBS,MACVIEW,VIEWPORT,UIKITTEXT,SERVICES core;
  class INFRA infra;
  class DIST 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.
- `EditorDocument` and the file-backed viewport layer form the document/rendering core for large editable files. The line index completes before `VirtualEditorView` activates; its Core Text renderer then consumes bounded windows, preserves selection across replacements, and rejects stale generations before applying edits or rendering work.
- 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.
- The macOS renderer owns Core Text allocation, input, selection, and virtual scrolling. The iOS/iPadOS/visionOS bridge owns UIKit text input. 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`](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.

### Architecture principles

- 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.

## Platform Matrix

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. macOS also has two distribution profiles: the direct GitHub build includes optional local developer tools, while App Store builds keep those executable-code workflows out of the shipped UI.

> **Platform boundary:** Git review is available on macOS when a local repository and Git installation are present. The PTY Terminal, Python project creation/execution, and the bundled `nve` command-line helper are direct-macOS-only; they are not included in the App Store macOS build and are not exposed on iPhone, iPad, or Apple Vision Pro. SSH-hosted Remote Sessions remain opt-in and use macOS as the host.

**Availability key:** ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) full native workflow · ![Adaptive](https://img.shields.io/badge/Adaptive-0A84FF?style=flat-square) layout adapts to space and input · ![Compact](https://img.shields.io/badge/Compact-7C3AED?style=flat-square) touch-first presentation · ![macOS only](https://img.shields.io/badge/macOS_only-6B7280?style=flat-square) local desktop capability

### Shared Across All Platforms

- Native text editing, syntax highlighting, line wrap controls, bracket helper, and large-file safeguards.
- Opt-in Preview for Markdown, HTML, and SVG documents; PDF and PNG previews open automatically. An attached Markdown note uses the existing editor and its optional preview is off by default.
- 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.
- Platform-optimized toolbar presets: macOS and iPadOS use compact labels, while iPhone keeps the toolbar icon-first. Standard, focused, developer, review, complete, and custom configurations are available from Settings where the platform supports them.
- iPhone and iPad support double-tap tab closing while preserving unsaved-change confirmation; iOS retains its transparent status-bar and navigation-surface composition.
- 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.

### Platform-Specific Differences and Features

| Capability | macOS | iPhone | iPad | Apple Vision Pro | Notes |
|---|---|---|---|---|---|
| Quick Open `Cmd+P` | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Keyboard and menu | ![Compact](https://img.shields.io/badge/Compact-7C3AED?style=flat-square) Hardware keyboard | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Keyboard and menu | ![Adaptive](https://img.shields.io/badge/Adaptive-0A84FF?style=flat-square) Hardware keyboard | Keyboard-first navigation remains available whenever a hardware keyboard is connected. |
| Project workspace | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Files/Search/Git rail; Terminal in direct build | ![Compact](https://img.shields.io/badge/Compact-7C3AED?style=flat-square) File workflow | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Files/Search workflow | ![Adaptive](https://img.shields.io/badge/Adaptive-0A84FF?style=flat-square) Spatial workspace | Git review is macOS-only; the PTY Terminal is direct-macOS-only. |
| Find in Files | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Sidebar | ![Compact](https://img.shields.io/badge/Compact-7C3AED?style=flat-square) Sheet | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Sidebar | ![Adaptive](https://img.shields.io/badge/Adaptive-0A84FF?style=flat-square) Panel | On Mac and iPad, results remain visible while opening a match. |
| Markdown formatting | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Collapsible toolbar below tabs | ![Compact](https://img.shields.io/badge/Compact-7C3AED?style=flat-square) `Aa` status-row menu | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Collapsible toolbar below tabs | ![Adaptive](https://img.shields.io/badge/Adaptive-0A84FF?style=flat-square) Collapsible toolbar below tabs | Direct Bold, Italic, Link, Quote, and Code actions; structural actions and five heading levels remain available in menus. |
| Toolbar and workspace presets | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Compact labels; standard, focused, developer, review, complete, custom | ![Compact](https://img.shields.io/badge/Compact-7C3AED?style=flat-square) Icon-first toolbar; compact preset controls | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Compact labels and preset controls | ![Adaptive](https://img.shields.io/badge/Adaptive-0A84FF?style=flat-square) Spatial toolbar presentation | Presets are configured from Settings; labels and available controls adapt to space and input. |
| Tab closing | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Close controls and confirmation | ![Compact](https://img.shields.io/badge/Compact-7C3AED?style=flat-square) Double-tap tab | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Double-tap tab | ![Adaptive](https://img.shields.io/badge/Adaptive-0A84FF?style=flat-square) Spatial tab controls | Unsaved-change confirmation remains active on every platform. |
| Status-bar and navigation surface | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) macOS window chrome | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Transparent iOS composition | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) iPadOS surface composition | ![Adaptive](https://img.shields.io/badge/Adaptive-0A84FF?style=flat-square) Spatial chrome | v1.2.1 restores the transparent iOS status-bar composition without changing the editor or preview layout. |
| Preview Markdown, HTML, SVG, PDF, PNG | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Inline split pane | ![Compact](https://img.shields.io/badge/Compact-7C3AED?style=flat-square) Full-screen sheet | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Inline pane in regular width | ![Adaptive](https://img.shields.io/badge/Adaptive-0A84FF?style=flat-square) Inline pane | Markdown/HTML/SVG remain opt-in; PDF/PNG open automatically. PDF notes reuse the existing editor and optional Markdown preview. |
| Preview appearance | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Templates and backgrounds | ![Compact](https://img.shields.io/badge/Compact-7C3AED?style=flat-square) Templates and compact controls | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Templates and backgrounds | ![Adaptive](https://img.shields.io/badge/Adaptive-0A84FF?style=flat-square) System Glass, Paper, Slate, or Ink | visionOS intentionally uses its own reader surfaces instead of the full Markdown template collection. |
| Font-size gesture | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Trackpad pinch | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Touch pinch | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Touch pinch | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Touch pinch | Gestures adjust editor font size from 10 to 28 pt and retain the regular font-size controls. |
| Code Minimap | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Opt-in | ![Compact](https://img.shields.io/badge/Compact-7C3AED?style=flat-square) Opt-in | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Opt-in | ![Adaptive](https://img.shields.io/badge/Adaptive-0A84FF?style=flat-square) Opt-in | Available for supported languages; it stays hidden for document types where a minimap is not useful. |
| Diff workflows | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Inline | ![Compact](https://img.shields.io/badge/Compact-7C3AED?style=flat-square) Sheet | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Inline | ![Adaptive](https://img.shields.io/badge/Adaptive-0A84FF?style=flat-square) Panel | Compact presentations avoid taking over narrow touch layouts. |
| Git review | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Local repository history, changes, and diffs | -- | -- | -- | Requires a local Git repository and an installed Git executable on macOS. |
| PTY Terminal and Python workflow | ![macOS only](https://img.shields.io/badge/direct_macOS_only-6B7280?style=flat-square) PTY terminal, Python project runner, and `nve` helper | -- | -- | -- | Available in the direct GitHub macOS build; intentionally omitted from App Store macOS builds and all mobile/spatial builds. |
| Remote sessions | ![macOS host](https://img.shields.io/badge/macOS_host-6B7280?style=flat-square) SSH owner and broker host | ![Adaptive](https://img.shields.io/badge/Adaptive-0A84FF?style=flat-square) Broker attach client | ![Adaptive](https://img.shields.io/badge/Adaptive-0A84FF?style=flat-square) Broker attach client | ![Adaptive](https://img.shields.io/badge/Adaptive-0A84FF?style=flat-square) Broker attach client | Remote access is opt-in; iPhone, iPad, and visionOS explicitly save through a Mac-hosted session. |
| Save and export | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) Native Save As and export | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) System exporter | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) System exporter | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) System exporter | iPhone and iPad export Markdown and Swift with their declared content types. |

## Trust & Reliability Signals

- Primary notarized release pipeline: [release-github-only.yml](https://github.com/h3pdesign/Neon-Vision-Editor/actions/workflows/release-github-only.yml). The other release workflows are manual fallbacks for an already-created tag.
- Pre-release verification gate: [pre-release-ci.yml](https://github.com/h3pdesign/Neon-Vision-Editor/actions/workflows/pre-release-ci.yml)
- Security scanning: [CodeQL workflow](https://github.com/h3pdesign/Neon-Vision-Editor/actions/workflows/codeql.yml)

More release integrity details: [Release Integrity](#release-integrity)

## Platform Gallery

- [macOS](#macos)
- [iPad](#ipad)
- [iPhone](#iphone)
- Source image index for docs: [`docs/images/README.md`](docs/images/README.md)
- App Store gallery: [Neon Vision Editor on App Store](https://apps.apple.com/de/app/neon-vision-editor/id6758950965)
- Latest release assets: [GitHub Releases](https://github.com/h3pdesign/Neon-Vision-Editor/releases)

### macOS

<table align="center">
 <tr>
 <td align="center">
 <a href="docs/images/mac-light-editor-sidebar.png">
 <img src="docs/images/mac-light-editor-sidebar.png" alt="Neon Vision Editor macOS light editor with symbol sidebar" width="520">
 </a> 
 Light editor workspace with symbol navigation
 </td>
 <td align="center">
 <a href="docs/images/mac-light-editor-wide.png">
 <img src="docs/images/mac-light-editor-wide.png" alt="Neon Vision Editor macOS wide light editor workspace" width="520">
 </a> 
 Wide light editor workspace with toolbar actions
 </td>
 </tr>
 <tr>
 <td align="center">
 <a href="docs/images/mac-light-editor-compact.png">
 <img src="docs/images/mac-light-editor-compact.png" alt="Neon Vision Editor macOS compact light editor workspace" width="520">
 </a> 
 Compact light editor workspace with focused code view
 </td>
 <td align="center">
 <a href="docs/images/mac-light-editor-minimap.png">
 <img src="docs/images/mac-light-editor-minimap.png" alt="Neon Vision Editor macOS light editor with code minimap" width="520">
 </a> 
 Light editor workspace with code minimap
 </td>
 </tr>
</table>

### iPad

<table align="center">
 <tr>
 <td align="center">
 <a href="docs/images/ipad-editor-light.png">
 <img src="docs/images/ipad-editor-light.png" alt="iPad editor in light mode" width="520">
 </a> 
 Project navigation and editing workflow on iPad
 </td>
 <td align="center">
 <a href="docs/images/ipad-editor-dark.png">
 <img src="docs/images/ipad-editor-dark.png" alt="iPad editor in dark mode" width="520">
 </a> 
 Markdown preview workflow in the editor context
 </td>
 </tr>
</table>

### iPhone

<div align="center">
 <table width="100%" style="max-width: 760px; margin: 0 auto;">
 <tr>
 <td align="center" width="50%">
 <a href="docs/images/iphone-editor-light-frame-updated.png">
 <img src="docs/images/iphone-editor-light-frame-updated.png" alt="iPhone editor screenshot in light mode with syntax highlighting and keyboard bar" width="356">
 </a> 
 Editing workflow with syntax highlighting and accessory bar
 </td>
 <td align="center" width="50%">
 <a href="docs/images/iphone-menu-dark-frame.png">
 <img src="docs/images/iphone-menu-dark-frame.png" alt="iPhone editor screenshot with dark overflow menu open" width="356">
 </a> 
 Overflow menu actions in the editor workflow
 </td>
 </tr>
 <tr>
 <td align="center" width="50%">
 <a href="docs/images/iphone-markdown-preview-dark.png">
 <img src="docs/images/iphone-markdown-preview-dark.png" alt="iPhone markdown preview screenshot in dark mode with export controls" width="280">
 </a> 
 Markdown preview sheet with template, PDF mode, and export action
 </td>
 <td align="center" width="50%">
 <a href="docs/images/iphone-themes-light-frame.png">
 <img src="docs/images/iphone-themes-light-frame.png" alt="iPhone theme colors editor screenshot in light mode" width="356">
 </a> 
 Theme color editing on iPhone
 </td>
 </tr>
 </table>
</div>

## Release Train

| Track | Current Focus | Status |
|---|---|---|
| Stable direct download | `v1.4.6` notarized GitHub release | Current |
| App Store rollout | Platform releases are published independently after App Review | Check the relevant App Store listing |
| Post-1.4 stabilization | Crash triage, docs freshness, platform polish, App Store/Xcode Cloud release checks | Next patch train |
| Larger workflow work | Remote workflow hardening, minimap polish, project navigation refinements | Later `v1.5+` work |

## Roadmap (Near Term)

### Now (v1.4.6)

- ![v1.4.0](https://img.shields.io/badge/v1.4.0-22C55E?style=flat-square) delivers file-backed large-document editing, bounded live viewport virtualization, reliable ordinary-file installation, and the release workflow hardening shipped alongside the release.
  Tracking: [Release v1.4.6](https://github.com/h3pdesign/Neon-Vision-Editor/releases/tag/v1.4.6)

### Next (v1.4.7)

- ![v1.4.7](https://img.shields.io/badge/v1.4.7-F59E0B?style=flat-square) targets post-1.4.6 stabilization: App Store review follow-up, README/release metadata freshness, preview polish, and small cross-platform editor fixes.
  Tracking: [Milestones](https://github.com/h3pdesign/Neon-Vision-Editor/milestones)

### Later (v1.5+)

- ![v1.5+](https://img.shields.io/badge/v1.5%2B-0A84FF?style=flat-square) 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.

## Known Issues

- Open known issues (live filter): [label:known-issue](https://github.com/h3pdesign/Neon-Vision-Editor/issues?q=is%3Aissue%20is%3Aopen%20label%3Aknown-issue)

## Troubleshooting

1. Markdown/PDF/PNG preview not visible: use the preview action for Markdown, or reopen the PDF/PNG; PDF/PNG previews should activate automatically when opened.
2. A PDF note is not visible: choose Notes in the PDF preview; the attached `<pdf-name>.pdf.notes.md` opens in the existing editor on the left. Enable the optional Markdown preview explicitly to render it beside the PDF.
3. Shortcut not working on iOS: connect a hardware keyboard for shortcut-based flows like `Cmd+P`.
4. Sidebar/layout feels cramped on iPad: switch orientation or close side panels before preview.
5. Settings feel off after updates: quit/relaunch app and verify current release version in Settings.
6. Remote connection refused on a local Mac target: enable **System Settings > General > Sharing > Remote Login**, then start the Remote session again.

## Configuration

- 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)

## FAQ

- **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](https://github.com/h3pdesign/Neon-Vision-Editor/issues/41).
- **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`.

## Keyboard Shortcuts

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:** ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) assigned shortcut · ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) external keyboard required · ![macOS only](https://img.shields.io/badge/macOS_only-6B7280?style=flat-square) desktop command

### File and Editing

| Shortcut | Action | macOS | iPhone | iPad | Apple Vision Pro |
|---|---|---|---|---|---|
| `Cmd+N` | New Window | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) | -- | -- | -- |
| `Cmd+T` | New Tab | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) |
| `Cmd+O` | Open File | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) |
| `Cmd+Shift+O` | Open Folder | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) |
| `Cmd+S` | Save | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) |
| `Cmd+Shift+S` | Save As | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) |
| `Cmd+W` | Close Tab | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) | -- | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | -- |
| `Cmd+X`, `Cmd+C`, `Cmd+V`, `Cmd+A` | Cut, Copy, Paste, Select All | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) |
| `Cmd+Z`, `Cmd+Shift+Z` | Undo, Redo | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) |
| `Cmd+B`, `Cmd+I`, `Cmd+K` | Bold, Italic, Link in Markdown | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) | -- | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | -- |

### Navigation and View

| Shortcut | Action | macOS | iPhone | iPad | Apple Vision Pro |
|---|---|---|---|---|---|
| `Cmd+F`, `Cmd+G` | Find, Find Next | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) |
| `Cmd+Shift+F` | Find in Files | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) |
| `Cmd+P` | Quick Open | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) | -- | -- | -- |
| `Cmd+L` | Go to Line | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) | -- | -- | -- |
| `Cmd+Shift+J` | Go to Symbol | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) | -- | -- | -- |
| `Cmd+Option+S` | Toggle Sidebar | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) |
| `Cmd+Option+L` | Toggle Line Wrap | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) |
| `Cmd+Option+M` | Toggle Code Minimap | ![macOS only](https://img.shields.io/badge/macOS_only-6B7280?style=flat-square) | -- | -- | -- |
| `Cmd+,`, `Cmd+?` | Settings, Toolbar Help | ![Full](https://img.shields.io/badge/Full-22C55E?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) | ![Keyboard](https://img.shields.io/badge/Keyboard-F59E0B?style=flat-square) |

### macOS-Only Tools

| Shortcut | Action | Availability |
|---|---|---|
| `Cmd+D` | Add Next Match | ![macOS only](https://img.shields.io/badge/macOS_only-6B7280?style=flat-square) |
| `Cmd+Shift+D` | Brain Dump Mode | ![macOS only](https://img.shields.io/badge/macOS_only-6B7280?style=flat-square) |
| `Cmd+Shift+V` | Toggle Vim Mode | ![macOS only](https://img.shields.io/badge/macOS_only-6B7280?style=flat-square) |
| `Cmd+Shift+G` | Suggest Code | ![macOS only](https://img.shields.io/badge/macOS_only-6B7280?style=flat-square) |
| `Cmd+Shift+L` | AI Activity Log | ![macOS only](https://img.shields.io/badge/macOS_only-6B7280?style=flat-square) |
| `Cmd+Shift+U` | Inspect whitespace at caret | ![macOS only](https://img.shields.io/badge/macOS_only-6B7280?style=flat-square) |

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.

## Changelog

Latest stable: **v1.4.6** (2026-08-16)

### Editor Evolution

```mermaid
timeline
 title Neon Vision Editor — recent release story
 15 August 2026 : v1.4.2 · A more deliberate workflow
 : Makes detached Markdown previews easier to read over the desktop while preserving a transparent glass appearance.
 15 August 2026 : v1.4.3 · A more deliberate workflow
 : Keeps macOS editing stable while changing workspace and Brain Dump layouts.
 15 August 2026 : v1.4.4 · Release highlights
 : Makes the on-screen keyboard accessory reliable for touch editing on iPhone and iPad.
 16 August 2026 : v1.4.5 · A more deliberate workflow
 : Keeps the macOS virtual editor writable across its full width after changing sidebars or Markdown preview.
 16 August 2026 : v1.4.6 · Release highlights
 : Gives Finder Quick Look previews meaningful syntax colors across more supported languages and file types.
```

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`](CHANGELOG.md).

### Recent Releases (At a glance)

| Release | The editor change | What it protects or enables |
|---|---|---|
| [`v1.4.6`](https://github.com/h3pdesign/Neon-Vision-Editor/releases/tag/v1.4.6) | **Release highlights** — Gives Finder Quick Look previews meaningful syntax colors across more supported languages and file types. | Prevents supported Quick Look languages from falling back to mostly one-color plain text. |
| [`v1.4.5`](https://github.com/h3pdesign/Neon-Vision-Editor/releases/tag/v1.4.5) | **A more deliberate workflow** — Keeps the macOS virtual editor writable across its full width after changing sidebars or Markdown preview. | Prevents virtual rows from being cached using the canvas's previous width during preview and sidebar transitions. |
| [`v1.4.4`](https://github.com/h3pdesign/Neon-Vision-Editor/releases/tag/v1.4.4) | **Release highlights** — Makes the on-screen keyboard accessory reliable for touch editing on iPhone and iPad. | Restores the keyboard accessory when the software keyboard is visible, including Simulator sessions where a keyboard controller is also present. |

- Full release history: [`CHANGELOG.md`](CHANGELOG.md)
- Latest release: **v1.4.6**
- Compare recent changes: [v1.4.5...v1.4.6](https://github.com/h3pdesign/Neon-Vision-Editor/compare/v1.4.5...v1.4.6)

## Known Limitations

- 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 & Security

- Privacy policy: [`PRIVACY.md`](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`](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.

## Release Integrity

- Tag: `v1.4.6`
- Tagged commit: release tag target
- Verify local tag target:

```bash
git rev-parse --verify v1.4.6
```

- Verify downloaded artifact checksum locally:

```bash
shasum -a 256 <downloaded-file>
```

- Verify local SSH commit signatures in this clone:

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

## Release Policy

- `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`.

## Requirements

### App Runtime

- 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

### Build Requirements

- 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

## Build from source

If you already completed the [Start in 60s (Source Build)](#start-in-60s-source-build), you can open and run directly from Xcode.

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

## Contributing Quickstart

Contributor guide: [`CONTRIBUTING.md`](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.

```bash
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):

```bash
scripts/ci/build_platform_matrix.sh
```

## Support & Feedback

### Feedback Pulse

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

<a href="https://github.com/h3pdesign/Neon-Vision-Editor/issues?q=is%3Aissue%20is%3Aopen%20%22%5BPositive%20Feedback%5D%22%20in%3Atitle">
 <img alt="Open Positive Feedback" src="https://img.shields.io/github/issues-search/h3pdesign/Neon-Vision-Editor?query=is%3Aissue%20is%3Aopen%20%22%5BPositive%20Feedback%5D%22%20in%3Atitle&label=Open%20Positive&color=22C55E">
 </a>
 &nbsp;
 <a href="https://github.com/h3pdesign/Neon-Vision-Editor/issues?q=is%3Aissue%20is%3Aopen%20%22%5BNegative%20Feedback%5D%22%20in%3Atitle">
 <img alt="Open Negative Feedback" src="https://img.shields.io/github/issues-search/h3pdesign/Neon-Vision-Editor?query=is%3Aissue%20is%3Aopen%20%22%5BNegative%20Feedback%5D%22%20in%3Atitle&label=Open%20Negative&color=EF4444">
 </a>


 <a href="https://github.com/h3pdesign/Neon-Vision-Editor/issues/new?template=feature_request.yml&title=%5BPositive%20Feedback%5D%20App%2FREADME%3A%20">Share positive feedback</a>
 &nbsp;·&nbsp;
 <a href="https://github.com/h3pdesign/Neon-Vision-Editor/issues/new?template=bug_report.yml&title=%5BNegative%20Feedback%5D%20App%2FREADME%3A%20">Share negative feedback</a>

- Questions and ideas: [GitHub Discussions](https://github.com/h3pdesign/Neon-Vision-Editor/discussions)
- Project board (Now / Next / Later): [Neon Vision Editor Roadmap](https://github.com/users/h3pdesign/projects/2)
- Known issues: [Known Issues Hub #50](https://github.com/h3pdesign/Neon-Vision-Editor/issues/50)
- Contributor entry points: [good first issue](https://github.com/h3pdesign/Neon-Vision-Editor/issues?q=is%3Aissue%20is%3Aopen%20label%3A%22good%20first%20issue%22) | [help wanted](https://github.com/h3pdesign/Neon-Vision-Editor/issues?q=is%3Aissue%20is%3Aopen%20label%3A%22help%20wanted%22)
- Issue filters: [enhancement](https://github.com/h3pdesign/Neon-Vision-Editor/issues?q=is%3Aissue%20is%3Aopen%20label%3Aenhancement) | [known-issue](https://github.com/h3pdesign/Neon-Vision-Editor/issues?q=is%3Aissue%20is%3Aopen%20label%3Aknown-issue) | [regression](https://github.com/h3pdesign/Neon-Vision-Editor/issues?q=is%3Aissue%20is%3Aopen%20label%3Aregression)

### Support Neon Vision Editor

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](https://buymeacoffee.com/h3pdesign)
- External support: [Patreon](https://www.patreon.com/h3p)
- h3p apps portal for docs, setup guides, and release workflows: [>h3p apps](https://apps-h3p.com)
- External support: [PayPal](https://www.paypal.com/paypalme/HilthartPedersen)

### Creator Sites

- Discussions categories: [Ideas](https://github.com/h3pdesign/Neon-Vision-Editor/discussions/categories/ideas) | [Q&A](https://github.com/h3pdesign/Neon-Vision-Editor/discussions/categories/q-a) | [Showcase](https://github.com/h3pdesign/Neon-Vision-Editor/discussions/categories/show-and-tell)

## Git hooks

To auto-increment Xcode `CURRENT_PROJECT_VERSION` on every commit:

```bash
scripts/install_git_hooks.sh
```

## Changed License

Neon Vision Editor is licensed under the Apache License, Version 2.0.
See [`LICENSE`](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.

Neon-Vision-Editor

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README