A native macOS code editor and file browser built with SwiftUI. Stuped offers syntax highlighting for 100+ languages, live Markdown and HTML preview with Mermaid diagram support, a file tree with real-time watching, and git branch display.
- Code editing with syntax highlighting (150+ languages via highlight.js), line numbers, and find bar
- In-window tabs in folder mode — each opened file gets a tab; unsaved changes are preserved per tab; right-click a tab to copy its name, project-relative path, or full path
- Session back/forward navigation in folder mode — Finder-style toolbar buttons walk the files you opened during the current run, including reopening files whose tabs were closed later
- Markdown preview with GitHub-flavored rendering, code blocks, and Mermaid diagrams
- HTML preview with live rendering in a WebView
- Image preview for PNG, JPEG, GIF, BMP, TIFF, WebP, HEIC, and ICO files
- Split view for side-by-side editing and preview, toggled via a floating icon overlay (Edit / Split / Preview)
- Live file reload — when an external process modifies a file that is open in a tab, the editor updates immediately (unmodified tabs only; tabs with unsaved edits are left untouched)
- File tree sidebar with color-coded file-type icons, git-change badges for changed files, real-time directory watching (kqueue), and right-click path-copy actions for files and folders
- Create from the file tree — select a folder, then use New File or New Folder to insert an inline draft row in the correct sorted position; press Return to create or Escape to cancel
- Path bar with clickable breadcrumb navigation and right-click to copy path
- Git integration showing current branch, remote origin tooltip, working-tree change badges, and a dedicated changed-files window
- Status bar with cursor position, line count, indentation, line endings, and encoding
- Dark/light mode support throughout, including preview themes
- Folder browsing mode for exploring project directories
- Recent files & folders — macOS
File > Open Recentkeeps handling document history, while Stuped keeps its own recent-folder history in a dedicated menu and the folder-mode Cmd+R quick switcher, which prefers the current session's file history first - Global file search (Cmd+Shift+F) — a native resizable panel that searches all files in the open folder tree by filename, contents, or both simultaneously; an inline
ext:field narrows results to a specific file extension; results and a line-level preview are shown in a draggable split view; navigate with ↑/↓, open with Enter, dismiss with Escape; the panel keeps a sensible minimum size even if a previous autosaved frame was too small - Reveal in File Tree (Cmd+Shift+J) — expands, scrolls to, and highlights the active file's node in the sidebar; useful after opening a file from search or recent files. Also accessible via right-click on any tab.
- View Options toolbar menu — a single
slider.horizontal.3toolbar button opens a dropdown with all view toggles (Word Wrap, Mini-Map, Show Dot Files) and navigation shortcuts (Reveal in File Tree, Recent Files & Folders, Search Files); active toggles show a checkmark - Binary file detection (null-byte scanning in first 8 KB)
Download Stuped.zip from the latest release, unzip, and move Stuped.app to /Applications.
Gatekeeper warning on first launch
Because Stuped is not notarized with Apple, macOS may show "Stuped is damaged and can't be opened". Remove the quarantine attribute before launching:
xattr -cr /Applications/Stuped.appThen double-click to open normally.
- macOS 15.0 or later
- Xcode 26.4 or later
- Swift 5.9
# Generate project (if using XcodeGen)
xcodegen generate
# Build from command line
xcodebuild -scheme Stuped -destination 'platform=macOS' build
# Or open in Xcode
open Stuped.xcodeproj- File > Open (Cmd+O) to open a single file in its own window
- Double-click a file in Finder to open it in Stuped
- Open Folder (Cmd+Shift+O) to browse an entire directory
- File > Open Recent to reopen files and folder workspaces from a consolidated history (seeded by macOS and Stuped)
For Markdown and HTML files, a small frosted-glass icon overlay appears in the top-right corner of the editor:
- Edit (
doc.plaintext) — code editor only - Split (
rectangle.split.2x1) — editor and preview side by side - Preview (
eye) — rendered preview only
Hover over each icon to see its tooltip. The overlay is hidden for plain source files and images.
| Shortcut | Action |
|---|---|
| Cmd+Shift+O | Open Folder |
| Cmd+R | Recent Files & Folders popup |
| Cmd+Shift+F | Open / close global file search panel |
| Cmd+1 / 2 / 3 | Switch to Edit / Split / Preview mode (previewable files only) |
| Cmd+Shift+J | Reveal active file in File Tree |
| Cmd+Shift+M | Toggle mini-map |
| Cmd+Shift+W | Toggle word wrap |
| Cmd+Shift+H | Toggle hidden files |
| Cmd+F | Find in editor |
| Cmd+Option+F | Find & Replace in editor |
In folder mode, the toolbar shows Finder-style Back / Forward buttons for the current session's file history. Going back or forward activates an existing tab when possible and reopens the file if that tab was closed later. The window title shows the active file name and falls back to the opened folder name when nothing is selected.
The Git Changes panel can be opened either from the git branch badge in the path bar or from View > Git Changes.
The path bar above the editor shows the full file path. Click any component to navigate the sidebar to that directory. Right-click any component to open the same Copy Path submenu used in tabs and the file tree:
- Name Only
- Relative to Project Root
- Full Path
In folder mode, right-click any tab to access Reveal in File Tree plus the shared Copy Path submenu. File-tree items expose the same Copy Path submenu with:
- Name Only
- Relative to Project Root
- Full Path
Select a folder in the sidebar to enable New File and New Folder in the folder-window menu, the View Options menu, and the file-tree context menu. The sidebar inserts a temporary inline row where the new item will sort; type the name, press Return to create it, or press Escape to remove the draft row. These create actions stay disabled when a file row is selected.
If the current file is inside a git repository, the branch name appears at the right end of the path bar. Hover for a tooltip showing the remote origin URL.
In folder mode, that branch badge is clickable and opens a native Git Changes window that groups repository changes into New, Modified, and Deleted. Selecting an available file from that window focuses the existing tab or opens a new one. The window preserves a sensible minimum size and ignores stale tiny autosaved frames. The file tree also color-codes changed files and adds overlay icons for their change type. Ignored files are excluded from this first-pass status view.
- Changelog -- version history (keep-a-changelog format)
- Architecture (arc42) -- system context, building blocks, runtime, deployment, quality
- ADR Index -- architecture decision records
- Specifications (
doc/spec/):- Overview -- system overview, terminology, tech stack, source layout
- App Lifecycle -- scenes, launch behavior, single-file vs folder mode
- Document Model -- StupedDocument, file types, binary detection
- Code Editor -- NSTextView, line numbers, highlighting, key handling
- Preview Rendering -- Markdown/HTML/image, WKWebView, JS libraries
- File Tree -- FileNode, FileTreeModel, directory watching
- Path Bar -- breadcrumb navigation, click handling, copy path
- Git Integration -- branch metadata, working-tree status, Git Changes window
- Status Bar -- cursor, indentation, line-ending detection
- Language Map -- extension-to-language mapping, preview types
| Dependency | Version | Purpose |
|---|---|---|
| HighlighterSwift | 1.0.0+ | Syntax highlighting engine |
Bundled JavaScript/CSS resources (not npm-managed):
| Resource | Purpose |
|---|---|
| markdown-it.min.js | Markdown parsing (CommonMark + extensions) |
| highlight.min.js | Code block syntax highlighting in preview |
| mermaid.min.js | Diagram and flowchart rendering |
| preview-styles.css | GitHub-style preview typography |
| hljs-github.css / hljs-github-dark.css | Code theme for light/dark mode |
Licensed under the Apache License, Version 2.0. See LICENSE for the full text.
Copyright 2026 Hüpattl! Software (https://huepattl.de)
All dependencies use compatible open-source licenses: HighlighterSwift (MIT), highlight.js (BSD-3-Clause), markdown-it (MIT), mermaid (MIT).