README

Actyx-Project-CLI
Create a new project within seconds and start something awesome! This tool gives you the opportunity to create a TypeScript Node.js or a React application with one command.
📦 Installation
Install the Actyx-Project-CLI globally to have access to wherever you are. npm package.
npm install -g @actyx-contrib/axp
🛠️ Init Project
The installed axp
tool will create you a monorepo with git, ESLint, and TypeScript.
In this project, you can add your apps with the axp add <appType>
command.
# Pond Version 1
axp init -v 1
# Pond Version 2
axp init
axp init -v 2
The init step is optional. You can directly create an new app with axp add [ui|node]
📑 React application
Create a new React-App with the axp add ui
command. It will user parcel as build tool and setup jest for tests.
Additional to this. The actyx manifest for a WebView App is generated.
axp add ui --appName "awesome Ui"
After executing this command you will find some new scripts in you package.json
ui:<appName>:start
run the app in dev mode with automatic rebuildui:<appName>:build
build the React application to deploy itui:<appName>:package
use the ax-manifest to create a deployable package
📑 Node application
Create a new Node.js with the axp add node
command. It will setup jest for tests.
Additional to this. The actyx manifest for a docker App is generated.
axp add node --appName "awesome App" --test
After executing this command you will find some new scripts in you package.json
node:<appName>:start
run theindex.ts
in your applicationnode:<appName>:build
build the node js application to deploy itnode:<appName>:package
use the ax-manifest to create a deployable package
📖 Commands
This list is a overview of the existing commands. Use the integrated help to get detailed information about the commands
command | shortcut | Function |
---|---|---|
axp init |
axp --init -v 2 |
Initialize a new project in the current directory |
axp add <type> [-n Name] [--test] [--jest] |
axp a |
Create a new application with the given type and name |
axp addFeature <project> <feature> |
axp af |
Add a new feature to the project (test / jest / storybook) |
axp list |
axp ls |
List all existing projects and check if some unreferenced projects are in the package.json |
axp clean |
axp c |
Remove unreferenced commands in the package.json |
axp help |
axp -h |
Show the general help output |
axp <command> --help |
<shortcut> -h |
Show the help output for a given command |
axp --version |
axp -V |
axp version |
🤓 Developer tools
The best way to work and test the project is to run the npm run build:watch
and npm link
it once. From this moment on, you can manipulate the code and try the axp
cli command in any directory
Script | Description |
---|---|
npm run clean |
Clean lib and coverage folders |
npm run build |
Build project |
npm run build:watch |
Build project watch mode |
npm run lint |
Check for lint issues |
npm run lint:fix |
Check and automatically fix lint issues |
npm run license:add |
Append license information to every relevant files |
npm run license:check |
Check if license information is present on every relevant files |
npm run license:check-dep |
Check the licenses for project dependencies and produce a summary |