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.
Files changed (2) hide show
  1. package/README.md +26 -10
  2. 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. Install Node.js 26 and pnpm 12.4.2 for app development.
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 SvelteKit starter. App
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
- Set your installation's management URL. The following commands use Bash:
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
- In Fish, use `set -gx PLATFORM_URL https://platform.example.com` instead of `export`.
50
- In PowerShell, use `$env:PLATFORM_URL = "https://platform.example.com"`.
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
- For the local demo, use `http://localhost:25450` as `PLATFORM_URL` and approve the
57
- code with `admin@example.test`.
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. A failed log query is not evidence that the app has no errors.
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.2",
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": ">=26"
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.2",
29
- "widefleet-darwin-arm64": "0.3.2",
30
- "widefleet-darwin-x64": "0.3.2",
31
- "widefleet-win32-x64-msvc": "0.3.2"
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",