Features

• Focus & Break Timer: Customizable work intervals, short breaks, and long breaks with real-time circular progress visualization.

• Task Management: Create, edit, and organize tasks linked directly to focus sessions.

• Menu Bar Integration: Persistent menu bar status icon and dropdown for quick timer monitoring and controls.

• Session History & Analytics: Detailed session logs with manual adjustments, plus interactive charts (weekly focus distribution, monthly trends, task breakdowns, streak metrics) powered by Swift Charts.

• Native macOS Experience:

  • Pure local persistence via SwiftData (no cloud account required).

  • Local notifications and audio cues upon session completion.

  • Keyboard shortcuts for common actions.

  • Seamless Light and Dark mode appearance.

  • Accessibility labels and VoiceOver support.

Tech Stack

• UI Framework: SwiftUI & Swift Charts

• Persistence: SwiftData

• Language: Swift 6

• Target OS: macOS 14.0+ (Sonoma or later)

• Project Configuration: XcodeGen (project.yml)

Requirements

• Deployment Target: macOS 14.0+

• Toolchain: Swift 6 compatible toolchain

• Verified with: macOS, Xcode 26.6, Swift 6.3.3

Build & Run

Using Xcode

Open FocusPulse.xcodeproj in Xcode, select the FocusPulse scheme with a macOS destination, and click Run (⌘R).

Command Line Build

xcodebuild -project FocusPulse.xcodeproj -scheme FocusPulse -destination "platform=macOS,arch=arm64" clean build

Regenerate Xcode Project (Optional)

If you have XcodeGen installed, you can regenerate FocusPulse.xcodeproj from project.yml:

xcodegen generate

Running Tests

Run the full unit test suite via xcodebuild:

xcodebuild -project FocusPulse.xcodeproj -scheme FocusPulse -destination "platform=macOS,arch=arm64" clean test

Current Status

FocusPulse is an open-source, local-build macOS application.

License

FocusPulse is released under the MIT License.