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.
Files changed (179) hide show
  1. checksums.yaml +4 -4
  2. data/.github/PULL_REQUEST_TEMPLATE.md +1 -0
  3. data/.travis.yml +1 -0
  4. data/CHANGELOG.md +9 -0
  5. data/README.md +39 -7
  6. data/Rakefile +2 -0
  7. data/dev.yml +2 -2
  8. data/docs/_config.yml +1 -18
  9. data/docs/app/node/commands/index.md +2 -80
  10. data/docs/app/node/index.md +2 -33
  11. data/docs/app/rails/commands/index.md +2 -78
  12. data/docs/app/rails/index.md +2 -34
  13. data/docs/core/index.md +2 -84
  14. data/docs/getting-started/index.md +2 -25
  15. data/docs/getting-started/install/index.md +1 -118
  16. data/docs/getting-started/migrate/index.md +2 -94
  17. data/docs/getting-started/uninstall/index.md +2 -35
  18. data/docs/getting-started/upgrade/index.md +2 -39
  19. data/docs/help/start-app/index.md +2 -4
  20. data/docs/index.md +2 -24
  21. data/install.sh +1 -1
  22. data/lib/project_types/extension/cli.rb +19 -10
  23. data/lib/project_types/extension/commands/extension_command.rb +2 -2
  24. data/lib/project_types/extension/features/argo.rb +117 -0
  25. data/lib/project_types/extension/forms/create.rb +2 -2
  26. data/lib/project_types/extension/models/specification.rb +35 -0
  27. data/lib/project_types/extension/models/specification_handlers/checkout_post_purchase.rb +19 -0
  28. data/lib/project_types/extension/models/specification_handlers/default.rb +67 -0
  29. data/lib/project_types/extension/models/specifications.rb +77 -0
  30. data/lib/project_types/extension/tasks/configure_features.rb +52 -0
  31. data/lib/project_types/extension/tasks/fetch_specifications.rb +38 -0
  32. data/lib/project_types/node/commands/create.rb +3 -1
  33. data/lib/project_types/node/commands/generate.rb +2 -11
  34. data/lib/project_types/node/messages/messages.rb +9 -44
  35. data/lib/project_types/rails/commands/create.rb +8 -9
  36. data/lib/project_types/rails/forms/create.rb +1 -1
  37. data/lib/project_types/rails/gem.rb +1 -1
  38. data/lib/project_types/rails/messages/messages.rb +1 -1
  39. data/lib/project_types/script/cli.rb +7 -4
  40. data/lib/project_types/script/commands/create.rb +6 -4
  41. data/lib/project_types/script/commands/push.rb +5 -13
  42. data/lib/project_types/script/config/extension_points.yml +9 -5
  43. data/lib/project_types/script/errors.rb +17 -0
  44. data/lib/project_types/script/forms/create.rb +26 -2
  45. data/lib/project_types/script/graphql/app_script_update_or_create.graphql +10 -1
  46. data/lib/project_types/script/layers/application/build_script.rb +9 -4
  47. data/lib/project_types/script/layers/application/create_script.rb +12 -10
  48. data/lib/project_types/script/layers/application/extension_points.rb +24 -0
  49. data/lib/project_types/script/layers/application/push_script.rb +18 -16
  50. data/lib/project_types/script/layers/domain/errors.rb +4 -0
  51. data/lib/project_types/script/layers/domain/extension_point.rb +62 -6
  52. data/lib/project_types/script/layers/domain/metadata.rb +55 -0
  53. data/lib/project_types/script/layers/domain/push_package.rb +25 -6
  54. data/lib/project_types/script/layers/infrastructure/assemblyscript_project_creator.rb +6 -6
  55. data/lib/project_types/script/layers/infrastructure/assemblyscript_task_runner.rb +16 -6
  56. data/lib/project_types/script/layers/infrastructure/extension_point_repository.rb +10 -4
  57. data/lib/project_types/script/layers/infrastructure/project_creator.rb +2 -1
  58. data/lib/project_types/script/layers/infrastructure/push_package_repository.rb +25 -13
  59. data/lib/project_types/script/layers/infrastructure/rust_project_creator.rb +72 -0
  60. data/lib/project_types/script/layers/infrastructure/rust_task_runner.rb +59 -0
  61. data/lib/project_types/script/layers/infrastructure/script_service.rb +7 -1
  62. data/lib/project_types/script/layers/infrastructure/task_runner.rb +4 -3
  63. data/lib/project_types/script/messages/messages.rb +39 -8
  64. data/lib/project_types/script/script_project.rb +25 -16
  65. data/lib/project_types/script/ui/error_handler.rb +34 -1
  66. data/lib/project_types/theme/cli.rb +40 -0
  67. data/lib/project_types/theme/commands/connect.rb +54 -0
  68. data/lib/project_types/theme/commands/create.rb +48 -0
  69. data/lib/project_types/theme/commands/deploy.rb +38 -0
  70. data/lib/project_types/theme/commands/generate.rb +20 -0
  71. data/lib/project_types/theme/commands/generate/env.rb +79 -0
  72. data/lib/project_types/theme/commands/push.rb +55 -0
  73. data/lib/project_types/theme/commands/serve.rb +31 -0
  74. data/lib/project_types/theme/forms/connect.rb +34 -0
  75. data/lib/project_types/theme/forms/create.rb +22 -0
  76. data/lib/project_types/theme/messages/messages.rb +147 -0
  77. data/lib/project_types/theme/tasks/ensure_themekit_installed.rb +78 -0
  78. data/lib/project_types/theme/themekit.rb +113 -0
  79. data/lib/shopify-cli/admin_api.rb +42 -2
  80. data/lib/shopify-cli/api.rb +27 -24
  81. data/lib/shopify-cli/commands/system.rb +1 -1
  82. data/lib/shopify-cli/context.rb +23 -2
  83. data/lib/shopify-cli/feature.rb +0 -2
  84. data/lib/shopify-cli/http_request.rb +20 -8
  85. data/lib/shopify-cli/messages/messages.rb +6 -3
  86. data/lib/shopify-cli/method_object.rb +104 -0
  87. data/lib/shopify-cli/partners_api.rb +8 -2
  88. data/lib/shopify-cli/project_type.rb +1 -1
  89. data/lib/shopify-cli/resolve_constant.rb +25 -0
  90. data/lib/shopify-cli/result.rb +432 -0
  91. data/lib/shopify-cli/shopifolk.rb +3 -2
  92. data/lib/shopify-cli/tasks/select_org_and_shop.rb +6 -5
  93. data/lib/shopify-cli/tunnel.rb +7 -1
  94. data/lib/shopify-cli/version.rb +1 -1
  95. data/lib/shopify_cli.rb +4 -1
  96. data/shopify.fish +1 -1
  97. data/shopify.sh +1 -1
  98. data/vendor/deps/cli-kit/REVISION +1 -1
  99. data/vendor/deps/cli-kit/lib/cli/kit/logger.rb +2 -2
  100. data/vendor/deps/cli-kit/lib/cli/kit/system.rb +3 -3
  101. data/vendor/deps/cli-ui/REVISION +1 -1
  102. data/vendor/deps/cli-ui/lib/cli/ui.rb +26 -22
  103. data/vendor/deps/cli-ui/lib/cli/ui/ansi.rb +4 -6
  104. data/vendor/deps/cli-ui/lib/cli/ui/frame.rb +3 -3
  105. data/vendor/deps/cli-ui/lib/cli/ui/frame/frame_stack.rb +8 -9
  106. data/vendor/deps/cli-ui/lib/cli/ui/frame/frame_style.rb +1 -1
  107. data/vendor/deps/cli-ui/lib/cli/ui/glyph.rb +1 -0
  108. data/vendor/deps/cli-ui/lib/cli/ui/printer.rb +15 -3
  109. data/vendor/deps/cli-ui/lib/cli/ui/prompt/interactive_options.rb +4 -11
  110. data/vendor/deps/cli-ui/lib/cli/ui/spinner.rb +3 -5
  111. data/vendor/deps/cli-ui/lib/cli/ui/terminal.rb +10 -10
  112. data/vendor/deps/cli-ui/lib/cli/ui/version.rb +1 -1
  113. data/vendor/deps/cli-ui/lib/cli/ui/wrap.rb +56 -0
  114. data/vendor/deps/webrick/.gitignore +9 -0
  115. data/vendor/deps/webrick/Gemfile +3 -0
  116. data/vendor/deps/webrick/LICENSE.txt +22 -0
  117. data/vendor/deps/webrick/README.md +61 -0
  118. data/vendor/deps/webrick/Rakefile +10 -0
  119. data/vendor/deps/webrick/lib/webrick.rb +232 -0
  120. data/vendor/deps/webrick/lib/webrick/accesslog.rb +157 -0
  121. data/vendor/deps/webrick/lib/webrick/cgi.rb +313 -0
  122. data/vendor/deps/webrick/lib/webrick/compat.rb +36 -0
  123. data/vendor/deps/webrick/lib/webrick/config.rb +158 -0
  124. data/vendor/deps/webrick/lib/webrick/cookie.rb +172 -0
  125. data/vendor/deps/webrick/lib/webrick/htmlutils.rb +30 -0
  126. data/vendor/deps/webrick/lib/webrick/httpauth.rb +96 -0
  127. data/vendor/deps/webrick/lib/webrick/httpauth/authenticator.rb +117 -0
  128. data/vendor/deps/webrick/lib/webrick/httpauth/basicauth.rb +116 -0
  129. data/vendor/deps/webrick/lib/webrick/httpauth/digestauth.rb +395 -0
  130. data/vendor/deps/webrick/lib/webrick/httpauth/htdigest.rb +132 -0
  131. data/vendor/deps/webrick/lib/webrick/httpauth/htgroup.rb +97 -0
  132. data/vendor/deps/webrick/lib/webrick/httpauth/htpasswd.rb +158 -0
  133. data/vendor/deps/webrick/lib/webrick/httpauth/userdb.rb +53 -0
  134. data/vendor/deps/webrick/lib/webrick/httpproxy.rb +354 -0
  135. data/vendor/deps/webrick/lib/webrick/httprequest.rb +636 -0
  136. data/vendor/deps/webrick/lib/webrick/httpresponse.rb +564 -0
  137. data/vendor/deps/webrick/lib/webrick/https.rb +152 -0
  138. data/vendor/deps/webrick/lib/webrick/httpserver.rb +294 -0
  139. data/vendor/deps/webrick/lib/webrick/httpservlet.rb +23 -0
  140. data/vendor/deps/webrick/lib/webrick/httpservlet/abstract.rb +152 -0
  141. data/vendor/deps/webrick/lib/webrick/httpservlet/cgi_runner.rb +47 -0
  142. data/vendor/deps/webrick/lib/webrick/httpservlet/cgihandler.rb +126 -0
  143. data/vendor/deps/webrick/lib/webrick/httpservlet/erbhandler.rb +88 -0
  144. data/vendor/deps/webrick/lib/webrick/httpservlet/filehandler.rb +552 -0
  145. data/vendor/deps/webrick/lib/webrick/httpservlet/prochandler.rb +47 -0
  146. data/vendor/deps/webrick/lib/webrick/httpstatus.rb +194 -0
  147. data/vendor/deps/webrick/lib/webrick/httputils.rb +512 -0
  148. data/vendor/deps/webrick/lib/webrick/httpversion.rb +76 -0
  149. data/vendor/deps/webrick/lib/webrick/log.rb +156 -0
  150. data/vendor/deps/webrick/lib/webrick/server.rb +381 -0
  151. data/vendor/deps/webrick/lib/webrick/ssl.rb +215 -0
  152. data/vendor/deps/webrick/lib/webrick/utils.rb +265 -0
  153. data/vendor/deps/webrick/lib/webrick/version.rb +18 -0
  154. data/vendor/deps/webrick/webrick.gemspec +74 -0
  155. metadata +70 -26
  156. data/docs/Gemfile +0 -5
  157. data/docs/Gemfile.lock +0 -258
  158. data/docs/_data/nav.yml +0 -35
  159. data/docs/_includes/footer.html +0 -15
  160. data/docs/_includes/head.html +0 -19
  161. data/docs/_includes/sidebar_nav.html +0 -22
  162. data/docs/_includes/toc.html +0 -112
  163. data/docs/_layouts/default.html +0 -79
  164. data/docs/css/docs.css +0 -157
  165. data/docs/images/header.png +0 -0
  166. data/docs/installing-ruby.md +0 -28
  167. data/lib/project_types/extension/features/argo/admin.rb +0 -20
  168. data/lib/project_types/extension/features/argo/base.rb +0 -129
  169. data/lib/project_types/extension/features/argo/checkout.rb +0 -20
  170. data/lib/project_types/extension/models/type.rb +0 -81
  171. data/lib/project_types/extension/models/types/checkout_post_purchase.rb +0 -23
  172. data/lib/project_types/extension/models/types/product_subscription.rb +0 -24
  173. data/lib/project_types/node/commands/generate/billing.rb +0 -39
  174. data/lib/project_types/node/commands/generate/page.rb +0 -59
  175. data/lib/project_types/node/commands/generate/webhook.rb +0 -37
  176. data/lib/project_types/script/layers/domain/script.rb +0 -18
  177. data/lib/project_types/script/layers/infrastructure/script_repository.rb +0 -47
  178. data/lib/project_types/script/templates/ts/as-pect.config.js +0 -27
  179. 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: 6d907a49558ca8dfb5998667698b5bf262d850a55951ac2af30c178f141d9063
4
- data.tar.gz: 833124c900634e59426bef89dd7fbf35948d19b73e55ecb96becfb6307b3cc3a
3
+ metadata.gz: 51b21780f8f46054f92124110152a903c94a6215436b73b5dce40c8ad7b072cc
4
+ data.tar.gz: 2884ba67316188cd05ae6b8cd3e7927a7dc8d99936fd328eed6a2480452eec4b
5
5
  SHA512:
6
- metadata.gz: 4670c00c70ae907f1d5eea958ba512ac61e2579566dabf4bb09345925d6da2cd882e5c4d0e9bededd92fd779f85326d4b4cbc66d3c268ee816aa0d23330bc55c
7
- data.tar.gz: 33a780da492b11846f89d84b74da119d707236846e4b9617ccb1541cde9be83b0f33fcf302d92b3aaa58c3634ed9004d3d2b7673f0a2a916b33ed2336b2835f9
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
@@ -1,5 +1,6 @@
1
1
  language: ruby
2
2
  rvm:
3
+ - 3.0.0
3
4
  - 2.5.8
4
5
  - 2.6.6
5
6
  - 2.7.1
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 automates many common tasks in the development process and lets you quickly add popular features, such as billing and webhooks.
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
- ## Using the CLI
8
- Consult the [Shopify App CLI documentation](https://shopify.github.io/shopify-app-cli) to get started.
7
+ ## Features
9
8
 
10
- ## Developing the CLI
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
- [Read the development guide](https://github.com/Shopify/shopify-app-cli/wiki) to learn more.
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
@@ -11,7 +11,7 @@ test:
11
11
  run: |
12
12
  if [ "$#" -eq 1 ] && [[ -f $1 ]];
13
13
  then
14
- rake test TEST=$1
14
+ bundle exec rake test TEST=$1
15
15
  else
16
- rake test $@
16
+ bundle exec rake test $@
17
17
  fi
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 project command reference
3
- section: node
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
- ```
@@ -1,35 +1,4 @@
1
1
  ---
2
- title: Getting started with Node.js app projects
3
- section: node
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 project command reference
3
- section: rails
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
- ```
@@ -1,36 +1,4 @@
1
1
  ---
2
- title: Getting started with Rails app projects
3
- section: rails
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: Core commands
3
- section: core
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
- ```