jaywcjlove

jaywcjlove / PermissionFlow

Public

Drag apps into the authorization window to easily grant macOS Sandbox/TCC permissions.

swift swift-package
15
0
100% credibility
Found Apr 19, 2026 at 15 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Swift
AI Summary

A Swift package for macOS apps that guides users to grant privacy permissions by opening the correct System Settings page and providing a floating draggable app icon for supported panes like Accessibility and Screen Recording.

How It Works

1
📱 Find a helpful app

You download a macOS app like a screen recorder or automation tool that needs special access to work fully.

2
⚠️ See permission prompt

The app shows a simple button explaining it needs permission for things like screen access or keyboard input.

3
🖱️ Click to grant access

Tap the friendly button, and it smoothly opens your System Settings to exactly the right privacy page.

4
🪟 Helper window pops up

A small floating guide appears right next to the settings window, following it if you move things around.

5
🖱️ Drag your app icon

Grab the app's icon from the floating helper and drop it into the permission list below – easy as dragging a file.

6
✅ Permission granted

The settings list updates instantly, and the helper window closes on its own.

🎉 App works perfectly

Go back to your app – now it has full access and runs smoothly without any more prompts.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 15 to 15 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is PermissionFlow?

PermissionFlow is a Swift package for macOS apps that streamlines granting Sandbox and TCC permissions like Accessibility or Screen Recording. Tap a button, and it opens the exact System Settings privacy pane with a floating panel that tracks the window and lets users drag apps into the authorization section via smooth animations. It also includes typed deeplinks for any System Settings page, with partial iOS support using SwiftUI and AppKit.

Why is it gaining traction?

Unlike manual instructions telling users to "drag apps to this section," it automates the flow with a native drag source for your .app bundle, window following, and auto-closing on Settings exit—making onboarding feel polished. The reusable buttons and controllers cut boilerplate for common pains like full disk access, while deeplinks handle everything from Displays resolution to Privacy anchors without guessing URL schemes. Devs love the example app demoing real drag-and-drop flows.

Who should use this?

macOS tool builders needing TCC perms for screen recording, input monitoring, or automation—think shortcut apps, recorders, or accessibility enhancers tired of copy-paste Settings URLs. Utility devs handling login items or Bluetooth via deeplinks. Skip if you're iOS-only or avoiding Swift packages.

Verdict

Grab it for macOS permission UX wins; the docs, API, and example shine despite 15 stars and 1.0% credibility signaling early maturity. Test in a prototype—solid foundation, but watch for OS updates breaking deeplinks.

(187 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.