Synapse Notes is a powerful Markdown-based knowledge management application exclusively built for macOS using SwiftUI. It's your second brain, backed by YOUR Git repository, and is deeply customizable.
synapse-notes/
├── macOS/ # macOS app (current)
│ ├── SynapseNotes/ # Source files
│ ├── SynapseNotesTests/ # Test suite
│ ├── Synapse Notes.xcodeproj
│ └── project.yml
├── marketing-site/ # Documentation website
└── ... # Shared resources
- macOS 14+
- Xcode 16+
- Homebrew
xcodegen
Install xcodegen if needed:
brew install xcodegenPreferred: run it entirely from the CLI.
- Generate the Xcode project:
cd macOS && xcodegen generate- Build the app:
cd macOS && xcodebuild -project "Synapse Notes.xcodeproj" -scheme "Synapse" -destination "platform=macOS" build- Launch the built app:
open ~/Library/Developer/Xcode/DerivedData/Synapse_Notes-*/Build/Products/Debug/"Synapse Notes.app"Or do all three steps in one shot:
cd macOS && xcodegen generate && xcodebuild -project "Synapse Notes.xcodeproj" -scheme "Synapse" -destination "platform=macOS" build && open ~/Library/Developer/Xcode/DerivedData/Synapse_Notes-*/Build/Products/Debug/"Synapse Notes.app"The app is built into Xcode DerivedData under the Debug products folder.
If you prefer Xcode:
open "macOS/Synapse Notes.xcodeproj"Then select the Synapse scheme and press Cmd-R.
Run tests from the command line:
cd macOS && xcodebuild test -project "Synapse Notes.xcodeproj" -scheme Synapse -destination 'platform=macOS'Or run tests in Xcode:
- Open the project:
open "macOS/Synapse Notes.xcodeproj" - Select the
Synapsescheme - Press
Cmd-Uto run all tests
If Synapse Notes saves you money on a notes app subscription or just sparks a little joy, a coffee goes a long way. ☕
MIT License — see LICENSE for details.