feat(ux): improve sharing, filtering, pagination, and error recovery experience

[lishmanTech]

Summary

This PR improves the overall user experience by introducing reusable UI components and enhancing navigation, filtering, sharing, and error recovery throughout the application.

Changes

• Implemented branded referral sharing with reusable share components and support for the Web Share API.
• Added branded email templates for referral sharing and improved copy/share actions.
• Synchronized pagination state with URL query parameters (?page=N) to enable shareable links and preserve navigation state.
• Reorganized the FilterSidebar into logical, collapsible sections (Location, Price, Type, Size, and Advanced) for improved discoverability and usability.
• Added actionable error toasts with contextual Try Again and Learn More actions to provide clear recovery paths for users.
• Added/updated unit and integration tests to verify the new behaviors.
• Updated project documentation to reflect the new UX enhancements.

Benefits

• Improves discoverability of important filters.
• Makes pagination persistent and shareable.
• Provides a more polished referral sharing experience.
• Gives users clear recovery actions when errors occur.
• Introduces reusable UI components that can be leveraged across the application.

Closes

Closes #517

Closes #520

Closes #522

Closes #523

[drips-wave]

@lishmanTech 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

[nanaf6203-bit]

Solid UX pass — pagination, sharing, filters, and error recovery rolled into one. Thanks for the polish. Merging.