Skip to content

Commit 6cdbacc

Browse files
committed
readme
1 parent 951a652 commit 6cdbacc

1 file changed

Lines changed: 225 additions & 0 deletions

File tree

β€ŽREADME.mdβ€Ž

Lines changed: 225 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,3 +17,228 @@
1717

1818
> [!NOTE]
1919
> **Boostify** is a work-in-progress project. While our team ensures everything in our platform works flawlessly, you're more than welcome to make an issue if you find an issue. Please join our Discord server if you require any assistance: [discord.gg/vZgeWhZ9aF](https://discord.gg/vZgeWhZ9aF).
20+
21+
---
22+
23+
# Quick Start
24+
25+
Get Boostify running in minutes using the official cloud version or self-host it yourself.
26+
27+
## Choose Your Setup
28+
29+
| Option | Description |
30+
| --- | --- |
31+
| ☁️ **Cloud Hosted** | Use the official Boostify bot instantly. |
32+
| πŸ–₯️ **Self Hosted** | Deploy your own Boostify instance using Node.js or Docker. |
33+
34+
---
35+
36+
# ☁️ Cloud Hosted
37+
38+
The fastest way to start using Boostify.
39+
40+
## 1. Invite Boostify
41+
42+
Invite Boostify to your Discord server:
43+
44+
πŸ‘‰ https://discord.com/oauth2/authorize?client_id=1453802179789066442
45+
46+
---
47+
48+
## 2. Required Permissions
49+
50+
Boostify requires the following permissions:
51+
52+
- Add Reactions
53+
- Embed Links
54+
- Manage Roles
55+
- Send Messages
56+
- View Server Subscription Insights
57+
58+
> [!IMPORTANT]
59+
> Place the Boostify role above any reward roles you want it to manage.
60+
61+
---
62+
63+
## 3. Configure Your Server
64+
65+
Once invited, configure features like:
66+
67+
- Booster reward roles
68+
- Auto thank-you messages
69+
- Logging
70+
- Moderation
71+
- Booster analytics
72+
- Freemium perks
73+
74+
Continue to the documentation for advanced configuration.
75+
76+
---
77+
78+
# πŸ–₯️ Self Hosting
79+
80+
Self-host Boostify for full control and customization.
81+
82+
---
83+
84+
## Requirements
85+
86+
### Required
87+
88+
- Node.js 20+
89+
- PostgreSQL
90+
- Git
91+
- Discord Bot Token
92+
93+
### Optional
94+
95+
- Docker
96+
- PM2
97+
- Reverse Proxy (Nginx/Caddy)
98+
99+
---
100+
101+
# Installation
102+
103+
## 1. Clone the Repository
104+
105+
```bash
106+
git clone https://github.com/teamboostify/boostify.git
107+
cd boostify
108+
````
109+
110+
---
111+
112+
## 2. Install Dependencies
113+
114+
```bash
115+
npm install
116+
```
117+
118+
---
119+
120+
## 3. Configure Environment Variables
121+
122+
Create a `.env` file in the project root.
123+
124+
```env
125+
DEBUG=true
126+
127+
BOT_TOKEN=your_bot_token
128+
CLIENT_ID=
129+
GUILD_ID=
130+
131+
GREET_CHANNEL_ID=
132+
LOG_CHANNEL_ID=
133+
134+
DATABASE_URL=postgresql://user:password@localhost:5432/boostify
135+
```
136+
137+
> [!WARNING]
138+
> Never share your bot token or commit your `.env` file publicly.
139+
140+
---
141+
142+
# Database Setup
143+
144+
Generate the Prisma client:
145+
146+
```bash
147+
npx prisma generate
148+
```
149+
150+
Run migrations:
151+
152+
```bash
153+
npx prisma migrate deploy
154+
```
155+
156+
---
157+
158+
# Running Boostify
159+
160+
## Development
161+
162+
```bash
163+
npm run dev
164+
```
165+
166+
## Production
167+
168+
```bash
169+
npm run build
170+
npm start
171+
```
172+
173+
---
174+
175+
# Docker Deployment
176+
177+
Boostify supports Docker deployments out of the box.
178+
179+
## Build the Image
180+
181+
```bash
182+
docker build -t boostify .
183+
```
184+
185+
## Run the Container
186+
187+
```bash
188+
docker run -d \
189+
--name boostify \
190+
--env-file .env \
191+
boostify
192+
```
193+
194+
---
195+
196+
# Recommended Production Stack
197+
198+
For the best production experience, we recommend:
199+
200+
* Docker
201+
* PM2
202+
* Linux VPS
203+
* Managed PostgreSQL
204+
* Reverse Proxy (Nginx or Caddy)
205+
206+
---
207+
208+
# Features
209+
210+
* πŸš€ Boost Tracking
211+
* 🎁 Reward Roles
212+
* πŸ’¬ Auto Thank-You Messages
213+
* πŸ“Š Booster Analytics
214+
* πŸ›‘οΈ Moderation
215+
* πŸ“œ Logging
216+
* ⚑ Freemium Perks
217+
* 🐳 Docker Support
218+
* πŸ”§ Self Hosting
219+
* 🌐 Cloud Hosted Version
220+
221+
---
222+
223+
# Support
224+
225+
Need help?
226+
227+
* Join the support server: [https://discord.gg/vZgeWhZ9aF](https://discord.gg/vZgeWhZ9aF)
228+
* Open an issue on GitHub
229+
* Check the documentation
230+
231+
---
232+
233+
# Project Status
234+
235+
> [!NOTE]
236+
> Boostify is currently under active development.
237+
>
238+
> While the platform is stable for most use-cases, features may change and improve over time. If you encounter issues, please open an issue or join our support server.
239+
240+
---
241+
242+
<div align="center">
243+
Made with ❀️ by Team Boostify
244+
</div>

0 commit comments

Comments
Β (0)