@smbcloud / cli
Code Commits Issues Pulls Cloud Agent CI/CD
feature/fix-clippy-on-stable-channel
claude/smbcloud-github-app-k9641p development feature/apps feature/build-release feature/ci-docs feature/ci-ruby-gems feature/cicd feature/completion feature/dist-nuget feature/fix-ci-sdk-pypi-rubygem feature/fix-clippy-on-stable-channel feature/fix-deployment-script feature/github-email feature/gresiq-v1 feature/project-new-structure feature/rsync-deploy feature/ruby-runner feature/sdk-npm feature/sdk-workflows feature/smbcloud-cli-release-npm feature/smbcloud-deploy feature/wasm main release/v0.7.4
md 45 lines 1.68 KB
Rendered Raw
1 # smbcloud-deploy
2
3 The build and deploy engine behind [smbCloud](https://smbcloud.xyz) and the
4 [`smb` CLI](https://github.com/smbcloudXYZ/smbcloud-cli).
5
6 `smbcloud-deploy` takes one app from a repo and ships it: detect the runtime,
7 build it, and transfer the result to the server. The engine is UI-agnostic and
8 auth-agnostic, so the same code drives the interactive CLI, CI pipelines, and the
9 server-side git receiver. They differ only in how they report progress and how
10 they authenticate.
11
12 ## Design
13
14 Two things are inverted so the engine stays reusable:
15
16 - `Reporter` takes the place of direct terminal output. The engine reports steps;
17 the caller decides how to render them. The CLI uses spinners, CI prints plain
18 lines, and the server streams output back over the git push.
19 - Authentication is passed in. The engine never reads local credentials or
20 prompts for login; a token or credentials come from the caller.
21
22 Transport sits behind a `Transport` trait, so rsync today and git-smart-HTTP
23 later are swappable without changing any caller.
24
25 ## Status
26
27 Early and moving. This crate is extracted from the `smb` CLI so the deploy logic
28 lives in one place. The API will change while the surface settles.
29
30 ## Part of smbCloud
31
32 smbCloud is a local-first build and deployment platform for shipping web apps,
33 APIs, and inference services from a repo to production. You build locally, push
34 the artifact, and smbCloud places it and serves it.
35
36 - Homepage: [smbcloud.xyz](https://smbcloud.xyz)
37 - CLI and source: [github.com/smbcloudXYZ/smbcloud-cli](https://github.com/smbcloudXYZ/smbcloud-cli)
38
39 ## License
40
41 [Apache-2.0](LICENSE)
42
43 ## Copyright
44
45 © 2026 [Splitfire AB](https://5mb.app) ([smbCloud](https://smbcloud.xyz)).