Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 1,000,000+ packages pre-installed, including @shopify/argo-run with all npm packages installed. Try it out:

var argoRun = require("@shopify/argo-run")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

@shopify/argo-run v0.2.4

A command line interface for developing and building Argo extensions

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

Metadata

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free