Windows
macOS · Linux · Windows · Containers · iOS and iPadOS · Android · ChromeOS · Browser · Node (WebAssembly)
potluckdb ships Windows targets for x86_64 and arm64. Every ecosystem except Go uses MSVC. The Rust and npm package names therefore include msvc.
Go links through gcc, which cannot read an MSVC import library. Its library comes from the separate MinGW-w64 target windows-x86_64-gnu. There is no GNU toolchain for Windows on arm64. Go therefore ships only for x86_64.
Requirements
Section titled “Requirements”Windows 10 or newer on x86_64 or arm64.
What ships
Section titled “What ships”| Language | Package | What it selects here | Pages |
|---|---|---|---|
| Python | potluckdb on PyPI | wheels win_amd64, win_arm64 | Install · Quickstart |
| JavaScript | @potluckdb/potluckdb on npm | runtime packages @potluckdb/potluckdb-win32-x64-msvc, @potluckdb/potluckdb-win32-arm64-msvc | Install · Quickstart |
| TypeScript | @potluckdb/potluckdb on npm | runtime packages @potluckdb/potluckdb-win32-x64-msvc, @potluckdb/potluckdb-win32-arm64-msvc | Install · Quickstart |
| Java | dev.potluckdb:potluckdb-jvm | runtime resources windows-x86_64, windows-arm64 | Install · Quickstart |
| Kotlin | dev.potluckdb:potluckdb-jvm | runtime resources windows-x86_64, windows-arm64 | 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 windows/amd64 | Install · Quickstart |
| Rust | potluckdb on crates.io | engine catalog rows windows-x86_64, windows-arm64 | Install · Quickstart |
| C# (.NET) | potluckdb on NuGet | runtime identifiers win-x64, win-arm64 | 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 |
Not shipped for this platform: Swift, Objective-C.
| Target | Python wheel | npm runtime package | Rust crate | NuGet RID | JVM resource | Go module library | C SDK archive |
|---|---|---|---|---|---|---|---|
windows-x86_64 | win_amd64 | @potluckdb/potluckdb-win32-x64-msvc | potluckdb | win-x64 | windows-x86_64 | — | potluckdb-c-sdk-0.1.0-windows-x86_64.zip |
windows-arm64 | win_arm64 | @potluckdb/potluckdb-win32-arm64-msvc | potluckdb | win-arm64 | windows-arm64 | — | potluckdb-c-sdk-0.1.0-windows-arm64.zip |
windows-x86_64-gnu | — | — | — | — | — | windows/amd64 | potluckdb-c-sdk-0.1.0-windows-x86_64-gnu.zip |
Install
Section titled “Install”Python, Node, Rust, Dart, JVM and .NET install as on other platforms. The installation pages give each command.
Go needs no runtime archive. The module contains the static runtime library for windows/amd64, acquired through go get. cgo needs MinGW-w64 gcc on PATH to link it.
C++ builds against the C SDK archive with any C++17 compiler. That archive’s CMake target links potluckdb_runtime_ffi.dll through its import library. Deploy the runtime DLL beside the executable. A Go or C++ program using a storage service also needs potluckdb_storage.dll beside the executable.
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, 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 runs the Go module’s suite on Windows using MinGW-w64 gcc and the module’s static runtime library. It supplies no external compiler or linker flags.
Each release also runs framework quickstarts on this platform: Electron, Tauri, Qt, Flutter, .NET MAUI. Each framework page describes its verification.