LiveChat Developer Console CLI

This project exposes LiveChat Developer Console capabilities in form of easy to use CLI application. Additionally it allows for quick application bootstrap and project scaffolding.

📦 Installation

Use the package manager npm or yarn to install choosen package in your project.

npm install -g @livechat/dev-cli
# or
yarn global add @livechat/dev-cli

🚀 Usage

LiveChat Developer Console CLI

lcdev [command]

Commands:
  lcdev init [dirName]  scafold new LiveChat app project from template
  lcdev login           login with your LiveChat account
  lcdev bootstrap       bootstrap new LiveChat app using config file
  lcdev create          create new LiveChat app
  lcdev widget          setup agent app widget
  lcdev auth            setup app authorization
  lcdev app-webhooks    setup app webhooks
  lcdev chat-webhooks   setup chat webhooks
  lcdev chat-actions    setup chat actions
  lcdev chat-boosters   setup chat boosters
  lcdev remove          remove app

Options:
  --help     Show help
  --version  Show version number

⚙️ Getting started

Here you can find a step by step guide how to go from freshly created account in the LiveChat Develoepr Program to a fully working LiveChat App ready to be used on your LiveChat account.

Warning Before you start make sure you already have a LiveChat account (you can create one here). You would also need Ngrok, together with free account, installed on your computer to obtain temporary and secure public domain for your local app (follow this instructions).

1. Install the LiveChat Developer Console CLI:

npm install -g @livechat/dev-cli

2. Check that you are using the latest version and can access CLI:

lcdev --version

3. Login to your LiveChat account inside the CLI:

lcdev login

4. Initialize a new project from our official Nex.js app template:

lcdev init first-livechat-app

5. Install project dependencies and start local dev server:

cd first-livechat-app
npm install
npm run dev

6. Open the HTTP tunnel to obtain secure public domain for your local app:

ngrok http 3000

7. Bootstrap the new LiveChat App providing newly established public domain:

lcdev bootstrap --baseURL <your-https-domain-from-ngrok>

🏗 Contributing

Read our Contributing Guide to learn about our development process, how to propose bugfixes and improvements, and how to build and test your changes.

This project has adopted a Code of Conduct that we expect project participants to adhere to. Please read the full text so that you can understand what actions will and will not be tolerated.

📃 License

The code and documentation in this project are released under the MIT License.