Skip to content

About

A native macOS browser with SwiftUI, AppKit, WebKit, and optional Chromium. Spaces, pins, profiles, and recoverable browsing. GPLv3.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

46 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Cobble — an otter holding a stone

Cobble

A native Mac browser. A quieter place for your tabs.

macOS 26 or later Swift 6 In development

Download beta · Build · Architecture · Features · Roadmap

A home for your browsing

🪨 Make it yours 🗂 Keep your place ⌨ Stay in flow
Native themes, fonts, and accents Spaces, favorites, pins, and folders Command bar and customizable shortcuts
SwiftUI chrome with AppKit windows Independent windows and session recovery Local tab search and native menus

WebKit renders the web. Cobble owns the browser around it: organization, profiles, downloads, permissions, history, and recovery. English and Spanish UI. No telemetry or AI chrome.

Under the surface

flowchart LR
    A[AppKit · windows & commands] --> B[SwiftUI · browser chrome]
    B --> C[Browser models & engine contracts]
    C --> D[System WebKit]
    C --> E[Versioned persistence]
Loading

Engine-neutral contracts keep browser state separate from rendering. Saved organization is shared; live tabs and selection belong to each window. Private tabs stay out of session snapshots.

Use system WebKit or the experimental Chrome SDK. Both projects publish their source. Chromium requires a separate engine build; it isn’t required for WebKit. See Chromium build instructions.

Download

Download Cobble 0.1.0 beta 3 · ZIP — Apple silicon · macOS 26+ · includes WebKit and Chromium.

Extract and drag Cobble into Applications. Developer ID-signed and notarized by Apple. Opt into update checks to receive future releases inside Cobble; you choose when to install and restart.

Build

Requires macOS 26+ and Xcode. The command below was verified with Xcode 27.0. Open Cobble.xcodeproj and use the Cobble scheme, or build without signing:

DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer \
  xcodebuild -project Cobble.xcodeproj -scheme Cobble \
  -configuration Debug -destination 'platform=macOS' \
  -derivedDataPath .build/webkit CODE_SIGNING_ALLOWED=NO build

The app is at .build/webkit/Build/Products/Debug/Cobble.app. Replace build with test to run the isolated hosted tests. Signed capabilities require your own development identity and applicable Apple entitlements.

./Scripts/test.sh runs the hosted tests directly. swift build / swift test build and check the Chromium client against the pinned SDK; they do not compile Chromium itself. The optional Scripts/run.sh wrapper uses a separate build-kit checkout.

Still in development

Full release builds include Sparkle updates, hosted on GitHub with signed archives and a signed feed. Release qualification is still pending.

This is an early beta. Apple Passwords/passkeys, accessibility, real-site compatibility, installed version-to-version updates, clean-Mac distribution and daily-use qualification still have open gates.

→ Authentication checklist · Apple browser requirements · Release gates

License: GNU GPLv3 (GPL-3.0-only) for original project code. Third-party notices.

About

A native macOS browser with SwiftUI, AppKit, WebKit, and optional Chromium. Spaces, pins, profiles, and recoverable browsing. GPLv3.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages