json-schema-org / json-schema-org/website
🐛 Bug: Improve Bowtie Compliance Fetch UX (Loading State, Error Handling, Retry Support)
Nobody has claimed this yet.
- Dominant language
- HTML
- Stars
- 169
- Forks
- 484
- Avg merge
- 2d 2h
- Merged PRs (30d)
- 6
Description
Describe the bug
The ToolingTable component fetches Bowtie compliance data from:
https://bowtie.report/api/v1/json-schema-org/implementations
Currently, when the request is slow or fails:
- Users receive no clear loading feedback
- Errors are not surfaced in the UI
- There is no retry mechanism
- Accessibility feedback for async updates is limited
This can create confusion when the Bowtie API is temporarily unavailable or slow.
Steps To Reproduce
- Open the JSON Schema website.
- Navigate to the Tooling page.
- Open DevTools → Network tab.
- Simulate a slow network (e.g., "Slow 3G") OR block the request to:
https://bowtie.report/api/v1/json-schema-org/implementations - Refresh the page.
Current Behavior:
- No visible loading indicator while Bowtie data is being fetched.
- If the request fails (e.g., 404 / network error), the UI does not clearly indicate the failure.
- Users cannot retry fetching Bowtie data without reloading the entire page.
- The Bowtie column may appear empty without explanation.
Expected Behavior
- A loading indicator should appear while fetching Bowtie compliance data.
- If the fetch fails, a visible error message should be shown.
- A retry button should allow re-fetching without reloading the page.
- The UI should provide accessible feedback for screen readers.
Screenshots
No response
Device Information [optional]
- OS:
- Browser:
- version:
Are you working on this issue?
Yes
Do you think this work might require an [Architectural Decision Record (ADR)]? (significant or noteworthy)
No
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start at the ToolingTable component and trace its request to https://bowtie.report/api/v1/json-schema-org/implementations. Check the slow, failed, and successful fetch states, then verify that loading and error feedback are visible, retry works without a page reload, and asynchronous updates are announced accessibly.
Written by the indexing model from the issue text.
Assessment
- Domain
- accessibility, frontend
- Issue type
- Bug
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100