kpkg — Universal Package Manager

• Area: Developer Platform
• Path: dev/kpkg
• Kind: CLI tool + Go library
• Version: 0.5.3

Role in the stack

kpkg is the toolchain for packaging, distributing, and installing Koder apps across all platforms. It defines the .kpkg format — a bootstrap-prepended ZIP that is self-executable on Linux/macOS — and provides the installer library consumed by khub (the Koder Hub CLI) and future tooling.

The design follows the aptdpkg model: one library (`dev.koder.kpkginstaller`), multiple consumers, no subprocess duplication.

Key capabilities:

• kpkg build — assembles .kpkg from a manifest + platform payload directories; exports .deb, .rpm, .AppImage, .msix via external toolchains
• kpkg build --from-bundle — packs a pre-built Flutter bundle without re-running build_cmd; used by CI (koder-release action) to produce .kpkg alongside tar.gz
• kpkg install — extracts the platform payload, creates symlinks, and registers OS launchers (Linux .desktop, macOS .app stub, Windows Start Menu .lnk)
• kpkg publish — signs with the developer's Koder ID ed25519 key and uploads to the Koder Hub via POST /api/v1/publish/<slug>
• Public library packages — dev.koder.kpkg/installer and dev.koder.kpkg/manifest can be imported by any Go module; avoids reimplementing install logic in each consumer

Install paths by OS

.kpkg format

<bootstrap shell script>
PK... (ZIP archive)
├── kpkg.toml          — manifest
├── icon.png           — 512×512 app icon
├── screenshots/       — optional
├── assets/            — optional
├── linux-amd64/       — platform payload (entry point = kpkg.toml [platforms] value)
├── macos-arm64/
├── win-x64/
└── kpkg.sig           — ed25519 signature (optional, warns if absent)

The bootstrap executes on chmod +x && ./app.kpkg: detects OS/arch, unzips the matching platform dir to a tempdir, and execs the entry point. If koder-hub is in PATH, it delegates to the Store installer instead.

Primary couplings