shopify-cli 1.5.0 → 1.6.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.
- 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.md)[](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
|
-
```
|