# @rexovolt/revolt.js

> Library for interacting with the Revolt API. Fork of v6.

Latest version **6.9.0** (published 2026-08-03) · MIT license · 0 weekly downloads

## Install

```sh
npm install @rexovolt/revolt.js
pnpm add @rexovolt/revolt.js
yarn add @rexovolt/revolt.js
bun add @rexovolt/revolt.js
```

## Health

**Score 50/100 (C)** — status: active.

Positive: has types; no vulnerabilities.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 6.9.0 |
| Published | 2026-08-03 |
| First published | 2023-10-30 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 7 |
| Unpacked size | 197.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Paul Makles |
| Maintainers | rexogamer |

## Links

- npm: https://www.npmjs.com/package/@rexovolt/revolt.js
- Repository: https://github.com/rexogamer/revolt.js
- Homepage: https://github.com/rexogamer/revolt.js#readme
- Issues: https://github.com/rexogamer/revolt.js/issues
- npm.io page: https://npm.io/package/@rexovolt/revolt.js

## Dependencies (7)

- [mobx](https://npm.io/package/mobx.md) ^6.13.7
- [ulid](https://npm.io/package/ulid.md) ^2.4.0
- [stoat-api](https://npm.io/package/stoat-api.md) ^0.14.3
- [eventemitter3](https://npm.io/package/eventemitter3.md) ^5.0.4
- [lodash.isequal](https://npm.io/package/lodash.isequal.md) ^4.5.0
- [lodash.defaultsdeep](https://npm.io/package/lodash.defaultsdeep.md) ^4.6.1
- [@insertish/exponential-backoff](https://npm.io/package/@insertish/exponential-backoff.md) 3.1.0-patch.2

## Recent versions

- 6.9.0 (latest) — 2026-08-03
- 6.8.0 — 2025-08-07
- 6.7.1 — 2025-04-09
- 6.7.0 — 2025-03-15
- 6.6.1 — 2025-01-30
- 6.6.0 — 2024-12-23
- 6.5.0 — 2024-12-21
- 6.4.0 — 2024-12-21
- 6.3.0 — 2024-06-24
- 6.2.0 — 2023-10-31
- 6.1.0 — 2023-10-30

## README

# @rexovolt/revolt.js

![@rexovolt/revolt.js](https://img.shields.io/npm/v/@rexovolt/revolt.js) <!-- ![revolt-api](https://img.shields.io/npm/v/revolt-api?label=Revolt%20API) -->

**revolt.js** is a direct implementation of the entire Stoat/Revolt API and provides a way to authenticate and start communicating with Stoat/Revolt servers. This repository is a fork of revolt.js v6 with various API updates.

## Example Usage (Javascript / ES6)

```javascript
import { Client } from "revolt.js";

let client = new Client();

client.on("ready", async () =>
    console.info(`Logged in as ${client.user.username}!`),
);

client.on("message", async (message) => {
    if (message.content === "hello") {
        message.channel.sendMessage("world");
    }
});

client.loginBot("..");
```

### Important note

If you're using Node 18 or earlier, you must specify `--experimental-specifier-resolution=node` when running your code (for example, `node --experimental-specifier-resolution=node index.js`).

If you're using Node 19 or later, you'll need to use a custom loader. Install `commonjs-extension-resolution-loader` using your preferred package manager (e.g. `yarn add commonjs-extension-resolution-loader`), then specify `--loader=commonjs-extension-resolution-loader` when running your code (for example, `node --loader=commonjs-extension-resolution-loader index.js`).

## Example Usage (CommonJS)

```javascript
const { Client } = require("revolt.js");

let client = new Client();

client.on("ready", async () =>
    console.info(`Logged in as ${client.user.username}!`),
);

client.on("message", async (message) => {
    if (message.content === "hello") {
        message.channel.sendMessage("world");
    }
});

client.loginBot("..");
```

## Example Usage (Typescript)

```typescript
import { Client } from "revolt.js";

let client = new Client();

client.on("ready", async () =>
    console.info(`Logged in as ${client.user!.username}!`),
);

client.on("message", async (message) => {
    if (message.content === "hello") {
        message.channel!.sendMessage("world");
    }
});

client.loginBot("..");
```

## MobX

MobX is used behind the scenes so you can subscribe to any change as you normally would, e.g. with `mobx-react(-lite)` or mobx's utility functions.

```typescript
import { autorun } from 'mobx';

[..]

client.once('ready', () => {
    autorun(() => {
        console.log(`Current username is ${client.user!.username}!`);
    });
});
```

## Stoat API Types

All `stoat-api` types are re-exported from this library under `API`.

```typescript
import { API } from "revolt.js";

// API.Channel;
// API.[..];
```

---
_Source: https://npm.io/package/@rexovolt/revolt.js · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
