---
order: 0
meta:
  title: Getting Started
  description: Learn how to get started with Reacord.
---

# Getting Started

These guides assume some familiarity with JavaScript, [React](https://reactjs.org), [Discord.js](https://discord.js.org) and the [Discord API](https://discord.dev). Keep these pages as reference if you need it.

## Setup from template

[Use this starter template](https://github.com/itsMapleLeaf/reacord-starter) to get off the ground quickly.

## Adding to an existing project

Install Reacord and dependencies:

```bash
# npm
npm install reacord react discord.js

# yarn
yarn add reacord react discord.js

# pnpm
pnpm add reacord react discord.js
```

Create a Discord.js client and a Reacord instance:

```js
// main.jsx
import { Client } from "discord.js"
import { ReacordDiscordJs } from "reacord"

const client = new Client()
const reacord = new ReacordDiscordJs(client)

client.on("ready", () => {
  console.log("Ready!")
})

await client.login(process.env.BOT_TOKEN)
```

To use JSX in your code, run it with [tsx](https://npm.im/tsx):

```bash
npm install tsx
tsx main.tsx
```