summary refs log tree commit diff
path: root/README.md
diff options
context:
space:
mode:
authorFlam3rboy <34555296+Flam3rboy@users.noreply.github.com>2021-02-03 17:43:04 +0100
committerFlam3rboy <34555296+Flam3rboy@users.noreply.github.com>2021-02-03 17:43:04 +0100
commit284e159ae2d04961524e8ef83523b118efc5f132 (patch)
treeaec6169b6c0f1f4332b592d07eef1e6a69213178 /README.md
parent:lock: prevent passwort denial of server (diff)
parentUpdate package.json (diff)
downloadserver-284e159ae2d04961524e8ef83523b118efc5f132.tar.xz
Merge branch 'master' of https://github.com/discord-open-source/discord-server
Diffstat (limited to 'README.md')
-rw-r--r--README.md46
1 files changed, 45 insertions, 1 deletions
diff --git a/README.md b/README.md

index 46fe919e..4a1c504b 100644 --- a/README.md +++ b/README.md
@@ -1 +1,45 @@ -# discord-server-opensource \ No newline at end of file +# Discord Open Source Server +This repository contains the HTTP API Server and the WebSocket Gateway Server + +## Bug Tracker +[Project Board](https://github.com/discord-open-source/discord-server/projects/4) + +## API +[Project Board](https://github.com/discord-open-source/discord-server/projects/3) + +For the WebSocket we use [ws](https://www.npmjs.com/package/ws) and we'll write our own packet handler for the individual opcodes and events. + +## Gateway +[Project Board](https://github.com/discord-open-source/discord-server/projects/6) + +We use [express](https://expressjs.com/) for the HTTP Server and +[lambert-server](https://www.npmjs.com/package/lambert-server) for route handling and body validation (customized). + +## Contribution +You should be familiar with: +- [Git](https://git-scm.com/) +- [NodeJS](https://nodejs.org/) +- [TypeScript](https://www.typescriptlang.org/) +- [Lambert-DB](https://www.npmjs.com/package/lambert-db) (easy database abstraction wrapper) + +and the technologies we use for Gateway/API + +### Getting Started +Clone the Repository: +```bash +git clone https://github.com/discord-open-source/discord-server +cd discord-server +``` +#### Install (dev)dependencies: +```bash +npm install +npm install --only=dev +``` +#### Starting: +``` +npm start +``` +#### Debugging: +**Vscode:** +The Launch file configuration is in ``./vscode/launch.json``, +so you can just debug the server by pressing ``F5`` or the ``> Launch Server`` button