macOS
macOS · Linux · Windows · Containers · iOS and iPadOS · Android · ChromeOS · Browser · Node (WebAssembly)
potluckdb ships two macOS targets: Apple silicon and Intel. Every language SDK is available. The tables use the release matrix to identify each language’s artifact.
Requirements
Section titled “Requirements”macOS 11 or newer. Apple silicon uses arm64 artifacts. Intel uses x86_64 artifacts. Nothing requires Rosetta.
What ships
Section titled “What ships”| Language | Package | What it selects here | Pages |
|---|---|---|---|
| Python | potluckdb on PyPI | wheels macosx_11_0_arm64, macosx_10_13_x86_64 | Install · Quickstart |
| JavaScript | @potluckdb/potluckdb on npm | runtime packages @potluckdb/potluckdb-darwin-arm64, @potluckdb/potluckdb-darwin-x64 | Install · Quickstart |
| TypeScript | @potluckdb/potluckdb on npm | runtime packages @potluckdb/potluckdb-darwin-arm64, @potluckdb/potluckdb-darwin-x64 | Install · Quickstart |
| Java | dev.potluckdb:potluckdb-jvm | runtime resources macos-arm64, macos-x86_64 | Install · Quickstart |
| Kotlin | dev.potluckdb:potluckdb-jvm | runtime resources macos-arm64, macos-x86_64 | Install · Quickstart |
| Swift | potluckdb from potluckdb-swift | xcframework slices macos-arm64_x86_64 | Install · Quickstart |
| Objective-C | potluckdb from potluckdb-swift | xcframework slices macos-arm64_x86_64 | Install · Quickstart |
| Dart | potluckdb on pub.dev | the requested target’s C SDK archive, verified by the build hook | Install · Quickstart |
| Flutter | potluckdb on pub.dev | the requested target’s C SDK archive, verified by the build hook | Install · Quickstart |
| Go | github.com/potluckdb/potluckdb-go | the static runtime library the module carries for darwin/arm64, darwin/amd64 | Install · Quickstart |
| Rust | potluckdb on crates.io | engine catalog rows macos-arm64, macos-x86_64 | Install · Quickstart |
| C# (.NET) | potluckdb on NuGet | runtime identifiers osx-arm64, osx-x64 | Install · Quickstart |
| C++ | the C SDK archive | the C SDK archive of the target | Install · Quickstart |
| C | the C SDK archive | the C SDK archive of the target | Install · Quickstart |
| Target | Python wheel | npm runtime package | Rust crate | NuGet RID | JVM resource | Go module library | C SDK archive |
|---|---|---|---|---|---|---|---|
macos-arm64 | macosx_11_0_arm64 | @potluckdb/potluckdb-darwin-arm64 | potluckdb | osx-arm64 | macos-arm64 | darwin/arm64 | potluckdb-c-sdk-0.1.0-macos-arm64.zip |
macos-x86_64 | macosx_10_13_x86_64 | @potluckdb/potluckdb-darwin-x64 | potluckdb | osx-x64 | macos-x86_64 | darwin/amd64 | potluckdb-c-sdk-0.1.0-macos-x86_64.zip |
Install
Section titled “Install”Each language installs from its registry. The package selects the runtime for the machine. The installation pages give each command.
Go links the static library inside its module and needs no archive. C++ links the C SDK archive’s shared runtime library. Both use the storage library from that archive. Dart’s build hook downloads it.
Swift and Objective-C share potluckdb-swift. Its runtime xcframework contains both architectures in one macOS slice. Its macOS storage xcframework contains the storage library for both architectures.
Quickstart
Section titled “Quickstart”Each quickstart is self-contained. Two databases represent a laptop and phone sharing one remote. They modify the same row before either synchronizes, then reach the same state. See Concepts for these terms.
The shortest route here uses Python:
- Install the package.
- Save the quickstart as
quickstart.py. - Run
python quickstart.py.
It prints Use query for this statement. and then quickstart: ok.
Every language shipped here has a quickstart: Python, JavaScript, TypeScript, Java, Kotlin, Swift, Objective-C, Dart, Flutter, Go, Rust, C# (.NET), C++, C.
Analytics
Section titled “Analytics”Analytical reads use DuckDB. No core package contains it. Python, Node and Rust install it through a package or crate feature.
Other languages load the library listed for this platform on the analytics engine page, with its URL and digest. Name that library in the open options. Each language’s installation page gives the exact line.
Verified by the release
Section titled “Verified by the release”Each release candidate builds every target in the table and passes every required check of the release matrix before promotion. The packages that this page names are the packages that the release tested.
Each release also runs framework quickstarts on this platform: Electron, Tauri, Qt, Flutter, .NET MAUI. Each framework page describes its verification.