Skip to content

Add search and filter controls to the admin member list #323

Description

@Lakes41

Difficulty: Intermediate
Type: feature

Background
The admin dashboard's member list surface (backed by GET /v1/members, which returns all member rows per the README's Live API endpoints table) is one of the MVP admin features.

Problem
Since GET /v1/members returns the full list with no server-side filtering, the admin UI currently has no client-side way to search by wallet/name or filter by role/tier, making the list unwieldy for communities with many members.

Expected outcome
The admin member list page includes a search input (matches wallet address/name) and filter dropdowns (role, tier), all applied client-side against the fetched /v1/members data, with results updating instantly as filters change.

Suggested implementation

  • Add a client component wrapping the member list with local filter state (search text, role, tier).
  • Add a debounced search input and filter dropdowns above the table.
  • Ensure the mock API (lib/api/mock.ts) seed data includes enough variety (multiple roles/tiers) to meaningfully exercise the filters in mock mode.
  • Add an empty-state message when filters return no matches.

Acceptance criteria

  • Search matches partial wallet address or name
  • Role and tier filters combine correctly with search
  • Works correctly in both mock mode and against a live guildpass-core backend
  • Empty state displayed when no members match

Likely affected files/directories

  • app/admin/ (member list page)
  • lib/api/mock.ts
  • components/

Metadata

Metadata

Assignees

Labels

GrantFox OSSGrantFox Open Source Sponsorship program tagMaybe RewardedIssue may qualify for a reward upon successful completion per campaign rulesOfficial Campaign | FWC26Official FWC26 campaign issue — eligible for campaign scoring and rewardsfeatureNew feature, enhancement, or functional additionintermediateIntermediate difficulty tasks requiring solid experience and some context

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions