shopify-cli 1.5.0 → 1.6.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/.github/PULL_REQUEST_TEMPLATE.md +1 -0
- data/.travis.yml +1 -0
- data/CHANGELOG.md +9 -0
- data/README.md +39 -7
- data/Rakefile +2 -0
- data/dev.yml +2 -2
- data/docs/_config.yml +1 -18
- data/docs/app/node/commands/index.md +2 -80
- data/docs/app/node/index.md +2 -33
- data/docs/app/rails/commands/index.md +2 -78
- data/docs/app/rails/index.md +2 -34
- data/docs/core/index.md +2 -84
- data/docs/getting-started/index.md +2 -25
- data/docs/getting-started/install/index.md +1 -118
- data/docs/getting-started/migrate/index.md +2 -94
- data/docs/getting-started/uninstall/index.md +2 -35
- data/docs/getting-started/upgrade/index.md +2 -39
- data/docs/help/start-app/index.md +2 -4
- data/docs/index.md +2 -24
- data/install.sh +1 -1
- data/lib/project_types/extension/cli.rb +19 -10
- data/lib/project_types/extension/commands/extension_command.rb +2 -2
- data/lib/project_types/extension/features/argo.rb +117 -0
- data/lib/project_types/extension/forms/create.rb +2 -2
- data/lib/project_types/extension/models/specification.rb +35 -0
- data/lib/project_types/extension/models/specification_handlers/checkout_post_purchase.rb +19 -0
- data/lib/project_types/extension/models/specification_handlers/default.rb +67 -0
- data/lib/project_types/extension/models/specifications.rb +77 -0
- data/lib/project_types/extension/tasks/configure_features.rb +52 -0
- data/lib/project_types/extension/tasks/fetch_specifications.rb +38 -0
- data/lib/project_types/node/commands/create.rb +3 -1
- data/lib/project_types/node/commands/generate.rb +2 -11
- data/lib/project_types/node/messages/messages.rb +9 -44
- data/lib/project_types/rails/commands/create.rb +8 -9
- data/lib/project_types/rails/forms/create.rb +1 -1
- data/lib/project_types/rails/gem.rb +1 -1
- data/lib/project_types/rails/messages/messages.rb +1 -1
- data/lib/project_types/script/cli.rb +7 -4
- data/lib/project_types/script/commands/create.rb +6 -4
- data/lib/project_types/script/commands/push.rb +5 -13
- data/lib/project_types/script/config/extension_points.yml +9 -5
- data/lib/project_types/script/errors.rb +17 -0
- data/lib/project_types/script/forms/create.rb +26 -2
- data/lib/project_types/script/graphql/app_script_update_or_create.graphql +10 -1
- data/lib/project_types/script/layers/application/build_script.rb +9 -4
- data/lib/project_types/script/layers/application/create_script.rb +12 -10
- data/lib/project_types/script/layers/application/extension_points.rb +24 -0
- data/lib/project_types/script/layers/application/push_script.rb +18 -16
- data/lib/project_types/script/layers/domain/errors.rb +4 -0
- data/lib/project_types/script/layers/domain/extension_point.rb +62 -6
- data/lib/project_types/script/layers/domain/metadata.rb +55 -0
- data/lib/project_types/script/layers/domain/push_package.rb +25 -6
- data/lib/project_types/script/layers/infrastructure/assemblyscript_project_creator.rb +6 -6
- data/lib/project_types/script/layers/infrastructure/assemblyscript_task_runner.rb +16 -6
- data/lib/project_types/script/layers/infrastructure/extension_point_repository.rb +10 -4
- data/lib/project_types/script/layers/infrastructure/project_creator.rb +2 -1
- data/lib/project_types/script/layers/infrastructure/push_package_repository.rb +25 -13
- data/lib/project_types/script/layers/infrastructure/rust_project_creator.rb +72 -0
- data/lib/project_types/script/layers/infrastructure/rust_task_runner.rb +59 -0
- data/lib/project_types/script/layers/infrastructure/script_service.rb +7 -1
- data/lib/project_types/script/layers/infrastructure/task_runner.rb +4 -3
- data/lib/project_types/script/messages/messages.rb +39 -8
- data/lib/project_types/script/script_project.rb +25 -16
- data/lib/project_types/script/ui/error_handler.rb +34 -1
- data/lib/project_types/theme/cli.rb +40 -0
- data/lib/project_types/theme/commands/connect.rb +54 -0
- data/lib/project_types/theme/commands/create.rb +48 -0
- data/lib/project_types/theme/commands/deploy.rb +38 -0
- data/lib/project_types/theme/commands/generate.rb +20 -0
- data/lib/project_types/theme/commands/generate/env.rb +79 -0
- data/lib/project_types/theme/commands/push.rb +55 -0
- data/lib/project_types/theme/commands/serve.rb +31 -0
- data/lib/project_types/theme/forms/connect.rb +34 -0
- data/lib/project_types/theme/forms/create.rb +22 -0
- data/lib/project_types/theme/messages/messages.rb +147 -0
- data/lib/project_types/theme/tasks/ensure_themekit_installed.rb +78 -0
- data/lib/project_types/theme/themekit.rb +113 -0
- data/lib/shopify-cli/admin_api.rb +42 -2
- data/lib/shopify-cli/api.rb +27 -24
- data/lib/shopify-cli/commands/system.rb +1 -1
- data/lib/shopify-cli/context.rb +23 -2
- data/lib/shopify-cli/feature.rb +0 -2
- data/lib/shopify-cli/http_request.rb +20 -8
- data/lib/shopify-cli/messages/messages.rb +6 -3
- data/lib/shopify-cli/method_object.rb +104 -0
- data/lib/shopify-cli/partners_api.rb +8 -2
- data/lib/shopify-cli/project_type.rb +1 -1
- data/lib/shopify-cli/resolve_constant.rb +25 -0
- data/lib/shopify-cli/result.rb +432 -0
- data/lib/shopify-cli/shopifolk.rb +3 -2
- data/lib/shopify-cli/tasks/select_org_and_shop.rb +6 -5
- data/lib/shopify-cli/tunnel.rb +7 -1
- data/lib/shopify-cli/version.rb +1 -1
- data/lib/shopify_cli.rb +4 -1
- data/shopify.fish +1 -1
- data/shopify.sh +1 -1
- data/vendor/deps/cli-kit/REVISION +1 -1
- data/vendor/deps/cli-kit/lib/cli/kit/logger.rb +2 -2
- data/vendor/deps/cli-kit/lib/cli/kit/system.rb +3 -3
- data/vendor/deps/cli-ui/REVISION +1 -1
- data/vendor/deps/cli-ui/lib/cli/ui.rb +26 -22
- data/vendor/deps/cli-ui/lib/cli/ui/ansi.rb +4 -6
- data/vendor/deps/cli-ui/lib/cli/ui/frame.rb +3 -3
- data/vendor/deps/cli-ui/lib/cli/ui/frame/frame_stack.rb +8 -9
- data/vendor/deps/cli-ui/lib/cli/ui/frame/frame_style.rb +1 -1
- data/vendor/deps/cli-ui/lib/cli/ui/glyph.rb +1 -0
- data/vendor/deps/cli-ui/lib/cli/ui/printer.rb +15 -3
- data/vendor/deps/cli-ui/lib/cli/ui/prompt/interactive_options.rb +4 -11
- data/vendor/deps/cli-ui/lib/cli/ui/spinner.rb +3 -5
- data/vendor/deps/cli-ui/lib/cli/ui/terminal.rb +10 -10
- data/vendor/deps/cli-ui/lib/cli/ui/version.rb +1 -1
- data/vendor/deps/cli-ui/lib/cli/ui/wrap.rb +56 -0
- data/vendor/deps/webrick/.gitignore +9 -0
- data/vendor/deps/webrick/Gemfile +3 -0
- data/vendor/deps/webrick/LICENSE.txt +22 -0
- data/vendor/deps/webrick/README.md +61 -0
- data/vendor/deps/webrick/Rakefile +10 -0
- data/vendor/deps/webrick/lib/webrick.rb +232 -0
- data/vendor/deps/webrick/lib/webrick/accesslog.rb +157 -0
- data/vendor/deps/webrick/lib/webrick/cgi.rb +313 -0
- data/vendor/deps/webrick/lib/webrick/compat.rb +36 -0
- data/vendor/deps/webrick/lib/webrick/config.rb +158 -0
- data/vendor/deps/webrick/lib/webrick/cookie.rb +172 -0
- data/vendor/deps/webrick/lib/webrick/htmlutils.rb +30 -0
- data/vendor/deps/webrick/lib/webrick/httpauth.rb +96 -0
- data/vendor/deps/webrick/lib/webrick/httpauth/authenticator.rb +117 -0
- data/vendor/deps/webrick/lib/webrick/httpauth/basicauth.rb +116 -0
- data/vendor/deps/webrick/lib/webrick/httpauth/digestauth.rb +395 -0
- data/vendor/deps/webrick/lib/webrick/httpauth/htdigest.rb +132 -0
- data/vendor/deps/webrick/lib/webrick/httpauth/htgroup.rb +97 -0
- data/vendor/deps/webrick/lib/webrick/httpauth/htpasswd.rb +158 -0
- data/vendor/deps/webrick/lib/webrick/httpauth/userdb.rb +53 -0
- data/vendor/deps/webrick/lib/webrick/httpproxy.rb +354 -0
- data/vendor/deps/webrick/lib/webrick/httprequest.rb +636 -0
- data/vendor/deps/webrick/lib/webrick/httpresponse.rb +564 -0
- data/vendor/deps/webrick/lib/webrick/https.rb +152 -0
- data/vendor/deps/webrick/lib/webrick/httpserver.rb +294 -0
- data/vendor/deps/webrick/lib/webrick/httpservlet.rb +23 -0
- data/vendor/deps/webrick/lib/webrick/httpservlet/abstract.rb +152 -0
- data/vendor/deps/webrick/lib/webrick/httpservlet/cgi_runner.rb +47 -0
- data/vendor/deps/webrick/lib/webrick/httpservlet/cgihandler.rb +126 -0
- data/vendor/deps/webrick/lib/webrick/httpservlet/erbhandler.rb +88 -0
- data/vendor/deps/webrick/lib/webrick/httpservlet/filehandler.rb +552 -0
- data/vendor/deps/webrick/lib/webrick/httpservlet/prochandler.rb +47 -0
- data/vendor/deps/webrick/lib/webrick/httpstatus.rb +194 -0
- data/vendor/deps/webrick/lib/webrick/httputils.rb +512 -0
- data/vendor/deps/webrick/lib/webrick/httpversion.rb +76 -0
- data/vendor/deps/webrick/lib/webrick/log.rb +156 -0
- data/vendor/deps/webrick/lib/webrick/server.rb +381 -0
- data/vendor/deps/webrick/lib/webrick/ssl.rb +215 -0
- data/vendor/deps/webrick/lib/webrick/utils.rb +265 -0
- data/vendor/deps/webrick/lib/webrick/version.rb +18 -0
- data/vendor/deps/webrick/webrick.gemspec +74 -0
- metadata +70 -26
- data/docs/Gemfile +0 -5
- data/docs/Gemfile.lock +0 -258
- data/docs/_data/nav.yml +0 -35
- data/docs/_includes/footer.html +0 -15
- data/docs/_includes/head.html +0 -19
- data/docs/_includes/sidebar_nav.html +0 -22
- data/docs/_includes/toc.html +0 -112
- data/docs/_layouts/default.html +0 -79
- data/docs/css/docs.css +0 -157
- data/docs/images/header.png +0 -0
- data/docs/installing-ruby.md +0 -28
- data/lib/project_types/extension/features/argo/admin.rb +0 -20
- data/lib/project_types/extension/features/argo/base.rb +0 -129
- data/lib/project_types/extension/features/argo/checkout.rb +0 -20
- data/lib/project_types/extension/models/type.rb +0 -81
- data/lib/project_types/extension/models/types/checkout_post_purchase.rb +0 -23
- data/lib/project_types/extension/models/types/product_subscription.rb +0 -24
- data/lib/project_types/node/commands/generate/billing.rb +0 -39
- data/lib/project_types/node/commands/generate/page.rb +0 -59
- data/lib/project_types/node/commands/generate/webhook.rb +0 -37
- data/lib/project_types/script/layers/domain/script.rb +0 -18
- data/lib/project_types/script/layers/infrastructure/script_repository.rb +0 -47
- data/lib/project_types/script/templates/ts/as-pect.config.js +0 -27
- data/lib/project_types/script/templates/ts/as-pect.d.ts +0 -1
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 51b21780f8f46054f92124110152a903c94a6215436b73b5dce40c8ad7b072cc
|
4
|
+
data.tar.gz: 2884ba67316188cd05ae6b8cd3e7927a7dc8d99936fd328eed6a2480452eec4b
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 8e1f3f1911ab79b7dc725236249219a0f5aff3703ed82f243cf2235621e1e45aef7c77e2fd06c2360a436c7601d344e4e01f0795eff53d519a2a992079825847
|
7
|
+
data.tar.gz: cc1c2de1b2bc5f624c0e249d4b7b8f0a58bd72ab164e02914b9ace0d6d542bbc6aa8d3a67387ce45060aa5fcc44ef5aed5fc4bed2ce8a67bb53bd7d65c03f608
|
@@ -28,3 +28,4 @@ Fixes #0000 <!-- link to issue if one exists -->
|
|
28
28
|
and then making the CHANGELOG update once you know the PR number.
|
29
29
|
-->
|
30
30
|
- [ ] I've added a CHANGELOG entry for this PR (if the change is public-facing)
|
31
|
+
- [ ] I've considered possible cross-platform impacts (Mac, Linux, Windows).
|
data/.travis.yml
CHANGED
data/CHANGELOG.md
CHANGED
@@ -1,10 +1,19 @@
|
|
1
1
|
Unreleased
|
2
2
|
------
|
3
3
|
|
4
|
+
Version 1.6.0
|
5
|
+
-----
|
6
|
+
* [#1049](https://github.com/Shopify/shopify-app-cli/pull/1049): Add schema versioning support to the script project type
|
7
|
+
* [#1059](https://github.com/Shopify/shopify-app-cli/pull/1059): Remove the functionality of the `generate` command for node apps, since it will no longer be feasible with the new node library
|
8
|
+
* [#1046](https://github.com/Shopify/shopify-app-cli/pull/1046): Include a vendored copy of Webrick, as it's no longer included in Ruby 3.
|
9
|
+
* [#1041](https://github.com/Shopify/shopify-app-cli/pull/1041): Remove unnecessary shell call to `spring stop`. We already pass `--skip-spring` when creating the app so running `spring stop` would have no effect.
|
10
|
+
* [#1034](https://github.com/Shopify/shopify-app-cli/pull/1034): Abort if a system call fails.
|
11
|
+
|
4
12
|
Version 1.5.0
|
5
13
|
-----
|
6
14
|
* [#965](https://github.com/Shopify/shopify-app-cli/pull/965): Remove --no-optional when using npm to create new project
|
7
15
|
* [#958](https://github.com/Shopify/shopify-app-cli/pull/958): Split `connect` command into project-specific functionality
|
16
|
+
* [#992](https://github.com/Shopify/shopify-app-cli/pull/992): Add Theme Kit functionality to CLI
|
8
17
|
|
9
18
|
Version 1.4.1
|
10
19
|
------
|
data/README.md
CHANGED
@@ -1,13 +1,45 @@
|
|
1
|
-
# Shopify App CLI
|
1
|
+
# [Shopify App CLI](https://shopify.dev/tools/cli)
|
2
2
|
|
3
3
|
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE.md)[![Build Status](https://travis-ci.com/Shopify/shopify-app-cli.svg?token=qtPazgjyosjEEgxgq7VZ&branch=master)](https://travis-ci.com/Shopify/shopify-app-cli)
|
4
4
|
|
5
|
-
Shopify App CLI helps you build Shopify apps faster. It
|
5
|
+
Shopify App CLI helps you build Shopify apps faster. It quickly generates Node.js and Ruby on Rails apps and automates many common development tasks.
|
6
6
|
|
7
|
-
##
|
8
|
-
Consult the [Shopify App CLI documentation](https://shopify.github.io/shopify-app-cli) to get started.
|
7
|
+
## Features
|
9
8
|
|
10
|
-
|
11
|
-
This is an [open-source](https://github.com/Shopify/shopify-app-cli/blob/master/.github/LICENSE.md) tool and developers are [invited to contribute](https://github.com/Shopify/shopify-app-cli/blob/master/.github/CONTRIBUTING.md) to it. Please check the [code of conduct](https://github.com/Shopify/shopify-app-cli/blob/master/.github/CODE_OF_CONDUCT.md) before you begin.
|
9
|
+
Shopify App CLI helps your app development process in the following ways:
|
12
10
|
|
13
|
-
|
11
|
+
- Creates an app in the [Partner dashboard](https://partners.shopify.com/current/resources)
|
12
|
+
- Populates test data for your app, including products, customers, and draft orders
|
13
|
+
- Generates new [webhooks](https://shopify.dev/tutorials/manage-webhooks) for your app
|
14
|
+
- Deploys your app to an external platform, such as [Heroku](https://www.heroku.com/)
|
15
|
+
|
16
|
+
## Installation
|
17
|
+
|
18
|
+
Refer to [*Install Shopify App CLI*](https://shopify.dev/tools/cli/installation) to learn how to install Shopify App CLI on Windows, macOS, or Linux.
|
19
|
+
|
20
|
+
## Getting started
|
21
|
+
|
22
|
+
Refer to [*Getting started with Shopify App CLI*](https://shopify.dev/tools/cli/getting-started) to learn how to create and manage different types of projects with Shopify App CLI.
|
23
|
+
|
24
|
+
## References
|
25
|
+
|
26
|
+
- **[Shopify App CLI core commands](https://shopify.dev/tools/cli/reference)** - A complete reference of core commands for Shopify App CLI.
|
27
|
+
- **[Node.js app commands](https://shopify.dev/tools/cli/reference/node-app)** - A complete Shopify App CLI command reference for Node.js apps.
|
28
|
+
- **[Ruby on Rails app commands](https://shopify.dev/tools/cli/reference/ruby-on-rails-app)** - A complete Shopify App CLI command reference for Ruby on Rails apps.
|
29
|
+
|
30
|
+
## Troubleshooting
|
31
|
+
|
32
|
+
Refer to [*Troubleshooting Shopify App CLI*](https://shopify.dev/tools/cli/troubleshooting) to learn how to upgrade, migrate from a legacy version, and uninstall Shopify App CLI.
|
33
|
+
|
34
|
+
## Contributing to Shopify App CLI
|
35
|
+
|
36
|
+
Shopify App CLI is an [open source](https://github.com/Shopify/shopify-app-cli/blob/master/.github/LICENSE.md) tool and you can [help contribute to the GitHub repository](https://github.com/Shopify/shopify-app-cli/blob/master/.github/CONTRIBUTING.md).
|
37
|
+
|
38
|
+
## Developing Shopify App CLI
|
39
|
+
|
40
|
+
Read the [development guide](https://github.com/Shopify/shopify-app-cli/wiki).
|
41
|
+
|
42
|
+
## Where to get help
|
43
|
+
|
44
|
+
- **[Open a GitHub issue](https://github.com/Shopify/shopify-app-cli/issues)** - To report bugs or request new features, open an issue in the Shopify App CLI repository.
|
45
|
+
- **[Shopify Community Forums](https://community.shopify.com/)** - Visit our forums to connect with the community and learn more about Shopify App CLI development.
|
data/Rakefile
CHANGED
@@ -29,9 +29,11 @@ namespace :rdoc do
|
|
29
29
|
'lib/shopify-cli/git.rb',
|
30
30
|
'lib/shopify-cli/heroku.rb',
|
31
31
|
'lib/shopify-cli/js_deps.rb',
|
32
|
+
'lib/shopify-cli/method_object.rb',
|
32
33
|
'lib/shopify-cli/partners_api.rb',
|
33
34
|
'lib/shopify-cli/process_supervision.rb',
|
34
35
|
'lib/shopify-cli/project.rb',
|
36
|
+
'lib/shopify-cli/result.rb',
|
35
37
|
'lib/shopify-cli/tunnel.rb',
|
36
38
|
]
|
37
39
|
|
data/dev.yml
CHANGED
data/docs/_config.yml
CHANGED
@@ -1,19 +1,2 @@
|
|
1
|
-
title: Shopify App CLI
|
2
|
-
markdown: kramdown
|
3
|
-
url: https://shopify.github.io
|
4
|
-
baseurl: /shopify-app-cli
|
5
|
-
|
6
|
-
exclude: [
|
7
|
-
'heroku/',
|
8
|
-
'Gemfile',
|
9
|
-
'Gemfile.lock'
|
10
|
-
]
|
11
|
-
|
12
|
-
defaults:
|
13
|
-
- scope:
|
14
|
-
path: ""
|
15
|
-
values:
|
16
|
-
toc: true
|
17
|
-
|
18
1
|
plugins:
|
19
|
-
- jekyll-redirect-from
|
2
|
+
- jekyll-redirect-from
|
@@ -1,82 +1,4 @@
|
|
1
1
|
---
|
2
|
-
title: Node.js app
|
3
|
-
|
2
|
+
title: Node.js app commands
|
3
|
+
redirect_to: https://shopify.dev/tools/cli/reference/node-app
|
4
4
|
---
|
5
|
-
|
6
|
-
## `deploy`
|
7
|
-
|
8
|
-
Deploy the current Node.js app to a hosting service. Currently, the only option is [Heroku](https://www.heroku.com).
|
9
|
-
|
10
|
-
```console
|
11
|
-
$ shopify deploy heroku
|
12
|
-
```
|
13
|
-
|
14
|
-
## `generate`
|
15
|
-
|
16
|
-
Generate boilerplate code inside your app project. Node.js apps support generating new **pages**, **Billing API calls**, and **webhooks**.
|
17
|
-
|
18
|
-
```console
|
19
|
-
$ shopify generate page
|
20
|
-
$ shopify generate billing
|
21
|
-
$ shopify generate webhook
|
22
|
-
```
|
23
|
-
|
24
|
-
## `open`
|
25
|
-
|
26
|
-
Open your local development app in your default browser.
|
27
|
-
|
28
|
-
```console
|
29
|
-
$ shopify open
|
30
|
-
```
|
31
|
-
|
32
|
-
## `populate`
|
33
|
-
|
34
|
-
Add example data to your development store. This is useful for testing your app’s behavior. You can create the following types of example store records:
|
35
|
-
|
36
|
-
- Products
|
37
|
-
- Customers
|
38
|
-
- Orders
|
39
|
-
|
40
|
-
```console
|
41
|
-
$ shopify populate products
|
42
|
-
$ shopify populate customers
|
43
|
-
$ shopify populate draftorders
|
44
|
-
```
|
45
|
-
|
46
|
-
By default, the `populate` command adds 5 records. Use the `--count` option to specify a different number:
|
47
|
-
|
48
|
-
```console
|
49
|
-
$ shopify populate products --count 10
|
50
|
-
```
|
51
|
-
|
52
|
-
## `serve`
|
53
|
-
|
54
|
-
Start a local development server for your project, as well as a public [ngrok](https://ngrok.com/) tunnel to your localhost.
|
55
|
-
|
56
|
-
```console
|
57
|
-
$ shopify serve
|
58
|
-
```
|
59
|
-
|
60
|
-
## `tunnel`
|
61
|
-
|
62
|
-
Control an HTTP tunnel to your local development app using [ngrok](https://ngrok.com). With the `tunnel` command you can authenticate with ngrok and start or stop the tunnel. (Note that the `serve` command will automatically run `tunnel start` for you.)
|
63
|
-
|
64
|
-
To authenticate with ngrok, you need an authentication token. You can find it in [your ngrok dashboard](https://dashboard.ngrok.com/auth/your-authtoken). Copy your token and use it with the `tunnel auth` command:
|
65
|
-
|
66
|
-
```console
|
67
|
-
$ shopify tunnel auth <token>
|
68
|
-
```
|
69
|
-
|
70
|
-
This will write your ngrok auth token to `~/.ngrok2/ngrok.yml`. To learn more about ngrok configuration, [consult ngrok’s documentation](https://ngrok.com/docs#config).
|
71
|
-
|
72
|
-
To start an ngrok tunnel to your app in your localhost development environment:
|
73
|
-
|
74
|
-
```console
|
75
|
-
$ shopify tunnel start
|
76
|
-
```
|
77
|
-
|
78
|
-
To stop the running ngrok tunnel:
|
79
|
-
|
80
|
-
```console
|
81
|
-
$ shopify tunnel stop
|
82
|
-
```
|
data/docs/app/node/index.md
CHANGED
@@ -1,35 +1,4 @@
|
|
1
1
|
---
|
2
|
-
title: Getting started with
|
3
|
-
|
4
|
-
toc: false
|
2
|
+
title: Getting started with Shopify App CLI
|
3
|
+
redirect_to: https://shopify.dev/tools/cli/getting-started
|
5
4
|
---
|
6
|
-
|
7
|
-
## Create a new Node.js app project
|
8
|
-
|
9
|
-
To create a new Node.js project, type `shopify create node`. This will scaffold a new Node.js app in a subdirectory.
|
10
|
-
|
11
|
-
```console
|
12
|
-
$ shopify create node
|
13
|
-
? App Name
|
14
|
-
>
|
15
|
-
```
|
16
|
-
|
17
|
-
## Start a local development server
|
18
|
-
|
19
|
-
Once your app is created, you can work with it immediately by running `shopify serve` to start a local development server. Shopify App CLI uses [ngrok](https://ngrok.com) to create a tunnel. ngrok will choose a unique URL for you. The server will stay open until you type **Ctrl-C**.
|
20
|
-
|
21
|
-
```console
|
22
|
-
$ shopify serve
|
23
|
-
✓ ngrok tunnel running at https://example.ngrok.io
|
24
|
-
✓ writing .env file...
|
25
|
-
```
|
26
|
-
|
27
|
-
## Install your app on your development store
|
28
|
-
|
29
|
-
With the server running, open a new terminal window and run `shopify open` to open your app in your browser and install it on a development store.
|
30
|
-
|
31
|
-
```console
|
32
|
-
$ shopify open
|
33
|
-
```
|
34
|
-
|
35
|
-
For more information, consult the [Node.js project command reference]({{ site.baseurl }}{% link app/node/commands/index.md %}).
|
@@ -1,80 +1,4 @@
|
|
1
1
|
---
|
2
|
-
title: Rails app
|
3
|
-
|
2
|
+
title: Ruby on Rails app commands
|
3
|
+
redirect_to: https://shopify.dev/tools/cli/reference/ruby-on-rails-app
|
4
4
|
---
|
5
|
-
|
6
|
-
## `deploy`
|
7
|
-
|
8
|
-
Deploy the current Rails project to a hosting service. Currently, the only option is [Heroku](https://www.heroku.com).
|
9
|
-
|
10
|
-
```console
|
11
|
-
$ shopify deploy heroku
|
12
|
-
```
|
13
|
-
|
14
|
-
## `generate`
|
15
|
-
|
16
|
-
Generate boilerplate code inside your app project. Rails projects support generating new webhooks.
|
17
|
-
|
18
|
-
```console
|
19
|
-
$ shopify generate webhook
|
20
|
-
```
|
21
|
-
|
22
|
-
## `open`
|
23
|
-
|
24
|
-
Open your local development app in your default browser.
|
25
|
-
|
26
|
-
```console
|
27
|
-
$ shopify open
|
28
|
-
```
|
29
|
-
|
30
|
-
## `populate`
|
31
|
-
|
32
|
-
Add example data to your development store. This is useful for testing your app’s behavior. You can create the following types of example store records:
|
33
|
-
|
34
|
-
- Products
|
35
|
-
- Customers
|
36
|
-
- Orders
|
37
|
-
|
38
|
-
```console
|
39
|
-
$ shopify populate products
|
40
|
-
$ shopify populate customers
|
41
|
-
$ shopify populate draftorders
|
42
|
-
```
|
43
|
-
|
44
|
-
By default, the `populate` command adds 5 records. Use the `--count` option to specify a different number:
|
45
|
-
|
46
|
-
```console
|
47
|
-
$ shopify populate products --count 10
|
48
|
-
```
|
49
|
-
|
50
|
-
## `serve`
|
51
|
-
|
52
|
-
Start a local development server for your project, as well as a public [ngrok](https://ngrok.com/) tunnel to your localhost.
|
53
|
-
|
54
|
-
```console
|
55
|
-
$ shopify serve
|
56
|
-
```
|
57
|
-
|
58
|
-
## `tunnel`
|
59
|
-
|
60
|
-
Control an HTTP tunnel to your local development app using [ngrok](https://ngrok.com). With the `tunnel` command you can authenticate with ngrok and start or stop the tunnel. (Note that the `serve` command will automatically run `tunnel start` for you.)
|
61
|
-
|
62
|
-
To authenticate with ngrok, you need an authentication token. You can find it in [your ngrok dashboard](https://dashboard.ngrok.com/auth/your-authtoken). Copy your token and use it with the `tunnel auth` command:
|
63
|
-
|
64
|
-
```console
|
65
|
-
$ shopify tunnel auth <token>
|
66
|
-
```
|
67
|
-
|
68
|
-
This will write your ngrok auth token to `~/.ngrok2/ngrok.yml`. To learn more about ngrok configuration, [consult ngrok’s documentation](https://ngrok.com/docs#config).
|
69
|
-
|
70
|
-
To start an ngrok tunnel to your app in your localhost development environment:
|
71
|
-
|
72
|
-
```console
|
73
|
-
$ shopify tunnel start
|
74
|
-
```
|
75
|
-
|
76
|
-
To stop the running ngrok tunnel:
|
77
|
-
|
78
|
-
```console
|
79
|
-
$ shopify tunnel stop
|
80
|
-
```
|
data/docs/app/rails/index.md
CHANGED
@@ -1,36 +1,4 @@
|
|
1
1
|
---
|
2
|
-
title: Getting started with
|
3
|
-
|
4
|
-
toc: false
|
2
|
+
title: Getting started with Shopify App CLI
|
3
|
+
redirect_to: https://shopify.dev/tools/cli/getting-started
|
5
4
|
---
|
6
|
-
|
7
|
-
## Create a new Rails app project
|
8
|
-
|
9
|
-
To create a new Rails project, type `shopify create rails`. This will scaffold a new Rails app in a subdirectory.
|
10
|
-
|
11
|
-
```console
|
12
|
-
$ shopify create rails
|
13
|
-
? App Name
|
14
|
-
>
|
15
|
-
```
|
16
|
-
|
17
|
-
## Start a local development server
|
18
|
-
|
19
|
-
Once your app is created, you can work with it immediately by running `shopify serve` to start a local development server. Shopify App CLI uses [ngrok](https://ngrok.com) to create a tunnel. ngrok will choose a unique URL for you. The server will stay open until you type **Ctrl-C**.
|
20
|
-
|
21
|
-
```console
|
22
|
-
$ shopify serve
|
23
|
-
✓ ngrok tunnel running at https://example.ngrok.io
|
24
|
-
✓ writing .env file...
|
25
|
-
```
|
26
|
-
|
27
|
-
## Install your app on your development store
|
28
|
-
|
29
|
-
With the server running, open a new terminal window and run `shopify open` to open your app in your browser and install it on a development store.
|
30
|
-
|
31
|
-
```console
|
32
|
-
$ shopify open
|
33
|
-
```
|
34
|
-
|
35
|
-
For more information, consult the [Rails project command reference]({{ site.baseurl }}{% link app/rails/commands/index.md %}).
|
36
|
-
|
data/docs/core/index.md
CHANGED
@@ -1,86 +1,4 @@
|
|
1
1
|
---
|
2
|
-
title:
|
3
|
-
|
2
|
+
title: Shopify App CLI core commands
|
3
|
+
redirect_to: https://shopify.dev/tools/cli/reference
|
4
4
|
---
|
5
|
-
|
6
|
-
## `help`
|
7
|
-
|
8
|
-
Lists the available commands and describes what they do. The commands available will vary depending on whether you are inside a project directory, and what kind of project it is.
|
9
|
-
|
10
|
-
```console
|
11
|
-
$ shopify help
|
12
|
-
$ shopify -h
|
13
|
-
$ shopify --help
|
14
|
-
```
|
15
|
-
|
16
|
-
You can also use the `help` command or options to get more detailed information about a specific command:
|
17
|
-
|
18
|
-
```console
|
19
|
-
$ shopify help [command]
|
20
|
-
$ shopify [command] -h
|
21
|
-
$ shopify [command] --help
|
22
|
-
```
|
23
|
-
|
24
|
-
## `connect`
|
25
|
-
|
26
|
-
Connect an existing Shopify App CLI project with Shopify, such as a Partner account or a specific Shopify development store. This command re-creates the project’s `.env` file with your authentication tokens.
|
27
|
-
|
28
|
-
This is useful if you are working on one project across multiple computers, or collaborating with other developers using a version control system like git.
|
29
|
-
|
30
|
-
```console
|
31
|
-
$ shopify connect
|
32
|
-
```
|
33
|
-
|
34
|
-
## `create`
|
35
|
-
|
36
|
-
Create a new project of the specified type. The project will be created in a subdirectory of the current directory:
|
37
|
-
|
38
|
-
```console
|
39
|
-
$ shopify create
|
40
|
-
```
|
41
|
-
|
42
|
-
When running the `create` command on its own, the CLI will prompt you to choose a project type:
|
43
|
-
|
44
|
-
```console
|
45
|
-
$ shopify create
|
46
|
-
? What type of project would you like to create? (Choose with ↑ ↓ ⏎, filter with 'f')
|
47
|
-
> 1. Node.js App
|
48
|
-
2. Ruby on Rails App
|
49
|
-
```
|
50
|
-
|
51
|
-
You can also specify the type of app you want to create using a subcommand:
|
52
|
-
- For a Node.js app: `node`
|
53
|
-
- For a Ruby on Rails app: `rails`
|
54
|
-
|
55
|
-
If you specify a type, then Shopify App CLI will skip ahead and prompt you to enter a name for your project:
|
56
|
-
|
57
|
-
```console
|
58
|
-
$ shopify create node
|
59
|
-
? App Name
|
60
|
-
>
|
61
|
-
```
|
62
|
-
|
63
|
-
## `logout`
|
64
|
-
|
65
|
-
Log out of the currently authenticated partner organization and store. The `logout` command clears any invalid credentials. You’ll need to re-authenticate the next time you connect your project to Shopify.
|
66
|
-
|
67
|
-
```console
|
68
|
-
$ shopify logout
|
69
|
-
```
|
70
|
-
|
71
|
-
## `config`
|
72
|
-
|
73
|
-
Configure Shopify App CLI options. Currently there are two available options.
|
74
|
-
|
75
|
-
### `analytics`
|
76
|
-
|
77
|
-
Configure anonymous usage reporting by enabling or disabling analytics
|
78
|
-
```console
|
79
|
-
$ shopify config analytics [ --status | --enable | --disable ]
|
80
|
-
```
|
81
|
-
|
82
|
-
### `feature`
|
83
|
-
Configure active [feature sets](https://github.com/Shopify/shopify-app-cli/wiki/Feature-Sets) in the CLI. This command is used for development and debugging work on the CLI tool itself. Only alter it if you know what you're doing. Check the [Shopify App CLI development guide](https://github.com/Shopify/shopify-app-cli/wiki) for more information.
|
84
|
-
```console
|
85
|
-
$ shopify config feature [ feature_name ] [ --status | --enable | --disable ]
|
86
|
-
```
|