Install

Botmation is written in TypeScript and runs on NodeJS v10+. You'll need both installed to compile and run the code.

Bare bones setup

If you're starting a new project, in your project's code directory, use npm from NodeJS and tsc from TypeScript, to initialize the environment:

Copy
npm init -y
tsc --init
touch index.ts

Now you can begin writing bot code in index.ts file and more.

Install Botmation

For any bot work, you'll need at least the core Botmation package, installed via npm:

Copy
npm install --save @botmation/core

Install Puppeteer

If you haven't already, install puppeteer:

Copy
npm install --save puppeteer

Import BotActions

Then in your code, import the Botmations, helpers, etc from the @botmation/core package:

Copy
import { chain, goTo, screenshot } from '@botmation/core';

All of Core's functions are documented with examples, under Core in the sidebar on the left.

Compile and run

If you're following the New project setup, compile and run the code:

Copy
tsc # compiles
node index.js # runs

If you want to watch Puppeteer control the browser, configure it with headless: false. Otherwise, the browser window won't display when the bot runs.

Have fun 🚀