wappsto-cli

wappsto-cli

Command Line Interface for Wappsto, so that it is possible to create Wapps locally.

Table of Contents

1. Requirements
2. Install
3. Usage
4. Configuration
5. Frameworks
6. Related
7. License

Requirements

Wappsto-cli requires node version 16.4.0 or higher to work properly.

Install

First create a new folder for you wapp and enter it.

mkdir my-new-wapp
cd my-new-wapp

You can now install the package with npm.

npm install wappsto-cli --save-dev

Or using yarn.

yarn add wappsto-cli -D

When use yarn remember to create a package.json file in your folder before installing.

echo '{}' > package.json

Usage

Create

To create a Wapp run the create-wapp using npx:

npx create-wapp

It will ask for your 'username' and 'password' to Wappsto, unless you are already logged in. Here you get the option to download any exsisting Wapps or create a new Wapp.

This will generate a file called manifest.json where you can modify the description of your wapp.

Run

To start a local web server and local background runner, that will serve the Wapp run the serve-wapp using npx:

npx serve-wapp

This will run a local web server where you can test your wapp foreground part of your wapp. It is default listen on port 3000. This will also run your background files in a local node instance. Any notifications from your Wapp is presented in the terminal where you are running serve-wapp. If you want to run your background files on the server, you can use the --remote flag when starting serve-wapp.

Configure

To configure your wapp you can run configure-wapp using npx, to chaange some settings for your wapp. This is also where you can create OAuth configurations for your wapp.

npx configure-wapp

Update

To update the Wapp on wappsto run the update-wapp using npx:

npx update-wapp

This will upload all your files to Wappsto and download any new files created for your Wapp.

Delete

To delete the Wapp run the delete-wapp using npx:

npx delete-wapp

This will delete your Wapp locally and/or remotely.

Reinstall

To trigger a reinstall of the application run:

npx update-wapp --reinstall

Configuration

You can configure wappsto-cli by creating a 'wappsto.json' file and add this:

{
 "foreground": "foreground",
 "background": "background",
 "port": "3000"
}

Valid options is:

Option	Default	Description
foreground	foreground	The folder where the foreground files will be stored.
background	background	The folder where the background files will be stored.
port	3000	The port the web server will serve the Wapp on.
browser	default	The browser used to serve the frontend files. ('google-chrome' or 'firefox')

Frameworks

Here is some examples on how to configure frameworks to work with wappsto-cli.

React

If you are using React framework, you can configure the React development server, by installing the following package:

npm install http-proxy-middleware --save

and creating a file src/setupProxy.js with this:

const { createProxyMiddleware } = require('http-proxy-middleware');
const Wapp = require('wappsto-cli/lib/wapp');

const wapp = new Wapp();

const HOST = wapp.host;
let sessionID = '';

const run = async () => {
  await wapp.init();
  sessionID = await wapp.getInstallationSession();
};
run();

module.exports = function (app) {
  app.use(
    '/services', 
    createProxyMiddleware({
    target: HOST,
    changeOrigin: true,
    ws: true,
    logLevel: 'error',
  }));

  // set a cookie
  app.use((req, res, next) => {
    res.cookie('sessionID', sessionID, { maxAge: 900000 });
    next();
  });
};

And insert "homepage": "./", into your package.json file.

To use the build version of React, change the foreground configuration to build and then run npm run build to build the react application. Then run npx serve-wapp to serve the build version of your react application.

Related

• wappsto-wapp - Javascript lib for writing Wapps in Wappsto

License

Apache 2.0 © Seluxit A/S