feat: add collapsible server grouping with drag-and-drop and dashboard group filter by itzzjustmateo · Pull Request #102 · BlueprintFramework/hydrodactyl

itzzjustmateo · 2026-08-24T19:09:16Z

Summary

This PR adds server grouping to the Hydrodactyl client dashboard, letting users organize their servers into collapsible, user-owned groups and manage them with drag-and-drop. It sits on top of BlueprintFramework/hydrodactyl and changes the following:

Server Groups (data + API)

New server_groups table and a group_id foreign key on the servers table (requires php artisan migrate).
Group CRUD via ServerGroupController: create, rename, delete, and reorder.
Groups are scoped per user; each server belongs to at most one group.

Dashboard UX

Collapsible group sections on the dashboard.
Drag-and-drop servers between groups and to an "Ungrouped" section, in both list and grid views.
Group filter in the dashboard header to narrow the view to a selected group.
Dashboard header restructured into a 3-column layout (left / center / right slots).
Error boundary restyled to match the 404 page.

Dev environment

docker-compose.develop.yml: Garage replaces MinIO for S3-compatible storage.
Dev daemon swapped from the Elytra fork to vanilla Pterodactyl Wings (nodes.daemon_type now defaults to wings).

Notes

Pagination has not been tested yet. I cannot seed/create even more servers on my local PC

Related Issues

#101

IMPORTANT

If this PR is merged and deployed to production, existing Hydrodactyl installations must run:

php artisan migrate

This adds the server_groups table and the group_id column used for server grouping.

Updated the security policy to clarify reporting procedures and disclosure process.

…d 3-column header layout - Add server_groups table and server group_id foreign key (one group per server) - Create ServerGroup CRUD API (create, update, delete, add/remove servers, reorder groups) - Add group filter and sort to dashboard server list - Add group view mode with collapsible sections and drag-and-drop - Add group dropdown filter in header - Restructure header into 3-column layout (left actions | centered search | right actions) - Add HeaderContext left/center/right slot support (backward-compatible) - Improve ErrorBoundary styling to match 404 page - Fix CreateGroupModal crash (was using FormikFieldWrapper outside Formik context) - Swap MinIO for Garage in docker-compose.develop.yml - Remove p:user:make from devSetup.sh (use UI wizard instead) Note: untested with actual servers running — cannot verify end-to-end locally.

itzzjustmateo · 2026-08-24T19:11:38Z

I gotta fix a filter issue, if I filter to only see 1 group, nothing happens, but tmrw

itzzjustmateo · 2026-08-24T19:14:25Z

task for tmrw
haha lol

itzzjustmateo · 2026-08-25T14:29:17Z

currently testing with real servers locally

- Add groups enabled toggle to Admin > Advanced Settings - Add config key pterodactyl.client_features.groups.enabled (default: true) - Add validation rule for the new setting - Register DB override key in SettingsServiceProvider - Return groups_enabled flag from filterOptions API - Conditionally show/hide group UI (tab, dropdown, mode) based on setting - Add backend guards on all ServerGroupController endpoints - Fix icon import: MoreVertical -> EllipsisVertical

- Use SWR global mutate to revalidate server list after group operations - Drag-and-drop now instantly moves server between groups in the UI - Delete group now instantly ungroups servers in the UI - Fix node daemon token encryption (root cause of 500 errors)

- More spacing between groups (space-y-6) - Drag-and-drop to ungrouped section with visual drop indicator - Groups always visible (empty groups show placeholder text) - Ungrouped section always visible (dashed border drop zone) - Collapsed chevron indicator on folder icon - Cleaner header with uppercase tracking-wider labels - Subtle hover states on group cards - Accent glow shadow on drag-over - Better empty state with icon container - Server count badges on group and ungrouped headers

- Lifted Pagination to wrap all views (groups, list, grid) once - GroupDropdown now uses gravity-ui Folder icon (matches other header dropdowns) - Removed redundant per-view Pagination wrappers

- Replaced all #ffffff border/background references with cream-500/cream-400 tokens - Increased vertical spacing between all sections (space-y-6 → space-y-8) - Added mt-2 gap between grouped cards and ungrouped drop zone - Renamed dialog label uses cream-400/50 instead of white

itzzjustmateo · 2026-08-25T19:21:07Z

gonna improve the UI tmrw

A53o · 2026-08-28T19:54:16Z

No rush, just wondering if there's any updates on this?

itzzjustmateo · 2026-08-29T08:00:37Z

oh yeah! it's kinda done, I forgot to continue haha

…iew/topbar Replace the undefined accent drop-highlights with cream/mocha tokens, add a custom cream-styled floating drag preview via setDragImage, and extract a reusable DraggableServer component to match codebase conventions. Make the group view and dashboard topbar resilient at all screen sizes.

…e group modals - Collapse the entity/group/sort filter dropdowns into a 'Filters' hamburger menu (FiltersMenu) below lg so the navbar no longer overlaps at half-width; revert the overflow-x-auto fallback in AppHeader. - Remove the colored glow on drag targets, replacing it with a cream ring + tint; dim the source row while dragging. - Increase spacing between groups and the ungrouped zone. - Rebuild rename/delete modals using Dialog.Icon + Dialog.Footer: rename gets an info icon, Enter-to-save, and a disabled-until-changed Save button; delete gets a danger icon and states how many servers will become ungrouped with a destructive Delete button.

- Lazy-load every route-level page container (DashboardContainer, ServerConsoleContainer, account/server screens) so each is its own on-demand chunk. - Fix the rolldown codeSplitting grouping: under pnpm all deps collapsed into one 3.4 MB .pnpm chunk. The name function now extracts the real package name for npm, pnpm, and scoped packages (e.g. @hugeicons/core-free-icons). - Resolves the 'chunks larger than 500 kB' build warning; largest chunk is now ~287 kB (@xterm/xterm).

- Bump intra-group server list spacing from space-y-1.5 to space-y-3. - Bump spacing between groups from space-y-8/sm:space-y-12 to space-y-12/sm:space-y-16.

…awer

itzzjustmateo · 2026-08-29T09:33:40Z

Almost done, fixing some bugs and improving it abit =D

…o aweful, while testing the grouping feature

…g groups tab

itzzjustmateo · 2026-08-29T10:20:47Z

Fixing the last bug =D

…ips when groups disabled

…tra for vanilla Wings (daemon=wings)

itzzjustmateo · 2026-08-29T10:58:31Z

I hate the logo, why did I need to break it 😭

…uttons show not-allowed cursor

itzzjustmateo · 2026-08-29T11:06:03Z

Can be reviewed and merged =D If there are any issues, just tell me

naterfute · 2026-09-05T03:25:11Z

itzzjustmateo · 2026-09-05T07:12:26Z

What's about it? @naterfute

A53o · 2026-09-05T10:13:57Z

The logo I think

itzzjustmateo · 2026-09-05T10:47:05Z

ooh that, yeah I somehow broke it again, and could not fix it.. uhm..

Blueberryboom · 2026-09-05T14:34:42Z

ooh that, yeah I somehow broke it again, and could not fix it.. uhm..

How dare you break my beloved centred logo 😭

itzzjustmateo · 2026-09-05T16:19:51Z

ooh that, yeah I somehow broke it again, and could not fix it.. uhm..

How dare you break my beloved centred logo 😭

I am so sorry bro 😭🙏 I already tried everything fixing it, how did you fix it?

itzzjustmateo and others added 14 commits August 9, 2026 21:07

docs(readme): rewrite

efdda58

docs(license_ptero): rename

93fd391

docs(security): rewrite

1bd4560

Updated the security policy to clarify reporting procedures and disclosure process.

docs(todo): rewrite

6d3ea2e

Merge branch 'BlueprintFramework:main' into main

8a8884d

docs(dev): rewrite

3c550a8

docs(contributing): rewrite

475b9c1

docs(changelog): rewrite

e7f1e46

docs(code_of_conduct): rewrite

2522e11

docs(todo): rewrite

3e6c8e5

docs: uncheck option

694a6ac

docs(readme): reflect latest release

970e83e

Merge branch 'BlueprintFramework:main' into main

6a03e7f

ci: hopefully fix linting

4d05eb5

itzzjustmateo added 2 commits August 25, 2026 16:03

fix: biome lint errors, unused imports, formatting, and a11y

d25b9c5

fix: add pagination to group view

499ae0a

itzzjustmateo added 3 commits August 25, 2026 20:56

itzzjustmateo marked this pull request as draft August 25, 2026 19:12

itzzjustmateo added 2 commits August 25, 2026 21:14

feat: global pagination + consistent group dropdown

19de043

- Lifted Pagination to wrap all views (groups, list, grid) once - GroupDropdown now uses gravity-ui Folder icon (matches other header dropdowns) - Removed redundant per-view Pagination wrappers

itzzjustmateo marked this pull request as ready for review August 29, 2026 08:02

itzzjustmateo added 5 commits August 29, 2026 10:13

style: increase spacing between servers in a group and between groups

ac52057

- Bump intra-group server list spacing from space-y-1.5 to space-y-3. - Bump spacing between groups from space-y-8/sm:space-y-12 to space-y-12/sm:space-y-16.

feat: animate group fly-in/collapse, widen search, animate sidebar dr…

f76e2ec

…awer

itzzjustmateo added 5 commits August 29, 2026 11:51

fix: respect group filter in GroupSection and clean a11y suppression

2f326c2

fix: login page had weird black borders, which i just thought it is s…

2c7a46a

…o aweful, while testing the grouping feature

fix: undefined index in GroupSection group-card stagger delay crashin…

6459da2

…g groups tab

fix: hide group chip in groups view and define accent theme tokens

efda697

feat: group description support, rename->Edit, and readable group chip

a98dd70

fix: minimized logo centering, CPU normalize-by-core+tooltip, hide ch…

f719d4c

…ips when groups disabled

itzzjustmateo force-pushed the feat/server-grouping branch from 41e663a to f719d4c Compare August 29, 2026 10:40

fix: flex-center minimized logo, admin CPU shows cores only, swap Ely…

e5869cf

…tra for vanilla Wings (daemon=wings)

fix: enable Edit-Group save when only description changes; disabled b…

ff5210b

…uttons show not-allowed cursor

itzzjustmateo changed the title ~~feat: server grouping with drag-and-drop~~ feat: add collapsible server grouping with drag-and-drop and dashboard group filter Aug 29, 2026

fix(docker): disable auto-startup for develop

930d580

Uh oh!

Uh oh!

Conversation

itzzjustmateo commented Aug 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Server Groups (data + API)

Dashboard UX

Dev environment

Notes

Related Issues

IMPORTANT

Uh oh!

itzzjustmateo commented Aug 24, 2026

Uh oh!

itzzjustmateo commented Aug 24, 2026

Uh oh!

itzzjustmateo commented Aug 25, 2026

Uh oh!

itzzjustmateo commented Aug 25, 2026

Uh oh!

A53o commented Aug 28, 2026

Uh oh!

itzzjustmateo commented Aug 29, 2026

Uh oh!

itzzjustmateo commented Aug 29, 2026

Uh oh!

itzzjustmateo commented Aug 29, 2026

Uh oh!

itzzjustmateo commented Aug 29, 2026

Uh oh!

itzzjustmateo commented Aug 29, 2026

Uh oh!

naterfute commented Sep 5, 2026

Uh oh!

itzzjustmateo commented Sep 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

A53o commented Sep 5, 2026

Uh oh!

itzzjustmateo commented Sep 5, 2026

Uh oh!

Blueberryboom commented Sep 5, 2026

Uh oh!

itzzjustmateo commented Sep 5, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

itzzjustmateo commented Aug 24, 2026 •

edited

Loading

itzzjustmateo commented Sep 5, 2026 •

edited

Loading