Skip to content

feat(frontend): add skeleton loading states to all data-heavy pages - #515

Merged
KuchiMercy merged 1 commit into
StayLitCodes:mainfrom
CJay-Cipher:feat/skeleton-loading-states
Jul 30, 2026
Merged

feat(frontend): add skeleton loading states to all data-heavy pages#515
KuchiMercy merged 1 commit into
StayLitCodes:mainfrom
CJay-Cipher:feat/skeleton-loading-states

Conversation

@CJay-Cipher

Copy link
Copy Markdown
Contributor

Description

Resolves inconsistent loading states across the app where some pages showed
blank content and others showed a generic spinner while data was fetching.
This PR introduces unified skeleton loading states across all data-heavy pages,
matching the shape and layout of the actual content they replace.

Notification page skeleton loading state

Screenshot 2026-07-30 112923

Related Issue

Closes #478

Type of Change

  • New feature (non-breaking change which adds functionality)

Changes Made

New Skeleton Components (apps/frontend/components/ui/)

  • TransactionTableSkeleton.tsx — Mimics the summary cards + 8-row
    table layout of the Transactions page
  • NotificationListSkeleton.tsx — Mimics the notification list items
    with avatar, title, body, and timestamp placeholders
  • AdminOverviewSkeleton.tsx — Mimics the stat cards grid, bar chart,
    role distribution panel, and activity feed of the Admin Overview page
  • AdminTableSkeleton.tsx — Reusable skeleton for admin table pages;
    renders filter pills, desktop table rows, and mobile card fallbacks
  • AdminDisputesSkeleton.tsx — Mimics the split-panel dispute layout
    with list on the left and detail + resolution form on the right

Pages Updated

Page File Before After
Dashboard app/dashboard/page.tsx Plain "Loading Dashboard..." text EscrowCardSkeleton + ActivityFeedSkeleton in Suspense fallback
Transactions app/transactions/page.tsx Loader2 spinner TransactionTableSkeleton
Notifications app/notifications/page.tsx Spinner + "Fetching event feed..." text NotificationListSkeleton
Admin Overview app/admin/page.tsx Loader2 spinner AdminOverviewSkeleton
Admin Escrows app/admin/escrows/page.tsx Loader2 spinner AdminTableSkeleton
Admin Disputes app/admin/disputes/page.tsx Loader2 spinner AdminDisputesSkeleton
Escrow Detail app/escrow/[id]/page.tsx ✅ Already using EscrowDetailSkeleton No change needed

No Changes Needed

The following already had correct skeleton implementations:

  • components/dashboard/EscrowList.tsx — already uses EscrowCardSkeleton
  • components/common/ActivityFeed.tsx — already uses ActivityFeedSkeleton
  • app/escrow/[id]/page.tsx — already uses EscrowDetailSkeleton

Testing Done

  • Manually tested all 6 updated pages with Chrome DevTools Network
    throttled to Slow 3G to force skeleton visibility
  • Verified skeletons match the shape and column count of actual content
  • Verified no flash of empty/blank content before data loads
  • Confirmed existing skeleton implementations still work correctly
  • No TypeScript or lint errors

Checklist

  • My code follows the project's coding standards
  • I have run lint and tests locally
  • I have updated documentation as needed
  • I have read the CONTRIBUTING.md file
  • Skeletons are visually consistent across the app
  • Skeletons match the shape of actual content
  • No flash of empty content before data loads
  • All data-heavy pages now show skeleton loading states

- Create TransactionTableSkeleton for transactions page
- Create NotificationListSkeleton for notifications page
- Create AdminOverviewSkeleton for admin overview page
- Create AdminTableSkeleton for admin escrows page
- Create AdminDisputesSkeleton for admin disputes page
- Replace Suspense fallback on dashboard with EscrowCardSkeleton
- Replace all Loader2 spinners with matching skeleton components
- Skeletons match layout shape of actual content

Closes StayLitCodes#478
@drips-wave

drips-wave Bot commented Jul 30, 2026

Copy link
Copy Markdown

@CJay-Cipher Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

@KuchiMercy
KuchiMercy merged commit f16adcd into StayLitCodes:main Jul 30, 2026
1 check passed
@CJay-Cipher
CJay-Cipher deleted the feat/skeleton-loading-states branch July 30, 2026 10:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat(frontend): Add loading skeleton states to all data-heavy pages

2 participants