Skip to content
A template for creating bots with matrix-bot-sdk
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

matrix-bot-sdk Bot Templates

A template for creating bots with matrix-bot-sdk.

Projects using this template

None yet!

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.

  1. Replace this README with something useful.
  2. Update your project's details in package.json.
  3. Run npm install to 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 👍 to this issue.


This template uses a package called config to manage configuration. The default configuration is offered as config/default.yaml. Copy/paste this to config/development.yaml and config/production.yaml and edit them accordingly for your environment.

Project structure

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 src/.


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 on Matrix if you're having trouble with this template.


Credit to anoa's matrix-nio template for the README format.

You can’t perform that action at this time.