shipstatic 1.1.2 → 1.1.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 +28 -51
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,87 +1,64 @@
|
|
|
1
1
|
# shipstatic
|
|
2
2
|
|
|
3
|
-
**The package you're looking for is [`@shipstatic/ship`](https://www.npmjs.com/package/@shipstatic/ship)
|
|
3
|
+
> ⚡ **The package you're looking for is [`@shipstatic/ship`](https://www.npmjs.com/package/@shipstatic/ship)** — that's where the code and the full documentation live.
|
|
4
|
+
>
|
|
5
|
+
> This is an alias for it, so a guess at the unscoped name doesn't dead-end. **Use it directly** — `npx shipstatic` runs the same binary, `import Ship from 'shipstatic'` resolves to the same module. Nothing to switch to.
|
|
4
6
|
|
|
5
|
-
|
|
7
|
+
Deploy a static site from the terminal or from code.
|
|
6
8
|
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
## Deploy in seconds — no install, no account
|
|
10
|
-
|
|
11
|
-
Put a static site, landing page, or prototype online:
|
|
9
|
+
## Deploy
|
|
12
10
|
|
|
13
11
|
```bash
|
|
14
12
|
npx shipstatic ./dist
|
|
15
13
|
```
|
|
16
14
|
|
|
17
|
-
|
|
15
|
+
**No account, no API key, no config, no install.** This works in a fresh sandbox with no secrets set.
|
|
18
16
|
|
|
19
|
-
A single file works
|
|
17
|
+
Point it at your **built output** — `./dist`, `./build`, `./out` — not your project root. Build first if the project needs it. A single file works too:
|
|
20
18
|
|
|
21
19
|
```bash
|
|
22
20
|
npx shipstatic ./index.html
|
|
23
21
|
```
|
|
24
22
|
|
|
25
|
-
**What
|
|
26
|
-
|
|
27
|
-
## Password-protect a deployment
|
|
28
|
-
|
|
29
|
-
```bash
|
|
30
|
-
npx shipstatic ./dist --password "correct-horse-battery-staple"
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
Visitors are prompted before the site is served. Works on a single file too:
|
|
23
|
+
**What you get back:** the live URL, plus a **claim URL**.
|
|
34
24
|
|
|
35
|
-
|
|
36
|
-
npx shipstatic ./index.html --password "correct-horse-battery-staple"
|
|
37
|
-
```
|
|
25
|
+
> Anonymous deployments are **public** and **expire in 3 days**. The claim URL is how one becomes permanent — surface it to whoever asked for the deploy.
|
|
38
26
|
|
|
39
|
-
|
|
27
|
+
## Common tasks
|
|
40
28
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
29
|
+
| Goal | Command |
|
|
30
|
+
|---|---|
|
|
31
|
+
| Deploy a folder | `npx shipstatic ./dist` |
|
|
32
|
+
| Deploy one file | `npx shipstatic ./index.html` |
|
|
33
|
+
| Password-protect it | `npx shipstatic ./dist --password "secret"` |
|
|
34
|
+
| Machine-readable output | `npx shipstatic ./dist --json` |
|
|
35
|
+
| Keep the password out of logs | `SHIP_PASSWORD="secret" npx shipstatic ./dist` |
|
|
36
|
+
| Repeat use | `npm install -g shipstatic` → the `ship` command |
|
|
44
37
|
|
|
45
38
|
## For scripts and agents
|
|
46
39
|
|
|
47
|
-
Add `--json` to any command for machine-readable output — on success **and** on failure:
|
|
48
|
-
|
|
49
40
|
```bash
|
|
50
41
|
npx shipstatic ./dist --json
|
|
51
42
|
```
|
|
52
43
|
|
|
53
|
-
-
|
|
54
|
-
- **
|
|
55
|
-
-
|
|
56
|
-
-
|
|
57
|
-
|
|
58
|
-
Deploying anonymously needs no credentials at all — which is what makes `npx shipstatic ./dist` safe to run in a sandbox with no secrets configured. Just remember such deployments are public and expire in 3 days; the claim URL in the output is how they become permanent.
|
|
59
|
-
|
|
60
|
-
## Install (optional, for repeat use)
|
|
61
|
-
|
|
62
|
-
```bash
|
|
63
|
-
npm install -g shipstatic # global CLI — provides the `ship` command
|
|
64
|
-
```
|
|
44
|
+
- **`--json`** emits machine-readable output on success **and** on failure.
|
|
45
|
+
- **Exit code** is `0` on success, non-zero on failure. Branch on it, not on the text.
|
|
46
|
+
- **Errors** carry a stable `error` type and `status`. Branch on those, never on the message string.
|
|
47
|
+
- **`--no-color`** is honoured; colour is off automatically when stdout is not a TTY.
|
|
48
|
+
- **`SHIP_PASSWORD`** supplies `--password` from the environment.
|
|
65
49
|
|
|
66
|
-
|
|
50
|
+
Deploying needs no credentials, so there is nothing to configure before the first run and nothing to leak in a log.
|
|
67
51
|
|
|
68
|
-
##
|
|
52
|
+
## From code
|
|
69
53
|
|
|
70
54
|
```javascript
|
|
71
55
|
import Ship from 'shipstatic';
|
|
72
56
|
|
|
73
|
-
const
|
|
74
|
-
const result = await ship.deploy('./dist');
|
|
57
|
+
const result = await new Ship().deploy('./dist');
|
|
75
58
|
// result.deployment → live URL
|
|
76
59
|
// result.claim → visit to keep permanently
|
|
77
60
|
```
|
|
78
61
|
|
|
79
|
-
##
|
|
80
|
-
|
|
81
|
-
Custom domains, API keys, deploy tokens, deployment management, the full SDK reference — all documented once, in **[`@shipstatic/ship`](https://www.npmjs.com/package/@shipstatic/ship)**.
|
|
82
|
-
|
|
83
|
-
This README covers only the quickstart, deliberately. A copy of another package's documentation is a second copy to keep true — and the day it stops being true, it's worse than none.
|
|
84
|
-
|
|
85
|
-
## License
|
|
62
|
+
## Full documentation
|
|
86
63
|
|
|
87
|
-
|
|
64
|
+
Custom domains, API keys, deploy tokens, managing deployments, the complete SDK reference — **[`@shipstatic/ship`](https://www.npmjs.com/package/@shipstatic/ship)**.
|
package/package.json
CHANGED