widefleet 0.3.2 → 0.4.0
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 +26 -10
- package/package.json +7 -6
package/README.md
CHANGED
|
@@ -7,7 +7,8 @@ access to a Widefleet installation; if you do not have one yet, start with the
|
|
|
7
7
|
## Install the CLI
|
|
8
8
|
|
|
9
9
|
The CLI supports Linux x64 with glibc, macOS on Apple Silicon and Intel,
|
|
10
|
-
and Windows x64.
|
|
10
|
+
and Windows x64. For app development, use Node.js 22.18 or newer and an existing
|
|
11
|
+
pnpm 10.34.5 or newer installation.
|
|
11
12
|
|
|
12
13
|
```sh
|
|
13
14
|
pnpm add --global widefleet
|
|
@@ -18,7 +19,7 @@ If pnpm reports that its global bin directory is missing from PATH, run `pnpm se
|
|
|
18
19
|
|
|
19
20
|
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
21
|
|
|
21
|
-
The CLI includes its native executable, bundler and
|
|
22
|
+
The CLI includes its native executable, bundler and app starters. App
|
|
22
23
|
developers do not need Docker or a checkout of the platform repository when
|
|
23
24
|
connecting to an existing installation.
|
|
24
25
|
|
|
@@ -31,30 +32,44 @@ pnpm install --frozen-lockfile
|
|
|
31
32
|
pnpm dev
|
|
32
33
|
```
|
|
33
34
|
|
|
35
|
+
This creates the default SvelteKit project. For React, see the
|
|
36
|
+
[TanStack Start template and release requirements](https://widefleet.com/docs/reference/cli#create-a-project).
|
|
37
|
+
|
|
38
|
+
Both projects pin pnpm 12.4.2 in `packageManager`. With pnpm's default version
|
|
39
|
+
management, an existing pnpm 10.34.5 or newer installation automatically downloads
|
|
40
|
+
and runs that version when you run a command inside the project.
|
|
41
|
+
pnpm 10.34.5 includes the [version-switching fix](https://github.com/pnpm/pnpm/releases/tag/v10.34.5)
|
|
42
|
+
needed to start pnpm 12 on macOS and Windows.
|
|
43
|
+
|
|
34
44
|
The starter includes a notes app, a D1 database, private R2 file storage and a
|
|
35
45
|
server-side identity helper. Local development uses a synthetic user. Open the
|
|
36
46
|
local URL printed by `pnpm dev`, then stop that server with Ctrl-C before continuing.
|
|
37
47
|
|
|
38
48
|
## Connect and deploy
|
|
39
49
|
|
|
40
|
-
|
|
50
|
+
Connect to your company and deploy with CLI 0.3.2 or newer:
|
|
41
51
|
|
|
42
52
|
```sh
|
|
43
|
-
export PLATFORM_URL=https://platform.example.com
|
|
44
53
|
widefleet login
|
|
45
54
|
pnpm check
|
|
46
55
|
widefleet deploy
|
|
47
56
|
```
|
|
48
57
|
|
|
49
|
-
|
|
50
|
-
|
|
58
|
+
If IT has configured your agent or computer, the CLI uses that platform address.
|
|
59
|
+
Otherwise, it asks for your work email or company domain and looks up the company's
|
|
60
|
+
discovery record. An agent or noninteractive terminal can supply
|
|
61
|
+
`widefleet login --email employee@example.com` or
|
|
62
|
+
`widefleet login --domain example.com`. These commands also work in PowerShell and Fish.
|
|
51
63
|
|
|
52
|
-
Approve the device code in your browser. The CLI stores credentials in your
|
|
64
|
+
Approve the device code in your browser. The CLI remembers the platform URL and stores credentials in your
|
|
53
65
|
operating system's credential store: Keychain on macOS, Credential Manager on
|
|
54
66
|
Windows, and Secret Service on Linux. The store must be available and unlocked.
|
|
55
67
|
|
|
56
|
-
|
|
57
|
-
|
|
68
|
+
Run `widefleet config show` to inspect the selected URL. If discovery is not set
|
|
69
|
+
up, IT can [configure company discovery or distribute configuration](https://widefleet.com/docs/self-hosting/company-setup).
|
|
70
|
+
|
|
71
|
+
For the local demo, run `widefleet login --url http://localhost:25450` and approve
|
|
72
|
+
the code with `admin@example.test`.
|
|
58
73
|
|
|
59
74
|
The target app is identified by your installation and the `name` in
|
|
60
75
|
`wrangler.jsonc`. The first deploy creates it when needed; later deploys update
|
|
@@ -92,7 +107,7 @@ widefleet logs --level error
|
|
|
92
107
|
```
|
|
93
108
|
|
|
94
109
|
Runtime logs require telemetry services enabled by the operator; the local demo
|
|
95
|
-
includes them.
|
|
110
|
+
includes them.
|
|
96
111
|
|
|
97
112
|
## If setup fails
|
|
98
113
|
|
|
@@ -101,6 +116,7 @@ includes them. A failed log query is not evidence that the app has no errors.
|
|
|
101
116
|
| Registry returns 404 | Check the package name and published version on [npm](https://www.npmjs.com/package/widefleet). |
|
|
102
117
|
| `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. |
|
|
103
118
|
| Login cannot access the credential store | Check your operating system's credential store; see [headless login](#headless-login) for alternatives. |
|
|
119
|
+
| 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). |
|
|
104
120
|
| Deployment fails or stays queued | Follow [deployment diagnostics](https://widefleet.com/docs/guides/deployments#inspect-a-failure). |
|
|
105
121
|
|
|
106
122
|
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
|
+
"version": "0.4.0",
|
|
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.
|
|
29
|
-
"widefleet-darwin-arm64": "0.
|
|
30
|
-
"widefleet-darwin-x64": "0.
|
|
31
|
-
"widefleet-win32-x64-msvc": "0.
|
|
29
|
+
"widefleet-linux-x64-gnu": "0.4.0",
|
|
30
|
+
"widefleet-darwin-arm64": "0.4.0",
|
|
31
|
+
"widefleet-darwin-x64": "0.4.0",
|
|
32
|
+
"widefleet-win32-x64-msvc": "0.4.0"
|
|
32
33
|
},
|
|
33
34
|
"repository": {
|
|
34
35
|
"type": "git",
|