matrix-bot-sdk Bot Templates
A template for creating bots with matrix-bot-sdk.
Projects using this template
Want your project listed? Edit this doc.
Running / Building
After clicking the 'use this template' button and cloning the repo, you'll need to install the dependencies and open an editor to get started. This assumes you have at least NodeJS 10 or higher.
- Replace this README with something useful.
- Update your project's details in
npm installto get the dependencies.
To build it:
npm run build.
To run it:
npm run start:dev
To check the lint:
npm run lint
Think this should have a Docker image built-in? Add a
This template uses a package called
config to manage configuration. The default configuration is offered
config/default.yaml. Copy/paste this to
config/production.yaml and edit
them accordingly for your environment.
This is a somewhat opinionated template that is runnable out of the box. The project is TypeScript with
a linter that matches the bot-sdk itself. All the good bits of the bot are under
This is where the bot's entry point is. Here you can see it reading the config, preparing the storage, and setting up other stuff that it'll use throughout its lifetime. Nothing in here should really require modification - most of the bot is elsewhere.
When the bot receives a command (see
index.ts for handoff) it gets processed here. The command structure
is fairly manual, but a basic help menu and processing for a single command is there.
This is the bot's
!bot hello command. It doesn't do much, but it is an example.
This is simply a typescript interface for your config so you can make use of types.
This is where the project's build files go. Not really much to see here.
This is the default storage location. Also not much to see here.
Come visit us in #matrix-bot-sdk:t2bot.io on Matrix if you're having trouble with this template.
Credit to anoa's matrix-nio template for the README format.