feat: @polkadot-apps/cli

.github/workflows/cli-dev-release.yml

@@ -0,0 +1,54 @@
+name: CLI Dev Release
+
+on:
+    push:
+        branches: [ch/cli]
+
+permissions:
+    contents: write
+
+jobs:
+    release:
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v4
+            - uses: oven-sh/setup-bun@v2
+              with:
+                  bun-version: "1.2.x"
+            - uses: pnpm/action-setup@v4
+            - uses: actions/setup-node@v4
+              with:
+                  node-version: "22"
+
+            - run: pnpm install
+            - run: pnpm build
+
+            # Delete previous dev release so we can recreate it
+            - name: Delete previous dev release
+              run: gh release delete cli-dev --cleanup-tag -y 2>/dev/null || true
+              env:
+                  GH_TOKEN: ${{ github.token }}
+
+            - name: Compile CLI binaries
+              run: |
+                  bun build --compile --target=bun-linux-x64 ./apps/cli/src/index.ts --outfile dot-linux-x64
+                  bun build --compile --target=bun-linux-arm64 ./apps/cli/src/index.ts --outfile dot-linux-arm64
+                  bun build --compile --target=bun-darwin-x64 ./apps/cli/src/index.ts --outfile dot-darwin-x64
+                  bun build --compile --target=bun-darwin-arm64 ./apps/cli/src/index.ts --outfile dot-darwin-arm64
+
+            - name: Create dev release
+              uses: softprops/action-gh-release@v2
+              with:
+                  tag_name: cli-dev
+                  name: CLI Dev Build
+                  prerelease: true
+                  make_latest: false
+                  files: |
+                      dot-linux-x64
+                      dot-linux-arm64
+                      dot-darwin-x64
+                      dot-darwin-arm64
+                  body: |
+                      Dev build from `ch/cli` branch.
+
+                      Install: `DOT_TAG=cli-dev curl -fsSL https://raw.githubusercontent.com/paritytech/polkadot-apps/ch/cli/install.sh | bash`

.github/workflows/release.yml

@@ -39,6 +39,10 @@ jobs:
                     echo "found=false" >> $GITHUB_OUTPUT
                   fi
 
+            - if: steps.bot.outputs.skip != 'true' && steps.changesets.outputs.found == 'true'
+              uses: oven-sh/setup-bun@v2
+              with:
+                  bun-version: "1.2.x"
             - if: steps.bot.outputs.skip != 'true' && steps.changesets.outputs.found == 'true'
               uses: pnpm/action-setup@v4
             - if: steps.bot.outputs.skip != 'true' && steps.changesets.outputs.found == 'true'
@@ -124,3 +128,34 @@ jobs:
                   inputs: '${{ format(''{{ "repo": "{0}", "run_id": "{1}" }}'', github.repository, github.run_id) }}'
               env:
                   GITHUB_TOKEN: ${{ secrets.NPM_PUBLISH_AUTOMATION_TOKEN }}
+
+            # Compile CLI binaries for all platforms
+            - name: Compile CLI binaries
+              if: steps.bot.outputs.skip != 'true' && steps.changesets.outputs.found == 'true'
+              run: |
+                  bun build --compile --target=bun-linux-x64 ./apps/cli/src/index.ts --outfile dot-linux-x64
+                  bun build --compile --target=bun-linux-arm64 ./apps/cli/src/index.ts --outfile dot-linux-arm64
+                  bun build --compile --target=bun-darwin-x64 ./apps/cli/src/index.ts --outfile dot-darwin-x64
+                  bun build --compile --target=bun-darwin-arm64 ./apps/cli/src/index.ts --outfile dot-darwin-arm64
+
+            - name: Generate CLI release tag
+              if: steps.bot.outputs.skip != 'true' && steps.changesets.outputs.found == 'true'
+              id: cli_tag
+              run: |
+                  VERSION=$(node -p "require('./apps/cli/package.json').version")
+                  TAG="v${VERSION}"
+                  echo "tag=$TAG" >> $GITHUB_OUTPUT
+                  echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+            - name: Create GitHub Release
+              if: steps.bot.outputs.skip != 'true' && steps.changesets.outputs.found == 'true'
+              uses: softprops/action-gh-release@v2
+              with:
+                  tag_name: ${{ steps.cli_tag.outputs.tag }}
+                  name: Release ${{ steps.cli_tag.outputs.tag }}
+                  files: |
+                      dot-linux-x64
+                      dot-linux-arm64
+                      dot-darwin-x64
+                      dot-darwin-arm64
+                  generate_release_notes: true

.gitignore

@@ -7,3 +7,4 @@ coverage/
 .pnpm-store/
 reference-repos/
 docs/
+.cdm/

CLAUDE.md

@@ -13,10 +13,32 @@ Follow the contributor guidelines in `README.md`.
 - **Format check:** `pnpm format:check`
 - **Generate descriptors:** `pnpm generate-descriptors`
 - **Generate docs:** `pnpm docs`
+- **Install CLI locally:** `pnpm cli:install`
+
+## CLI
+
+- The CLI lives at `apps/cli/` and installs as `dot`. Compiles to a standalone binary via `bun build --compile`.
+- **Dev:** `bun run apps/cli/src/index.ts` (runs TypeScript directly)
+- **Local install:** `pnpm cli:install` (builds all packages, compiles binary to `~/.polkadot/bin/dot`)
+- **End-user install:** `bash install.sh` (downloads binary from GitHub Releases, uses `gh` for private repo auth)
+- The CLI is `private: true` — not published to npm. Distributed as compiled binaries via GitHub Releases.
+- Commands are separate files in `apps/cli/src/commands/`, each exporting a `Command` instance registered via `program.addCommand()`.
+- Contract ABI (`cdm.json`) is managed by CDM — `postinstall` runs `cdm i` automatically if cdm is available.
+
+**Commands:** `init`, `remix`, `build`, `deploy`, `info`, `update`
+
+| Command | Purpose |
+|---------|---------|
+| `dot init` | Set up dev environment (Rust toolchain, gh CLI) and authenticate |
+| `dot remix [domain]` | Fork an app — interactive picker if no domain, `--quest` flag (stubbed) |
+| `dot build` | Detect and build contracts (Rust) and frontend |
+| `dot deploy` | Deploy contracts + frontend to Bulletin. `--playground` to also publish to registry |
+| `dot info <domain>` | Show detailed app information from the registry |
+| `dot update` | Self-update from GitHub Releases |
 
 ## Key Conventions
 
-- All packages live in `packages/<name>/` and are scoped under `@polkadot-apps/`.
+- All packages live in `packages/<name>/` and are scoped under `@polkadot-apps/`. The CLI lives in `apps/cli/`.
 - Use in-source testing (`if (import.meta.vitest)` blocks) for unit tests. Separate `tests/*.test.ts` files are for integration tests only.
 - Internal deps use `"workspace:*"`, shared versions use `"catalog:"` from `pnpm-workspace.yaml`.
 - Packages must be framework-agnostic pure TypeScript. No React/Vue imports in core packages.

apps/cli/cdm.json

@@ -0,0 +1,248 @@
+{
+    "targets": {
+        "acc2c3b5e912b762": {
+            "asset-hub": "wss://asset-hub-paseo-rpc.n.dwellir.com",
+            "bulletin": "https://paseo-ipfs.polkadot.io/ipfs"
+        }
+    },
+    "dependencies": {
+        "acc2c3b5e912b762": {
+            "@example/playground-registry": "latest"
+        }
+    },
+    "contracts": {
+        "acc2c3b5e912b762": {
+            "@example/playground-registry": {
+                "version": 6,
+                "address": "0x279585Cb8E8971e34520A3ebbda3E0C4D77C3d97",
+                "abi": [
+                    {
+                        "type": "constructor",
+                        "inputs": [],
+                        "stateMutability": "nonpayable"
+                    },
+                    {
+                        "type": "function",
+                        "name": "publish",
+                        "inputs": [
+                            {
+                                "name": "domain",
+                                "type": "string"
+                            },
+                            {
+                                "name": "metadata_uri",
+                                "type": "string"
+                            }
+                        ],
+                        "outputs": [],
+                        "stateMutability": "nonpayable"
+                    },
+                    {
+                        "type": "function",
+                        "name": "unpublish",
+                        "inputs": [
+                            {
+                                "name": "domain",
+                                "type": "string"
+                            }
+                        ],
+                        "outputs": [],
+                        "stateMutability": "nonpayable"
+                    },
+                    {
+                        "type": "function",
+                        "name": "rateApp",
+                        "inputs": [
+                            {
+                                "name": "domain",
+                                "type": "string"
+                            },
+                            {
+                                "name": "rating",
+                                "type": "uint8"
+                            },
+                            {
+                                "name": "comment_uri",
+                                "type": "string"
+                            }
+                        ],
+                        "outputs": [],
+                        "stateMutability": "nonpayable"
+                    },
+                    {
+                        "type": "function",
+                        "name": "removeRating",
+                        "inputs": [
+                            {
+                                "name": "domain",
+                                "type": "string"
+                            },
+                            {
+                                "name": "reviewer",
+                                "type": "address"
+                            }
+                        ],
+                        "outputs": [],
+                        "stateMutability": "nonpayable"
+                    },
+                    {
+                        "type": "function",
+                        "name": "getContextId",
+                        "inputs": [],
+                        "outputs": [
+                            {
+                                "name": "",
+                                "type": "bytes32"
+                            }
+                        ],
+                        "stateMutability": "view"
+                    },
+                    {
+                        "type": "function",
+                        "name": "getAppCount",
+                        "inputs": [],
+                        "outputs": [
+                            {
+                                "name": "",
+                                "type": "uint32"
+                            }
+                        ],
+                        "stateMutability": "view"
+                    },
+                    {
+                        "type": "function",
+                        "name": "getDomainAt",
+                        "inputs": [
+                            {
+                                "name": "index",
+                                "type": "uint32"
+                            }
+                        ],
+                        "outputs": [
+                            {
+                                "name": "",
+                                "type": "tuple",
+                                "components": [
+                                    {
+                                        "name": "isSome",
+                                        "type": "bool"
+                                    },
+                                    {
+                                        "name": "value",
+                                        "type": "string"
+                                    }
+                                ]
+                            }
+                        ],
+                        "stateMutability": "view"
+                    },
+                    {
+                        "type": "function",
+                        "name": "getOwnerAppCount",
+                        "inputs": [
+                            {
+                                "name": "owner",
+                                "type": "address"
+                            }
+                        ],
+                        "outputs": [
+                            {
+                                "name": "",
+                                "type": "uint32"
+                            }
+                        ],
+                        "stateMutability": "view"
+                    },
+                    {
+                        "type": "function",
+                        "name": "getOwnerDomainAt",
+                        "inputs": [
+                            {
+                                "name": "owner",
+                                "type": "address"
+                            },
+                            {
+                                "name": "index",
+                                "type": "uint32"
+                            }
+                        ],
+                        "outputs": [
+                            {
+                                "name": "",
+                                "type": "tuple",
+                                "components": [
+                                    {
+                                        "name": "isSome",
+                                        "type": "bool"
+                                    },
+                                    {
+                                        "name": "value",
+                                        "type": "string"
+                                    }
+                                ]
+                            }
+                        ],
+                        "stateMutability": "view"
+                    },
+                    {
+                        "type": "function",
+                        "name": "getSudo",
+                        "inputs": [],
+                        "outputs": [
+                            {
+                                "name": "",
+                                "type": "address"
+                            }
+                        ],
+                        "stateMutability": "view"
+                    },
+                    {
+                        "type": "function",
+                        "name": "getMetadataUri",
+                        "inputs": [
+                            {
+                                "name": "domain",
+                                "type": "string"
+                            }
+                        ],
+                        "outputs": [
+                            {
+                                "name": "",
+                                "type": "tuple",
+                                "components": [
+                                    {
+                                        "name": "isSome",
+                                        "type": "bool"
+                                    },
+                                    {
+                                        "name": "value",
+                                        "type": "string"
+                                    }
+                                ]
+                            }
+                        ],
+                        "stateMutability": "view"
+                    },
+                    {
+                        "type": "function",
+                        "name": "getOwner",
+                        "inputs": [
+                            {
+                                "name": "domain",
+                                "type": "string"
+                            }
+                        ],
+                        "outputs": [
+                            {
+                                "name": "",
+                                "type": "address"
+                            }
+                        ],
+                        "stateMutability": "view"
+                    }
+                ],
+                "metadataCid": "bafk2bzaceck7veaix4ttzyd6bmwlssgycrrlgilpat2c272nczzlrgnqy6fze"
+            }
+        }
+    }
+}