Skip to content

armgit / cra

Public Imported from GitHub
0

The open-source Arc replacement for macOS. Spaces, pinned tabs, split view, Little Windows and Arc's shortcuts on Chromium, with your Arc sidebar imported in one go.

Arc parity: Help ▸ Essential Keyboard Shortcuts, Arc's floating card of five shortcuts

Victora6b5d415f73e
diff --git a/Sources/Cra/App/AppDelegate.swift b/Sources/Cra/App/AppDelegate.swift
index 5113cc0..0fb9f05 100644
--- a/Sources/Cra/App/AppDelegate.swift
+++ b/Sources/Cra/App/AppDelegate.swift
@@ -1279,6 +1279,11 @@ final class AppDelegate: NSObject, NSApplicationDelegate, NSMenuItemValidation {
case "appearanceAutomatic": store.settings.websiteAppearance = .automatic
case "appearanceLight": store.settings.websiteAppearance = .light
case "appearanceDark": store.settings.websiteAppearance = .dark
+ case "essentialShortcuts":
+ EssentialShortcutsWindow.shared.show(bindings: bindings) { [weak self] in
+ self?.showSettingsWindow()
+ self?.settingsController?.show(.shortcuts)
+ }
case "revealData": NSWorkspace.shared.activateFileViewerSelecting([AppPaths.supportDir])
case "copyAppInfo": copy(appInfo())
case "print": main.currentBrowser?.print()
@@ -1573,6 +1578,7 @@ final class AppDelegate: NSObject, NSApplicationDelegate, NSMenuItemValidation {
let help = NSMenu(title: "Help")
help.addItem(withTitle: "Chromium \(CraCEFRuntime.chromiumVersion()) · CEF \(CraCEFRuntime.cefVersion())", action: nil, keyEquivalent: "")
help.addItem(.separator())
+ help.addItem(item("essentialShortcuts"))
for (title, url) in [("Cra Help", "https://crabrowser.app/help"), ("Release Notes", "https://crabrowser.app/release-notes"),
("Report an Issue…", "https://github.com/VictorKildahl/cra/issues"), ("Support Cra…", "https://crabrowser.app/support")] {
let link = NSMenuItem(title: title, action: #selector(openHelpLink(_:)), keyEquivalent: "")
diff --git a/Sources/Cra/App/KeyBindings.swift b/Sources/Cra/App/KeyBindings.swift
index cefec44..a48b669 100644
--- a/Sources/Cra/App/KeyBindings.swift
+++ b/Sources/Cra/App/KeyBindings.swift
@@ -243,6 +243,9 @@ final class KeyBindingRegistry {
triggers: ["language", "languages", "preferred language", "accept language"], symbol: "globe"),
KeyAction(id: "checkForUpdates", name: "Check for Updates…", section: .app, shortcuts: [],
triggers: ["update", "upgrade", "new version"], symbol: "arrow.down.circle"),
+ // Arc: Help ▸ Essential Keyboard Shortcuts.
+ KeyAction(id: "essentialShortcuts", name: "Essential Keyboard Shortcuts", section: .help, shortcuts: [],
+ triggers: ["shortcuts", "keyboard shortcuts", "hotkeys"], symbol: "keyboard"),
// Arc: Help ▸ Troubleshooting ▸ Reveal Arc Data, Copy Arc Info.
KeyAction(id: "revealData", name: "Reveal Cra Data", section: .help, shortcuts: [], triggers: ["data folder", "reveal data"]),
KeyAction(id: "copyAppInfo", name: "Copy Cra Info", section: .help, shortcuts: [], triggers: ["version", "copy info"]),
diff --git a/Sources/Cra/UI/Windows/EssentialShortcutsWindow.swift b/Sources/Cra/UI/Windows/EssentialShortcutsWindow.swift
new file mode 100644
index 0000000..6b522de
--- /dev/null
+++ b/Sources/Cra/UI/Windows/EssentialShortcutsWindow.swift
@@ -0,0 +1,148 @@
+import AppKit
+import SwiftUI
+
+/// Arc's Help ▸ Essential Keyboard Shortcuts (KeyboardShortcutsEDUWindowController, Arc 1.172.1,
+/// captured 7 Nov 2026 at 2x): a 475 × 462 pt floating window, #161C2F, traffic lights only,
+/// opening at the top right of the screen. "Essential Keyboard Shortcuts" in heavy 20.5 pt at 30 pt
+/// in, a "View All ↗" button (96 × 28, #282D3F, 6 pt corners, a faint rim) level with it, then
+/// five rows 73 pt apart: a 15 pt title, a 12 pt grey line under it, the shortcut's key caps on
+/// the right, and a #212739 hairline between rows. Each cap is 28 pt: a light blue face (#EEF3FB
+/// at the top to #CFDDF5) in a blue rim, on a #2B60C4 lip, the glyph in blue. Cra's rows show the
+/// user's own bindings.
+@MainActor
+final class EssentialShortcutsWindow {
+ static let shared = EssentialShortcutsWindow()
+ private var panel: NSPanel?
+
+ /// The rows: Arc's five, with Cra's action for each.
+ static let rows: [(action: String, title: String, detail: String)] = [
+ ("newTab", "Open a New Tab", "Open the Command Bar to create a new tab"),
+ ("recentTab", "Switch to a Recent Tab", "Hold this to quickly switch between recent tabs"),
+ ("copyURL", "Copy Page URL", "Copy the current tab's URL without trackers"),
+ ("addSplitView", "Add Split View", "View multiple websites side-by-side"),
+ ("newLittleWindow", "Open Little Window", "Use a smaller browser window for quick searches"),
+ ]
+
+ func show(bindings: KeyBindingRegistry, viewAll: @escaping () -> Void) {
+ if let panel {
+ panel.makeKeyAndOrderFront(nil)
+ return
+ }
+ let size = NSSize(width: 475, height: 462)
+ let p = NSPanel(contentRect: NSRect(origin: .zero, size: size),
+ styleMask: [.titled, .closable, .miniaturizable, .fullSizeContentView], backing: .buffered, defer: false)
+ p.titlebarAppearsTransparent = true
+ p.titleVisibility = .hidden
+ p.title = "Essential Keyboard Shortcuts"
+ p.isMovableByWindowBackground = true
+ p.level = .floating
+ p.isReleasedWhenClosed = false
+ p.hidesOnDeactivate = false
+ p.appearance = NSAppearance(named: .darkAqua)
+ p.backgroundColor = NSColor(srgbRed: 0x16 / 255.0, green: 0x1C / 255.0, blue: 0x2F / 255.0, alpha: 1)
+ p.standardWindowButton(.zoomButton)?.isEnabled = false
+ let host = NSHostingView(rootView: EssentialShortcutsView(bindings: bindings, viewAll: { [weak p] in
+ p?.close()
+ viewAll()
+ }))
+ host.sizingOptions = [] // the title bar sits inside Arc's 462 pt, so the view doesn't size the window
+ p.contentView = host
+ p.setFrame(NSRect(origin: .zero, size: size), display: false)
+ if let screen = NSScreen.main {
+ let v = screen.visibleFrame
+ p.setFrameOrigin(NSPoint(x: v.maxX - size.width - 10, y: v.maxY - size.height - 10))
+ }
+ panel = p
+ p.makeKeyAndOrderFront(nil)
+ }
+}
+
+private struct EssentialShortcutsView: View {
+ let bindings: KeyBindingRegistry
+ let viewAll: () -> Void
+
+ var body: some View {
+ VStack(alignment: .leading, spacing: 0) {
+ HStack(alignment: .center) {
+ Text("Essential Keyboard Shortcuts")
+ .font(.system(size: 20.5, weight: .heavy))
+ .kerning(-0.3)
+ .foregroundStyle(.white)
+ Spacer(minLength: 8)
+ ViewAllButton(action: viewAll)
+ }
+ .frame(height: 28)
+ .padding(.top, 37.5)
+ .padding(.bottom, 3)
+ ForEach(Array(EssentialShortcutsWindow.rows.enumerated()), id: \.offset) { i, row in
+ if i > 0 {
+ Rectangle().fill(Color(red: 0x21 / 255, green: 0x27 / 255, blue: 0x39 / 255)).frame(height: 1)
+ }
+ HStack(alignment: .center, spacing: 12) {
+ VStack(alignment: .leading, spacing: 2.5) {
+ Text(row.title).font(.system(size: 15)).foregroundStyle(.white)
+ Text(row.detail).font(.system(size: 12)).foregroundStyle(.white.opacity(0.62)).lineLimit(1)
+ }
+ Spacer(minLength: 8)
+ HStack(spacing: 3) {
+ ForEach(Array((bindings.action(row.action)?.primary?.caps ?? []).enumerated()), id: \.offset) { _, cap in
+ KeyCap(text: cap == "⇥" ? "TAB" : cap)
+ }
+ }
+ }
+ .frame(height: 72)
+ }
+ Spacer(minLength: 0)
+ }
+ .padding(.horizontal, 30)
+ .frame(width: 475, height: 462, alignment: .topLeading)
+ }
+}
+
+private struct ViewAllButton: View {
+ let action: () -> Void
+ @State private var hover = false
+
+ var body: some View {
+ Button(action: action) {
+ HStack(spacing: 8) {
+ Text("View All").font(.system(size: 14))
+ Image(systemName: "arrow.up.right").font(.system(size: 12, weight: .medium))
+ }
+ .foregroundStyle(.white.opacity(0.92))
+ .frame(width: 96, height: 28)
+ .background(RoundedRectangle(cornerRadius: 6, style: .continuous)
+ .fill(Color(red: 0x28 / 255, green: 0x2D / 255, blue: 0x3F / 255).opacity(hover ? 0.8 : 1)))
+ .overlay(RoundedRectangle(cornerRadius: 6, style: .continuous).strokeBorder(.white.opacity(0.1), lineWidth: 1))
+ }
+ .buttonStyle(.plain)
+ .onHover { hover = $0 }
+ }
+}
+
+/// One key cap, as Arc draws it: a light blue face in a blue rim, on a darker blue lip.
+private struct KeyCap: View {
+ let text: String
+
+ private static let rim = Color(red: 0x2F / 255, green: 0x6F / 255, blue: 0xE8 / 255)
+ private static let lip = Color(red: 0x2B / 255, green: 0x60 / 255, blue: 0xC4 / 255)
+
+ var body: some View {
+ ZStack(alignment: .top) {
+ RoundedRectangle(cornerRadius: 6, style: .continuous).fill(Self.lip)
+ RoundedRectangle(cornerRadius: 6, style: .continuous).fill(Self.rim).frame(height: 26)
+ RoundedRectangle(cornerRadius: 4.5, style: .continuous)
+ .fill(LinearGradient(colors: [Color(red: 0xEE / 255, green: 0xF3 / 255, blue: 0xFB / 255),
+ Color(red: 0xCF / 255, green: 0xDD / 255, blue: 0xF5 / 255)],
+ startPoint: .top, endPoint: .bottom))
+ .overlay(RoundedRectangle(cornerRadius: 4.5, style: .continuous).strokeBorder(.white.opacity(0.7), lineWidth: 0.75))
+ .padding(1.5)
+ .frame(height: 26)
+ Text(text)
+ .font(.system(size: text.count > 1 ? 10.5 : 15, weight: .bold, design: .rounded))
+ .foregroundStyle(Self.rim)
+ .frame(height: 26)
+ }
+ .frame(width: text.count > 1 ? 34 : 28, height: 29)
+ }
+}