@apptile/tile-cli 0.1.0-beta.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 +50 -0
- package/dist/index.js +4469 -0
- package/package.json +41 -0
package/README.md
ADDED
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
# @tile/cli
|
|
2
|
+
|
|
3
|
+
The unified, agent-friendly CLI for Tile apps — source (init/pull/save), Live Layer
|
|
4
|
+
(remote config), native builds, OTA code-push, and integrations.
|
|
5
|
+
|
|
6
|
+
## Install
|
|
7
|
+
|
|
8
|
+
```sh
|
|
9
|
+
npm i -g @tile/cli
|
|
10
|
+
tile login # authenticate against the Tile gateway
|
|
11
|
+
tile app list # confirm you're connected
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
## Local vs prod (one knob)
|
|
15
|
+
|
|
16
|
+
The CLI talks to the Tile gateway over HTTP. It defaults to the hosted gateway, so a
|
|
17
|
+
published install works out of the box. Point it anywhere with a single env var:
|
|
18
|
+
|
|
19
|
+
```sh
|
|
20
|
+
export TILE_API_URL=https://demo-setup.tile.dev # default (hosted) — no need to set
|
|
21
|
+
export TILE_API_URL=http://localhost:8080 # local dev stack
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
For **local development**, use the `tile-dev` wrapper installed by `tile-dev-setup` — it
|
|
25
|
+
runs this same CLI from source and defaults `TILE_API_URL` to your local gateway, so it
|
|
26
|
+
never collides with a globally-installed prod `tile`.
|
|
27
|
+
|
|
28
|
+
## Where state lives
|
|
29
|
+
|
|
30
|
+
- `~/.config/tile/credentials.json` — session token (written `0600`, never logged).
|
|
31
|
+
- `~/.config/tile/config.json` — the selected app (`tile use`).
|
|
32
|
+
- `~/.config/tile/projects.json` — machine-local `appId → repo path` index, so
|
|
33
|
+
`tile save --app <id>` and friends work from anywhere. See `tile projects`,
|
|
34
|
+
`tile path <id>`, `tile unlink <id>`.
|
|
35
|
+
- `tile.json` (in each repo) — the committed identity ("what app is this folder?").
|
|
36
|
+
|
|
37
|
+
## Common commands
|
|
38
|
+
|
|
39
|
+
```sh
|
|
40
|
+
tile init --name "My App" # create a Tile app + scaffold it locally
|
|
41
|
+
tile pull # fetch an app's files into the cwd
|
|
42
|
+
tile save # store the local files as a new version
|
|
43
|
+
tile projects # every app linked to a local repo on this machine
|
|
44
|
+
tile live-layer set k=v # remote config / feature flags
|
|
45
|
+
tile build create --platform android
|
|
46
|
+
tile ota deploy # ship a JS-only update
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
Run `tile guide` for the full lifecycle, `tile <command> --help` for details, and add
|
|
50
|
+
`--json` to any command for machine-readable output.
|