@shopify/argo-run
A command line interface for developing and building Argo extensions
Last updated 15 days ago by shopify-dep .
MIT · Original npm · Tarball · package.json
$ cnpm install @shopify/argo-run 
SYNC missed versions from official npm registry.

argo-run

This package provides a command line interface for developing and building Argo extensions.

Installation

$ yarn add @shopify/argo-run --dev

Usage

This package will add a argo-run binary to your project. You can execute this binary directly, or through yarn:

$ node_modules/.bin/argo-run <command>
$ yarn argo-run <command>

argo-run dev

alias: argo-run serve

$ yarn argo-run dev

This command will start a local development server for your extension. This development server, based on webpack-dev-middleware, will serve the JavaScript file for your extension, and will recompile it as you make changes to your codebase.

This command will print the localhost address of the asset server when it starts up. To control the port the server will bind to, you can pass the --port flag:

$ yarn argo-run dev --port 3000

If there is a website that can load a preview of your extension, this command can automatically navigate your browser to that page on start. To do so, pass a --open flag with the URL to navigate to:

$ yarn argo-run dev --open https://argogogo.dev

This command will open your default browser to the open URL, with an extension query parameter set to a JSON-stringified version of the extension asset’s URL. Additionally, if you pass an --extension-point flag to this command, it will be forwarded as an extension-point query parameter when the URL is opened in a browser.

The most complex example might look something like this:

$ yarn argo-run dev --open https://argogogo.dev --extension-point Checkout::PostPurchase::ShouldRender

Which would open your default browser to a the following URL, assuming the default asset server port is available:

https://argogogo.dev?extension=%2522http%253A%252F%252Flocalhost%253A8910%252Fassets%252Fextension.js%2522&extension-point=Checkout::PostPurchase::ShouldRender

argo-run build

$ yarn argo-run build

This command will run your extension through webpack to produce a highly-optimized asset. Once generated, the estimated size of the asset will be printed to the console.

The extension asset will be placed in the build directory adjacent to the directory in which you ran the command. By default, its name will be main.js, but this can be customized using the --filename flag:

$ yarn argo-run build --filename extension.js

Current Tags

  • 0.1.7                                ...           latest (15 days ago)

7 Versions

  • 0.1.7                                ...           15 days ago
  • 0.1.6                                ...           18 days ago
  • 0.1.5                                ...           18 days ago
  • 0.1.4                                ...           3 months ago
  • 0.1.3                                ...           3 months ago
  • 0.1.2                                ...           3 months ago
  • 0.1.1                                ...           3 months ago

Copyright 2014 - 2016 © taobao.org |