| .githooks | ||
| .github | ||
| docs | ||
| homebrew-tap | ||
| Neon Vision Editor | ||
| Neon Vision Editor.xcodeproj | ||
| Neon Vision EditorTests | ||
| release | ||
| samples/language-fixtures | ||
| scripts | ||
| .gitattributes | ||
| .gitignore | ||
| ARCHITECTURE.md | ||
| CHANGELOG.md | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTING.md | ||
| Info-macOS.plist | ||
| ISSUE_TEMPLATE.md | ||
| LICENSE | ||
| NeonVisionEditorApp.png | ||
| NeonVisionEditorIcon.png | ||
| PRIVACY.md | ||
| README.md | ||
| SECURITY.md | ||
Neon Vision Editor
A lightweight, modern editor focused on speed, readability, and automatic syntax highlighting.
Minimal by design: quick edits, fast file access, no IDE bloat.
h3p apps is a focused portal for product docs, setup guides, and release workflows: >h3p apps
Release Download: GitHub Releases
Status: active release
Latest release: v0.4.32 Platform target: macOS 26 (Tahoe) compatible with macOS Sequoia Apple Silicon: tested / Intel: not tested
What's New Since v0.4.32
- iPad toolbar keeps key actions visible more consistently (Settings, Search, Project Sidebar, Markdown Preview).
- iPad Markdown Preview now auto-prioritizes preview space by collapsing the project sidebar when needed.
- Settings polish on iOS/iPad: improved German localization coverage, centered tab headers, and cleaner card grouping.
- macOS top-left window controls are more stable during settings/tab transitions.
Platform Matrix
Availability legend: Full = complete support, Partial = available with platform constraints, No = currently unavailable.
| Capability | macOS | iOS | iPadOS | Notes |
|---|---|---|---|---|
| Fast text editing + syntax highlighting | Full | Full | Full | Optimized for regular and large files. |
| Markdown preview templates | Full | No | Full | Presets: Default, Docs, Article, Compact. |
| Project sidebar | Full | Full | Full | Folder tree + nested structure rendering. |
Quick Open (Cmd+P) |
Full | Partial | Full | iOS requires hardware keyboard for shortcut use. |
| Bracket helper | Full | Full | Full | macOS: toolbar helper, iOS/iPadOS: keyboard snippet bar. |
| Settings tabs + grouped cards | Full | Full | Full | Localized UI with grouped preference cards. |
Download
Prebuilt binaries are available on GitHub Releases.
- Latest release: v0.4.32
- Apple AppStore On the AppStore
- TestFlight beta: Join here
- Architecture: Apple Silicon (Intel not tested)
- Notarization: is finally implemented
Getting Started (30 Seconds)
- Install using
curlor Homebrew (below), or download the latest.zip/.dmgfrom Releases. - Move
Neon Vision Editor.appto/Applications. - Launch the app.
- Open a file with
Cmd+O. - Use
Cmd+Pfor Quick Open andCmd+Ffor Find & Replace. - Toggle Vim mode with
Cmd+Shift+Vif needed.
Install
Quick install (curl)
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
brew tap h3pdesign/tap
brew install --cask neon-vision-editor
Tap repository: h3pdesign/homebrew-tap
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
Gatekeeper (macOS 26 Tahoe)
If macOS blocks first launch:
- Open System Settings.
- Go to Privacy & Security.
- In Security, find the blocked app message.
- Click Open Anyway.
- Confirm the dialog.
Features
Core Experience
- Fast loading for regular and large text files.
- Tabbed editing with per-file language support.
- Automatic syntax highlighting for many languages and formats.
- Native Swift/AppKit editor experience.
- Multi-window workflow with focused-window commands.
Editing & Productivity
- Inline code completion with Tab-to-accept ghost suggestions.
- Regex Find/Replace with Replace All.
- Optional Vim mode (basic normal/insert workflow).
- Starter templates for all languages with one-click insert.
- Curated built-in editor themes (Dracula, One Dark Pro, Nord, Tokyo Night, Gruvbox, Neon Glow).
Markdown
- Native Markdown preview (macOS + iPad) with template presets (Default, Docs, Article, Compact).
- iPad toolbar keeps key actions visible more consistently, including Markdown Preview.
Projects & Files
- Project tree sidebar plus Quick Open (
Cmd+P). - Recursive project tree rendering for nested folders in the sidebar.
- Last-session restore now includes the previously opened project folder.
- Cross-platform
Save As…command support (macOS, iOS, iPadOS). - Document-type handling for
.plist,.sh, and general text so Finder/iOS can route those files straight into the editor.
Settings & Support
- Cross-platform theme settings panel with improved settings organization.
- Optional support purchase flow (StoreKit 2) in Settings.
- iOS/iPad settings polish with improved German localization and centered tab headers.
Architecture & Reliability
- Full Flux/command-pattern action flow for deterministic editor command handling.
- Swift 6 concurrency hardening across critical runtime paths.
- AI Activity Log diagnostics window on macOS for startup/provider visibility.
- Toolbar Map card in the welcome tour scales to fill a taller frame and keeps cards inside the border.
- No telemetry.
Visual Quick Links
- macOS main editor screenshot:
docs/images/macos-main.png - iPad Markdown Preview screenshot:
docs/images/ipad-markdown-preview.png - iPhone editor screenshot:
docs/images/iphone-editor.png - App Store gallery: Neon Vision Editor on App Store
- Latest release assets: GitHub Releases
Roadmap (Near Term)
- Improve iPad settings layout density and reduce scrolling friction. Tracking: #12
- Expand Markdown preview parity and interaction stability across Apple platforms. Tracking: #13
- Improve toolbar consistency and action discoverability across window sizes. Tracking: #14
Known Issues
- Open known issues (live filter): label:known-issue
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
Cmd+N |
New Window |
Cmd+T |
New Tab |
Cmd+O |
Open File |
Cmd+S |
Save |
Cmd+W |
Close Tab |
Cmd+P |
Quick Open |
Cmd+F |
Find & Replace |
Cmd+Shift+V |
Toggle Vim Mode |
Cmd+Option+S |
Toggle Sidebar |
Cmd+Option+L |
Toggle Line Wrap |
Cmd+Shift+D |
Toggle Brain Dump Mode |
Tab |
Accept code completion (when shown) |
Changelog
Recent improvements (post-v0.4.32, in progress)
- iPad toolbar now keeps core actions visible more consistently (Settings, Search, Project Sidebar, Markdown Preview) with improved width adaptation.
- iPad Markdown Preview flow now prioritizes preview space by hiding the project sidebar when needed.
- iOS/iPad Settings polish: improved German localization coverage, centered tab header presentation, and cleaner section grouping/cards.
- macOS window-controls stability refinement to reduce top-left control jitter during settings/tab transitions.
v0.4.32 (summary)
- Added native macOS
SettingsLinkwiring for the menu bar entry so it opens the Settings scene through the system path. - Improved macOS command integration by preserving the system app-settings command group and standard Settings routing behavior.
- Improved project-folder last-session restoration reliability by keeping security-scoped folder access active before rebuilding the sidebar tree.
- Fixed non-standard Settings shortcut mapping by restoring the macOS standard
Cmd+,behavior. - Fixed startup behavior when "Open with Blank Document" is enabled so launch always opens exactly one empty document.
v0.4.31 (summary)
- Added an AI Activity Log on macOS with a dedicated diagnostics window and menu entry to inspect startup/provider events.
- Added centralized macOS app command wiring for settings, AI diagnostics, updater, editor actions, and window-level command routing.
- Added a full Flux/command-pattern redesign completed in a parallel session.
- Improved release automation resiliency in
scripts/release_all.shwith fail-fastghauth checks, workflow/runner prechecks, stricter workflow status handling, and retryable asset verification. - Improved settings startup behavior to preserve user-selected tabs/preferences and avoid redundant refresh work when opening Settings.
v0.4.30 (summary)
- Added a native macOS Markdown preview web view with template presets (Default, Docs, Article, Compact) and toolbar access.
- Added richer Markdown-to-HTML rendering for headings, lists, blockquotes, code fences, links, and inline formatting in preview mode.
- Improved Markdown code-block typography/spacing in preview so fenced blocks render with tighter, editor-like line density.
- Improved editor-to-binding synchronization safeguards while the text view has focus to prevent stale-state overwrites during active interaction.
- Fixed cursor/caret jump regressions where selection could unexpectedly snap to a much earlier position after paste/update timing races.
Full release history: CHANGELOG.md
Known Limitations
- Intel Macs are not fully validated.
- Vim support is intentionally basic (not full Vim emulation).
- iOS/iPad editor functionality is still more limited than macOS.
Privacy & Security
- Privacy policy:
PRIVACY.md. - API keys are stored in Keychain (
SecureTokenStore), notUserDefaults. - Network traffic uses HTTPS.
- No telemetry.
- External AI requests only occur when code completion is enabled and a provider is selected.
- Security policy and reporting details:
SECURITY.md.
Release Integrity
- Tag:
v0.4.32 - Tagged commit:
1c31306 - Verify local tag target:
git rev-parse --verify v0.4.32
- Verify downloaded artifact checksum locally:
shasum -a 256 <downloaded-file>
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
- macOS 26 (Tahoe)
- Xcode compatible with macOS 26 toolchain
- Apple Silicon recommended
Build from source
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
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
Git hooks
To auto-increment Xcode CURRENT_PROJECT_VERSION on every commit:
scripts/install_git_hooks.sh
Support
If you want to support development:
License
Neon Vision Editor is licensed under the MIT License.
See LICENSE.