Skip to content

Fix/ui-ux refinements#28

Merged
jal-co merged 7 commits into
jal-co:mainfrom
KhaledSaeed18:fix/ui-ux-refinements
May 30, 2026
Merged

Fix/ui-ux refinements#28
jal-co merged 7 commits into
jal-co:mainfrom
KhaledSaeed18:fix/ui-ux-refinements

Conversation

@KhaledSaeed18

Copy link
Copy Markdown
Contributor

UI/UX Refinements and Responsiveness Improvements

Overview

This PR addresses UI/UX issues and responsiveness problems across the homepage, builder interface, and documentation site. The changes improve user experience on all device sizes and enhance code/content presentation throughout the platform.

Changes Summary

# Change Impact
1 TanStack Logo Icon Update Branding accuracy
2 Homepage Scroll Overflow Fix Layout stability
3 Builder Recommended Badge Responsiveness Mobile UX
4 Table Responsiveness Improvements Content readability
5 MDX Code Block Tab Indentation Code presentation
6 Migrate Middleware to Proxy Deprecation fix
7 Copy Button Touch Target Sizing Mobile accessibility

Detailed Changes

1. Update TanStack Logo Icon on Homepage

Commit: 8390b07
File Modified: www/public/logos/tanstack.svg

Description:
Replaced the outdated TanStack logo icon in the "Built on the best" section with a correct, up-to-date icon that accurately reflects TanStack's current branding.

Before vs. After:

Before After
image image

2. Resolve Homepage Scroll Overflow Issues

Commit: 706c49c
Files Modified: www/app/page.tsx

Description:
Fixed unwanted horizontal scroll overflow on the homepage hero section. Added overflow-x-clip to the hero section container to prevent content from extending beyond viewport boundaries.

Before vs. After:

Before After
bh ah

Impact:

  • Eliminates unwanted horizontal scrollbars
  • Improves perceived polish and professionalism

3. Improve Builder Responsiveness for Recommended Badge

Commit: 52778af
Files Modified: www/app/builder/builder.tsx

Description:
Enhanced the option card component layout to properly display the "Recommended" badge on mobile and tablet devices. The badge now wraps responsively without breaking the layout or overlapping content.

Before vs. After:

Before After
bb ba

4. Improve Table Responsiveness Across Site

Commit: 282cfbe
Files Modified: www/components/mdx-components.tsx

Description:
Added custom styled table components to handle responsiveness and improve readability of tables throughout the documentation and website. Tables now have proper overflow handling, better visual hierarchy, and improved spacing on all device sizes.

Before vs. After:

Before After
image image
Before (Mobile) After (Mobile)
image image

Benefits:

  • Tables remain readable on mobile devices
  • Smooth horizontal scrolling where needed
  • Improved visual hierarchy with proper styling
  • Consistent table appearance across all documentation

5. Correct Tab Indentation in MDX Code Blocks

Commit: bd8b271
Files Modified: www/app/docs/[[...slug]]/page.tsx

Description:
Fixed tab/indentation rendering issues on the first line of MDX code blocks and code command snippets. Removed conflicting prose styling that was interfering with proper tab display and indentation preservation.

Before vs. After:

Before After
image image
image image

6. Migrate Middleware to Proxy (Next.js 15+)

Commit: 3d7a8f6
Files Modified: www/proxy.ts (new), www/middleware.ts (deleted)

Description:
Migrated from the deprecated middleware.ts convention to the new proxy.ts convention in Next.js 15+.

Changes Made:

  • Renamed middleware.tsproxy.ts
  • Updated function export: middleware()proxy()
  • Code logic remains identical, no functional changes

Why This Matters:

  • Resolves deprecation warning in build
  • Aligns with Next.js 15+ best practices

7. Improve Copy Button Touch Target Sizing

Commit: 6d8d284
Files Modified: www/components/copy-button.tsx

Description:
Increased copy button padding from px-2 py-1 to px-2.5 py-1.5 to meet minimum mobile touch target accessibility standards (44x44px minimum).

Why:

  • Meets WCAG accessibility standards for touch targets
  • Easier to tap on mobile devices
  • Better user experience on all touch devices
  • Minimal visual impact while significantly improving usability

Impact:

  • Affects all copy buttons across the site (homepage, docs, code blocks)
  • No functional changes, purely UX improvement

Checklist

  • Homepage: Test scroll behavior on desktop and mobile
  • Builder Page: Test recommended badge layout on mobile (< 640px), tablet, and desktop
  • Documentation Tables: Verify tables scroll horizontally on mobile, readable on all sizes
  • Code Blocks: Check indentation is correct for all code examples in docs
  • Copy Buttons: Verify all copy buttons are easily tappable on mobile (touch target > 44px)
  • Proxy Configuration: Verify no build warnings about middleware deprecation

Replace outdated tanstack.svg with correct icon in "Built on the best" section
- Enhance horizontal scrolling on mobile
- Fix table header and cell alignment
- Improve overflow and padding handling
- Fix leading whitespace handling
- Ensure proper tab rendering in syntax highlighting
Increase copy button padding from px-2 py-1 to px-2.5 py-1.5 to meet
WCAG accessibility standards.

- Easier to tap on mobile devices
- Better UX on all touch devices
- Meets accessibility best practices
@vercel

vercel Bot commented May 30, 2026

Copy link
Copy Markdown

@KhaledSaeed18 is attempting to deploy a commit to the justinlevinedotme's projects Team on Vercel.

A member of the Team first needs to authorize it.

@jal-co

jal-co commented May 30, 2026

Copy link
Copy Markdown
Owner

Incredible work here. Thanks!

@vercel

vercel Bot commented May 30, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
scn-stack Ready Ready Preview, Comment May 30, 2026 10:16pm

Request Review

@jal-co jal-co merged commit 48b06ab into jal-co:main May 30, 2026
4 of 5 checks passed
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.

2 participants