docs: update README and command documentation

Author: lkaesberg

README.md

@@ -74,11 +74,22 @@ Use this link to invite the bot to your server:
 ### Quick Setup
 
 1. **Invite the bot** using the link above
-2. **Set the verified role**: `/role verified @YourVerifiedRole`
+2. **Add a default role**: `/role add @Verified` (given to all verified users)
 3. **Add allowed domains**: `/domain add @university.edu` (use `@*.edu` for all .edu domains)
 4. **Create a verification button**: `/button #verification-channel "Click to Verify"`
 5. Done! Users can now verify themselves
 
+### Advanced: Domain-Specific Roles
+
+You can assign different roles based on which email domain the user verifies with:
+
+```
+/domainrole add domain:@staff.company.com role:@Staff
+/domainrole add domain:@*.edu role:@Student
+```
+
+Users will receive their domain-specific roles **plus** any default roles you've configured.
+
 ---
 
 ## 📝 Commands
@@ -94,9 +105,24 @@ Use this link to invite the bot to your server:
 
 | Command | Description |
 |---------|-------------|
-| `/role verified [role]` | Set or view the role given after verification |
+| `/role add <role>` | Add a default role given to all verified users |
+| `/role remove <role>` | Remove a role from the default roles list |
+| `/role list` | View all default roles |
 | `/role unverified [role]` | Set or view the optional role for unverified members |
 
+### 🎭 Domain-Specific Roles
+
+Assign different roles based on email domain:
+
+| Command | Description |
+|---------|-------------|
+| `/domainrole add <domain> <role>` | Add a role for a specific email domain |
+| `/domainrole remove <domain> <role>` | Remove a role from a domain |
+| `/domainrole list` | View all domain-role mappings |
+| `/domainrole clear <domain>` | Remove all roles for a domain |
+
+> 💡 **Example:** `/domainrole add @*.edu @Student` gives the Student role to anyone with a .edu email
+
 ### 📧 Domain Management
 
 | Command | Description |

docs/commands.md

@@ -19,11 +19,38 @@ The following commands require administrator permissions.
 
 Configure which roles are assigned during the verification process.
 
+#### Default Roles
+
+Default roles are given to **all** verified users, regardless of their email domain.
+
 | Command | Description |
 |---------|-------------|
-| `/role verified [role]` | Set or view the role given to users after successful verification |
+| `/role add <role>` | Add a role to the default roles list |
+| `/role remove <role>` | Remove a role from the default roles list |
+| `/role list` | View all configured default roles |
 | `/role unverified [role]` | Set or view the optional role for unverified members (select current role to disable) |
 
+#### Domain-Specific Roles
+
+Assign different roles based on which email domain the user verifies with. Users receive their domain-specific roles **plus** any default roles.
+
+| Command | Description |
+|---------|-------------|
+| `/domainrole add <domain> <role>` | Add a role for a specific email domain |
+| `/domainrole remove <domain> <role>` | Remove a role from a specific domain |
+| `/domainrole list` | View all domain-role mappings |
+| `/domainrole clear <domain>` | Remove all roles for a specific domain |
+
+#### Domain Role Examples
+
+| Setup | Result |
+|-------|--------|
+| Default: `@Member`<br>Domain: `@*.edu` → `@Student` | User with `@stanford.edu` gets: `@Student`, `@Member` |
+| Default: `@Verified`<br>Domain: `@company.com` → `@Employee`, `@Staff` | User with `@company.com` gets: `@Employee`, `@Staff`, `@Verified` |
+| Domain: `@*.harvard.edu` → `@Harvard`<br>Domain: `@*.edu` → `@Student` | User with `@cs.harvard.edu` gets: `@Harvard`, `@Student` (all matching patterns) |
+
+> 💡 **Tip:** When using `/domainrole add`, the domain field autocompletes with your configured domains from `/domain add`.
+
 ### 📧 Domain Management
 
 Control which email domains are allowed for verification.
@@ -120,3 +147,15 @@ The unverified role can be used to:
 - Make a verification channel visible only to unverified users
 - Restrict access to most channels until users verify
 - Combined with `/settings auto-unverified`, automatically restrict new members
+
+### Role Display in Verification
+
+When domain-specific roles are configured, the verification modal shows users which roles they will receive:
+
+```
+Accepted domains:
+1. @*.edu → Student, Member
+2. @company.com → Employee, Member
+```
+
+This helps users understand what access they'll get before verifying.

src/commands/help.js

@@ -17,17 +17,28 @@ module.exports = {
                 {
                     name: '🚀 Quick Setup (4 Steps)',
                     value: 
-                        '**1.** `/role verified <role>` - Set the role for verified users\n' +
+                        '**1.** `/role add <role>` - Add a default role for verified users\n' +
                         '**2.** `/domain add <domains>` - Add allowed email domains\n' +
                         '**3.** `/button <channel>` - Create verification embed\n' +
                         '**4.** `/status` - Verify everything is configured'
                 },
                 {
                     name: '👥 Role Configuration',
                     value:
-                        '`/role verified` - Set/view role given after verification\n' +
+                        '`/role add` - Add a default role (given to all verified users)\n' +
+                        '`/role remove` - Remove a default role\n' +
+                        '`/role list` - View all default roles\n' +
                         '`/role unverified` - Set/view optional role for unverified members'
                 },
+                {
+                    name: '🎭 Domain-Specific Roles',
+                    value:
+                        '`/domainrole add` - Assign roles for specific email domains\n' +
+                        '`/domainrole remove` - Remove a role from a domain\n' +
+                        '`/domainrole list` - View all domain-role mappings\n' +
+                        '`/domainrole clear` - Remove all roles for a domain\n' +
+                        '*Users get domain roles + default roles on verification*'
+                },
                 {
                     name: '📧 Domain Management',
                     value: