Skip to content

fix: improve empty states and error messages - #467

Draft
thulasiramegowda wants to merge 4 commits into
AOSSIE-Org:mainfrom
thulasiramegowda:fix/ux-empty-state-and-error-messages
Draft

thulasiramegowda wants to merge 4 commits into
AOSSIE-Org:mainfrom
thulasiramegowda:fix/ux-empty-state-and-error-messages

Conversation

@thulasiramegowda

Copy link
Copy Markdown

Addressed Issues:

This PR addresses three existing usability issues in OrgExplorer:

  1. Error Handling: Raw HTTP 5xx error codes were displayed to users. Replaced them with clear, user-friendly error messages.
  2. Empty State Card: The title font size was 3rem, making it unnecessarily large. Reduced it to 1.75rem for better readability.
  3. Repository Filtering: Empty-state messages appeared only for text searches with no results. Updated the condition to handle all active filters when no repositories match.

Additional Notes:

These changes improve error communication, visual consistency, and the repository browsing experience.

Checklist

  • My code follows the project's code style and conventions.
  • I have made corresponding changes to the documentation.
  • My changes generate no new warnings or errors.
  • I have joined the [Discord server](https://discord.gg/hjUhu33uAn) and I will share a link to this PR with the project maintainers there.
  • I have read the [Contributing Guidelines](./CONTRIBUTING.md).

⚠️ AI Notice - Important!

I have reviewed the changes and understand the modifications included in this PR. I will ensure that the contribution meets the project's requirements and address any feedback from the maintainers.

The description paragraph was styled with a hardcoded hex colour (#D4C58A). This muted gold reads poorly against the light-mode background and bypasses the app's CSS variable theming system. Replace with the existing secondary-text token var(--text2), which resolves to #888888 in dark mode and #666666 in light mode, matching every other secondary text element in the codebase.
When explore() catches an unexpected HTTP error (e.g. 503, 422),
the raw error code such as HTTP_503 was displayed directly to the user.
Non-technical users have no way to interpret these codes or know what
action to take.

Any error message whose string starts with 'HTTP_' is now replaced with
'Something went wrong. Please check your connection and try again.'
Rate-limit and application-level errors continue to show their own
specific, actionable messages unchanged.
The h2 title inside EmptyStateCard used fontSize: '3rem' (~48px),
which was visually disproportionate within the 620px-wide card.
The oversized heading dominated the icon and description, breaking
the visual hierarchy of the empty-state design.

Reducing to 1.75rem restores a balanced and readable proportion
while keeping the title clearly visible as the primary element.
Previously showNoSearchResults was gated on search.trim(), so the
empty-state card only appeared when the text search box caused zero
results. If the user selected an Activity classification (e.g.
Hibernating) or a Language that matched no repositories, the table
silently rendered with zero rows and no explanation.

Removing the search.trim() guard makes the empty state trigger
whenever filtered.length === 0, regardless of which filter caused it.
The CTA button now resets all four filters (search, activity,
language, organisation) so the user can recover in one click.
The description and button label are updated to reflect this.
@coderabbitai

coderabbitai Bot commented Nov 16, 2026

Copy link
Copy Markdown

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@github-actions github-actions Bot added no-issue-linked PR has no linked issue frontend Frontend changes javascript JavaScript/TypeScript changes size/S 11-50 lines changed first-time-contributor First time contributor labels Nov 16, 2026
@github-actions github-actions Bot added size/S 11-50 lines changed and removed size/S 11-50 lines changed labels Nov 16, 2026
@gitcordapp

gitcordapp Bot commented Nov 16, 2026

Copy link
Copy Markdown

Link your account with Gitcord

Thanks for opening this PR, @thulasiramegowda!

To receive Discord notifications and contributor tracking for this organization:

  1. Join Discord: https://discord.gg/hjUhu33uAn
  2. In Discord, run /link thulasiramegowda
  3. Paste the verification code into your GitHub bio (or a public gist)
  4. Click Verify in Discord (or run /verify-link thulasiramegowda)

Once linked, Gitcord can notify you about reviews, merges, and more.

— Posted by Gitcord

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

first-time-contributor First time contributor frontend Frontend changes javascript JavaScript/TypeScript changes no-issue-linked PR has no linked issue size/S 11-50 lines changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant