Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/zptxdev/quaver-web

Web dashboard add-on for Quaver.
https://github.com/zptxdev/quaver-web

discord-js svelte sveltejs web-addon

Last synced: 3 months ago
JSON representation

Web dashboard add-on for Quaver.

Awesome Lists containing this project

README

        

Quaver-Web


Web dashboard add-on for Quaver.




Discord

# ⚠️ Warning

Quaver-Web is in an experimental state. Unless you have good reason to, you should not be using it, especially in conjunction with a public instance of Quaver.

Please proceed with caution. If you need help, getting it started regardless, feel free to ask your question in the Discord server above.

# 🚀 Getting Started

## Prerequisites

Quaver-Web requires a functional instance of Quaver to work.

Ensure your Quaver configuration includes the following:

```json
"features": {
"web": {
"enabled": true,
"port": 3000,
"allowedOrigins": [
"http://localhost"
],
"encryptionKey": "Type an encryption key here",
"https": {
"enabled": false,
"key": "key.pem",
"cert": "cert.pem"
},
"dashboardURL": "http://example.com"
}
}
```

Please modify the configuration as necessary. You may refer to [Quaver Configuration Guide](https://github.com/ZPTXDev/Quaver/blob/master/CONFIGURATION.md) for more information.

## Setup

1. Clone the repository and run `npm install` to install dependencies.
2. Create a `.env` file in the root directory of the project and add the following:

```env
PUBLIC_WEBSOCKET_HOST=http://localhost:3000
PUBLIC_DISCORD_CLIENT_ID=123456789012345678
PUBLIC_SUPPORT_SERVER=http://discord.gg/
PUBLIC_PREMIUM_URL=http://example.com/premium
PRIVATE_SECURE=false
```

> Note: `PRIVATE_SECURE` must be set to `false` if you are running Quaver-Web on HTTP instead of HTTPS.

3. Run `npm run build` to build the project.
4. Run `npm run preview` to start the preview server. (default port is 4173)
5. Navigate to `http://localhost:4173` to view the dashboard.