hiro-sdk-clideprecated

HIRO applications generator.

Usage no npm install needed!

<script type="module">
  import hiroSdkCli from 'https://cdn.skypack.dev/hiro-sdk-cli';
</script>

README

HIRO SDK CLI

CLI utils for HIRO applications.

Project setup

Prerequisites

  • node 8+
  • npm 6+

Instalation

  • Run npm i -g hiro-sdk-cli

Commands

hiro-sdk init

Initializes new HIRO Application.

react-scripts v1.1.5 is used for development server / build scripts.

Usage:

  • hiro-sdk init my-app - initialize blank my-app application.
  • hiro-sdk init my-app -t react - initialize React my-app applicaiton.

Advanced usage:

  • hiro-sdk init my-app -l - initialize blank my-app application and link local hiro-sdk package
  • hiro-sdk init my-app -t react -l - initialize React my-app applicaiton and link local hiro-sdk package

hiro-sdk bundle

Bundles compiled application into a zip archive.

We need to build our app first. Run npm run build to create a production build.

As result, we expect a build folder in project root. It should have the following structure:

build
├── asset-manifest.json
├── icon.svg
├── index.html
└── static
    ├── css
    │   └── main.2c2ee846.css
    └── js
        └── main.fb659025.js

Important files

icon.svg is used by HIRO Desktop as the icon of the application.

asset-manifest.json contains paths mapping for your assets. main.js is required. Example asset-manifest.json contents:

{
  "main.css": "static/css/main.2c2ee846.css",
  "main.js": "static/js/main.fb659025.js"
}

HIRO Desktop loads main.js and all .css files found in manifest.

After we've made a production build, we need to bundle the app.
hiro-sdk bundle command creates a bundle.zip archive in the project root.

hiro-sdk publish

Publishes bundled application (bundle.zip) to the graph.

You can provide either host/token/parent combination to command or read those values from env files.

Using explicit arguments:

  • -h = Graph URL
  • -t = Graph token
  • -p = Desktop "ui" app ID on your installation

Using implicit arguments: just pass -e flag to read arguments from .env files

  • HIRO_GRAPH_URL = Graph URL
  • HIRO_GRAPH_TOKEN = Graph token
  • HIRO_DESKTOP_ID = Desktop "ui" app ID on your installation
# Explicit arguments
hiro-sdk publish -h https://acme.graphit.co -t vm8127v89126cn8712616c12c12 -p awv8a57wavmawvawawvaw

# Implicit arguments
hiro-sdk publish -e

As result, your application will be either created or updated, depending on name field in the manifest.yaml. NOTE, that you can only update applications uploaded by you.

Use hiro-sdk --help to get more info