widefleet 0.3.1 → 0.3.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +16 -14
- package/package.json +7 -6
package/README.md
CHANGED
|
@@ -14,14 +14,10 @@ pnpm add --global widefleet
|
|
|
14
14
|
widefleet --version
|
|
15
15
|
```
|
|
16
16
|
|
|
17
|
-
|
|
17
|
+
If pnpm reports that its global bin directory is missing from PATH, run `pnpm setup`, open a new terminal, and retry the installation. This configures pnpm's global command directory for your shell.
|
|
18
18
|
|
|
19
19
|
To update, rerun the install command. To uninstall, run `pnpm remove --global widefleet`. pnpm owns the complete installation directory; keep its package contents together.
|
|
20
20
|
|
|
21
|
-
App access groups, the catalog, D1 migration commands and Workflows require
|
|
22
|
-
CLI and platform `0.3.0` or newer. Update matching platform components together;
|
|
23
|
-
see the [CLI version notes](https://widefleet.com/docs/reference/cli).
|
|
24
|
-
|
|
25
21
|
The CLI includes its native executable, bundler and SvelteKit starter. App
|
|
26
22
|
developers do not need Docker or a checkout of the platform repository when
|
|
27
23
|
connecting to an existing installation.
|
|
@@ -41,24 +37,29 @@ local URL printed by `pnpm dev`, then stop that server with Ctrl-C before contin
|
|
|
41
37
|
|
|
42
38
|
## Connect and deploy
|
|
43
39
|
|
|
44
|
-
|
|
40
|
+
Connect to your company and deploy with CLI 0.3.2 or newer:
|
|
45
41
|
|
|
46
42
|
```sh
|
|
47
|
-
export PLATFORM_URL=https://platform.example.com
|
|
48
43
|
widefleet login
|
|
49
44
|
pnpm check
|
|
50
45
|
widefleet deploy
|
|
51
46
|
```
|
|
52
47
|
|
|
53
|
-
|
|
54
|
-
|
|
48
|
+
If IT has configured your agent or computer, the CLI uses that platform address.
|
|
49
|
+
Otherwise, it asks for your work email or company domain and looks up the company's
|
|
50
|
+
discovery record. An agent or noninteractive terminal can supply
|
|
51
|
+
`widefleet login --email employee@example.com` or
|
|
52
|
+
`widefleet login --domain example.com`. These commands also work in PowerShell and Fish.
|
|
55
53
|
|
|
56
|
-
Approve the device code in your browser. The CLI stores credentials in your
|
|
54
|
+
Approve the device code in your browser. The CLI remembers the platform URL and stores credentials in your
|
|
57
55
|
operating system's credential store: Keychain on macOS, Credential Manager on
|
|
58
56
|
Windows, and Secret Service on Linux. The store must be available and unlocked.
|
|
59
57
|
|
|
60
|
-
|
|
61
|
-
|
|
58
|
+
Run `widefleet config show` to inspect the selected URL. If discovery is not set
|
|
59
|
+
up, IT can [configure company discovery or distribute configuration](https://widefleet.com/docs/self-hosting/company-setup).
|
|
60
|
+
|
|
61
|
+
For the local demo, run `widefleet login --url http://localhost:25450` and approve
|
|
62
|
+
the code with `admin@example.test`.
|
|
62
63
|
|
|
63
64
|
The target app is identified by your installation and the `name` in
|
|
64
65
|
`wrangler.jsonc`. The first deploy creates it when needed; later deploys update
|
|
@@ -70,7 +71,7 @@ For ongoing development, follow [app development](https://widefleet.com/docs/gui
|
|
|
70
71
|
|
|
71
72
|
## Headless login
|
|
72
73
|
|
|
73
|
-
On Linux and macOS without an available credential store
|
|
74
|
+
On Linux and macOS without an available credential store the CLI supports an
|
|
74
75
|
explicit session file. Set it before login and keep it set for subsequent commands:
|
|
75
76
|
|
|
76
77
|
```sh
|
|
@@ -96,7 +97,7 @@ widefleet logs --level error
|
|
|
96
97
|
```
|
|
97
98
|
|
|
98
99
|
Runtime logs require telemetry services enabled by the operator; the local demo
|
|
99
|
-
includes them.
|
|
100
|
+
includes them.
|
|
100
101
|
|
|
101
102
|
## If setup fails
|
|
102
103
|
|
|
@@ -105,6 +106,7 @@ includes them. A failed log query is not evidence that the app has no errors.
|
|
|
105
106
|
| Registry returns 404 | Check the package name and published version on [npm](https://www.npmjs.com/package/widefleet). |
|
|
106
107
|
| `widefleet` is not found | Reopen the terminal after `pnpm setup`; check `Get-Command widefleet -All` in PowerShell or `type -a widefleet` in Bash/Fish for an older installation on PATH. |
|
|
107
108
|
| Login cannot access the credential store | Check your operating system's credential store; see [headless login](#headless-login) for alternatives. |
|
|
109
|
+
| Company discovery fails | Check the email domain and ask IT to publish a discovery record or configure the agent; see [company setup](https://widefleet.com/docs/self-hosting/company-setup). |
|
|
108
110
|
| Deployment fails or stays queued | Follow [deployment diagnostics](https://widefleet.com/docs/guides/deployments#inspect-a-failure). |
|
|
109
111
|
|
|
110
112
|
Next, [share the app with colleagues](https://widefleet.com/docs/guides/applications) or
|
package/package.json
CHANGED
|
@@ -1,14 +1,15 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "widefleet",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.3",
|
|
4
4
|
"description": "Widefleet CLI with its Worker bundler and app starter",
|
|
5
|
+
"homepage": "https://widefleet.com",
|
|
5
6
|
"license": "MIT",
|
|
6
7
|
"type": "module",
|
|
7
8
|
"bin": {
|
|
8
9
|
"widefleet": "./bin/widefleet.mjs"
|
|
9
10
|
},
|
|
10
11
|
"engines": {
|
|
11
|
-
"node": ">=
|
|
12
|
+
"node": ">=22.18.0"
|
|
12
13
|
},
|
|
13
14
|
"os": [
|
|
14
15
|
"linux",
|
|
@@ -25,10 +26,10 @@
|
|
|
25
26
|
"LICENSE"
|
|
26
27
|
],
|
|
27
28
|
"optionalDependencies": {
|
|
28
|
-
"widefleet-linux-x64-gnu": "0.3.
|
|
29
|
-
"widefleet-darwin-arm64": "0.3.
|
|
30
|
-
"widefleet-darwin-x64": "0.3.
|
|
31
|
-
"widefleet-win32-x64-msvc": "0.3.
|
|
29
|
+
"widefleet-linux-x64-gnu": "0.3.3",
|
|
30
|
+
"widefleet-darwin-arm64": "0.3.3",
|
|
31
|
+
"widefleet-darwin-x64": "0.3.3",
|
|
32
|
+
"widefleet-win32-x64-msvc": "0.3.3"
|
|
32
33
|
},
|
|
33
34
|
"repository": {
|
|
34
35
|
"type": "git",
|