![guildedjs](media/readme-header.png)
Tools for interacting with the Guilded.gg API.
Written in TS
Join our Discord Server! > Documentation
// commonJS:
const { Client } = require("@guildedjs/guilded.js");
/*
* ES6:
* import { Client } from "@guildedjs/guilded.js";
*/
const client = new Client();
client.on('ready', () => console.log(`Bot is successfully logged in`));
client.on("messageCreate", message => {
if(message.content === "poggers") {
return message.channel.send("poggers indeed");
}
})
client.login({
email: "email",
password: "password"
});
This repo serves as a monorepo that houses several packages, mainly the @guildedjs/guilded.js
package, which is a library for the Guilded API. Inspired heavily by discord.js
@guildedjs/guilded.js
- main package that provides a lib for the guilded.gg api. Comes with built in caching, structures, etc.@guildedjs/itami
- official framework for@guildedjs/guilded.js
, comes with highly customizable commands, listeners, and other abstractions.@guildedjs/guilded-api-types
- thinking of making your own guilded lib/wrapper? This package consists of typings for the guilded.gg api compiled together by the community. No need to write your own typings and reinventing the wheel.
You are expected to have a reasonably supported version of node.js. Guildedjs is tested on node.js >12.0.0 and we make no guarantees that it will work on earlier versions
npm install @guildedjs/guilded.js
yarn add @guildedjs/guilded.js
Documentation is viewable here: https://guilded.js.org
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.
As you start to contribute your beginner workflow should look similar to this:
fork repo
-> clone repo
-> cd into the repo
-> npm install
-> npm run bootstrap
-> npm run build
-> create new branch
-> your code changes
-> npm run lint
-> npm run build
-> commit & push changes
-> open pull request
Please ensure your commits pass the tests, lints, and builds. This means you should test it locally before pushing.
We make use of lerna to manage our monorepo. The main commands used are below
lerna add <module> [--scope=package-name]
- add npm module dependency to all/specific package(s)lerna create <package>
- create a new packagenpm run bootstrap
=lerna bootstrap
- recursively install dependencies in all packages and symlink local packageslerna run <npm-script>
- recursively execute command in all packages (must exist in each packages package.json)
Discord.js - Caching strategy and overall layout
Guilded.JS © zaida04, Released under the MIT License. All subpackages are also released under the MIT License