Command Line Interface for Wappsto, so that it is possible to create Wapps locally.
Wappsto-cli requires node version 16.4.0 or higher to work properly.
First create a new folder for you wapp and enter it.
mkdir my-new-wapp
cd my-new-wappYou can now install the package with npm.
npm install wappsto-cli --save-devOr using yarn.
yarn add wappsto-cli -DWhen use yarn remember to create a package.json file in your folder before installing.
echo '{}' > package.jsonTo create a Wapp run the wapp create using npx:
npx wapp createIt will ask for your 'username' and 'password' to Wappsto, unless you are already logged in. Here you get the option to download any existing Wapps or create a new Wapp.
This will generate a file called manifest.json where you can modify the description of your wapp.
To start a local web server and local background runner, that will serve the Wapp run the wapp serve using npx:
npx wapp serveThis 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 wapp serve.
If you want to run your background files on the server, you can use the --remote flag when starting wapp serve.
To configure your wapp you can run wapp configure using npx, to change some settings for your wapp.
This is also where you can create OAuth configurations for your wapp.
npx wapp configureTo update the Wapp on wappsto run the wapp update using npx:
npx wapp updateThis will upload all your files to Wappsto and download any new files created for your Wapp.
To publish the Wapp to the Wappsto Store run the wapp publish using npx:
npx wapp publishThis will make your wapp available in the store for other people to use.
To delete the Wapp run the wapp delete using npx:
npx wapp deleteThis will delete your Wapp locally and/or remotely.
To trigger a reinstall of the application run:
npx wapp update --reinstallYou 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'). |
| webServer | default |
The internal web server from Wappsto CLI. |
| cacheFolder | .wappsto-cli-cache |
The folder where Wappsto CLI stores it's temporary files. |
Here is some examples on how to configure frameworks to work with wappsto-cli.
If you are using React framework, you can configure the React development server, by installing the following package:
npm install http-proxy-middleware --saveand creating a file src/setupProxy.js with this:
const { createProxyMiddleware } = require('http-proxy-middleware');
const wappsto = require('wappsto-cli');
let sessionID = '';
const run = async () => {
sessionID = await wappsto.getSession();
};
run();
module.exports = function (app) {
app.use(
createProxyMiddleware('/services', {
target: wappsto.getHost(),
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 wapp serve to serve the build version of your react application.
If you are using Vite framework, you can configure the Vite development server, by adding this to vite.config.ts.
import { defineConfig } from 'vite';
import react from '@vitejs/plugin-react';
import wappsto from 'wappsto-cli';
// https://vitejs.dev/config/
export default defineConfig(async () => {
const sessionID = await wappsto.getSession();
return {
plugins: [react()],
build: {
outDir: './foreground',
},
server: {
proxy: {
'/services': {
target: wappsto.getHost(),
secure: true,
changeOrigin: true,
ws: true,
headers: {
'x-session': sessionID,
},
},
},
},
};
});- wappsto-wapp - Javascript lib for writing Wapps in Wappsto
Apache 2.0 © Seluxit A/S