lists page mobile responsiveness

[russbiggs]

The list page does not render well on mobile screen sizes. additional styling is required to improve the user interface:

[chrisdebian]

Not at all my area of expertise, but this is one (AI) approach:

Mobile Responsiveness Fix Guide for OpenAQ Explorer Lists Page

Issue Overview

GitHub Issue: #46 - lists page mobile responsiveness
Affected Area: Lists page on explore.openaq.org
Tech Stack: SolidJS (Solid Start), Deployed on AWS Lambda/S3/CloudFront

---

Common Mobile Responsiveness Issues & Solutions

1. Viewport Configuration

Problem: Site not scaling properly on mobile devices

Check:

<!-- Ensure this meta tag exists in your HTML head -->
<meta name="viewport" content="width=device-width, initial-scale=1.0">

Location to check: Look in src/root.tsx or main HTML template

---

2. Fixed Width Elements

Problem: Elements with fixed pixel widths cause horizontal scrolling

Common culprits on list pages:

• List containers
• Table cells
• Card components
• Filter panels
• Sidebar elements

Solution:

/* Instead of fixed widths */
.list-container {
  width: 800px; /* ❌ Bad */
}

/* Use responsive widths */
.list-container {
  width: 100%; /* ✅ Good */
  max-width: 800px;
  padding: 0 1rem; /* Add padding for mobile */
}

/* Or use CSS Grid/Flexbox */
.list-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
  gap: 1rem;
}

---

3. Table Responsiveness

Problem: Data tables often break on mobile due to too many columns

Solutions:

Option A: Horizontal Scroll with Shadow Indicators

.table-wrapper {
  overflow-x: auto;
  -webkit-overflow-scrolling: touch;
  width: 100%;
}

@media (max-width: 768px) {
  .table-wrapper {
    /* Add shadow to indicate scrollability */
    background: 
      linear-gradient(90deg, white 30%, transparent),
      linear-gradient(-90deg, white 30%, transparent),
      linear-gradient(90deg, rgba(0,0,0,.1), transparent),
      linear-gradient(-90deg, rgba(0,0,0,.1), transparent);
    background-repeat: no-repeat;
    background-size: 40px 100%, 40px 100%, 14px 100%, 14px 100%;
    background-position: 0 0, 100% 0, 0 0, 100% 0;
    background-attachment: local, local, scroll, scroll;
  }
}

Option B: Convert to Card Layout on Mobile

// SolidJS example
<Show
  when={window.innerWidth > 768}
  fallback={<MobileCardList items={locations()} />}
>
  <DesktopTable items={locations()} />
</Show>

/* Mobile card styling */
@media (max-width: 768px) {
  .location-item {
    display: block;
    padding: 1rem;
    border: 1px solid #ddd;
    border-radius: 8px;
    margin-bottom: 1rem;
  }
  
  .location-item__label {
    font-weight: bold;
    display: inline-block;
    min-width: 100px;
  }
}

---

4. Navigation and Sidebar Issues

Problem: Side navigation pushes content off-screen on mobile

Solution:

/* Mobile-first navigation */
.sidebar {
  position: fixed;
  left: -280px;
  top: 0;
  width: 280px;
  height: 100vh;
  transition: left 0.3s ease;
  z-index: 1000;
}

.sidebar.open {
  left: 0;
}

/* Hamburger menu for mobile */
.mobile-menu-toggle {
  display: block;
  position: fixed;
  top: 1rem;
  left: 1rem;
  z-index: 1001;
}

@media (min-width: 769px) {
  .sidebar {
    position: relative;
    left: 0;
  }
  
  .mobile-menu-toggle {
    display: none;
  }
}

---

5. Touch Target Sizes

Problem: Buttons and interactive elements too small for touch

Solution:

/* Ensure minimum 44x44px touch targets (WCAG guideline) */
.btn, .link, .checkbox-label {
  min-height: 44px;
  min-width: 44px;
  padding: 0.75rem 1rem;
  display: inline-flex;
  align-items: center;
  justify-content: center;
}

/* Increase spacing between interactive elements */
@media (max-width: 768px) {
  .action-buttons {
    display: flex;
    flex-direction: column;
    gap: 0.75rem;
  }
  
  .action-buttons > * {
    width: 100%;
  }
}

---

6. Text Sizing and Readability

Problem: Text too small to read on mobile

Solution:

/* Use relative units */
body {
  font-size: 16px; /* Base size for good mobile readability */
}

h1 {
  font-size: clamp(1.5rem, 5vw, 2.5rem);
}

p {
  font-size: clamp(0.875rem, 2vw, 1rem);
  line-height: 1.6;
}

/* Prevent text from being too small */
@media (max-width: 768px) {
  .small-text {
    font-size: 0.875rem; /* Never smaller than 14px */
  }
}

---

7. Map Integration Issues

Problem: Maps not responsive or controls obscured

Solution:

.map-container {
  width: 100%;
  height: 400px;
  position: relative;
}

@media (max-width: 768px) {
  .map-container {
    height: 300px; /* Adjust for mobile */
  }
  
  /* Reposition map controls */
  .map-controls {
    top: 10px;
    right: 10px;
    left: auto;
  }
}

---

8. List Filtering on Mobile

Problem: Filter panels take up too much screen space

Solution:

// Create collapsible filter panel
function MobileFilters() {
  const [isOpen, setIsOpen] = createSignal(false);
  
  return (
    <div class="mobile-filters">
      <button 
        class="filter-toggle"
        onClick={() => setIsOpen(!isOpen())}
      >
        Filters {isOpen() ? '▲' : '▼'}
      </button>
      
      <Show when={isOpen()}>
        <div class="filter-panel">
          {/* Filter controls */}
        </div>
      </Show>
    </div>
  );
}

@media (max-width: 768px) {
  .filter-toggle {
    width: 100%;
    padding: 1rem;
    background: #f5f5f5;
    border: none;
    font-size: 1rem;
    text-align: left;
    cursor: pointer;
  }
  
  .filter-panel {
    padding: 1rem;
    background: white;
  }
}

---

Debugging Steps

Step 1: Set Up Mobile Testing Environment

Browser DevTools:

1. Open Chrome/Firefox DevTools (F12)
2. Click device toolbar icon (Ctrl+Shift+M)
3. Test various device presets (iPhone, iPad, Android)
4. Test both portrait and landscape orientations

Real Device Testing:

# Use ngrok to test on real mobile devices
npm install -g ngrok
npm run dev  # Start your dev server on port 3000
ngrok http 3000  # Get public URL for mobile testing

Step 2: Identify Problem Areas

Run Lighthouse Mobile Audit:

1. Open Chrome DevTools
2. Go to Lighthouse tab
3. Select "Mobile" device
4. Run audit
5. Review "Viewport" and "Touch targets" sections

Check Console for Errors:

// Add mobile-specific debugging
if (window.innerWidth < 768) {
  console.log('Mobile viewport detected:', {
    width: window.innerWidth,
    height: window.innerHeight,
    devicePixelRatio: window.devicePixelRatio
  });
}

Step 3: Test Specific Scenarios

Lists Page Testing Checklist:

• List items display without horizontal scroll
• All interactive elements are easily tappable
• Filters are accessible and functional
• Search/sort controls work properly
• Modal dialogs fit on screen
• Forms are usable without zooming
• Performance is acceptable (< 3s load time)

---

Implementation Plan for Issue #46

Phase 1: Assessment (Week 1)

Tasks:

1. Review current Lists page implementation
2. Test on multiple mobile devices (iOS & Android)
3. Document all responsive issues found
4. Prioritize issues by severity

Deliverable: Issue report with screenshots

Phase 2: Quick Wins (Week 2)

Tasks:

1. Add/fix viewport meta tag
2. Fix any overflow issues (horizontal scrolling)
3. Increase touch target sizes
4. Adjust font sizes for readability

Deliverable: PR with basic mobile fixes

Phase 3: Layout Improvements (Week 3-4)

Tasks:

1. Implement responsive breakpoints
2. Convert tables to cards on mobile (if needed)
3. Make filters collapsible on mobile
4. Optimize navigation for small screens

Deliverable: PR with layout improvements

Phase 4: Testing & Polish (Week 5)

Tasks:

1. Cross-browser/device testing
2. Performance optimization
3. Accessibility review (WCAG AA)
4. User acceptance testing

Deliverable: Production-ready mobile experience

---

Code Examples for OpenAQ Explorer

Since OpenAQ Explorer uses SolidJS, here are framework-specific examples:

Responsive List Component

// src/components/LocationList.tsx
import { For, Show, createSignal } from 'solid-js';
import { createMediaQuery } from '@solid-primitives/media';

export function LocationList(props: { locations: Location[] }) {
  const isMobile = createMediaQuery('(max-width: 768px)');
  
  return (
    <div class="location-list">
      <Show
        when={!isMobile()}
        fallback={<MobileLocationCards locations={props.locations} />}
      >
        <DesktopLocationTable locations={props.locations} />
      </Show>
    </div>
  );
}

function MobileLocationCards(props: { locations: Location[] }) {
  return (
    <div class="mobile-cards">
      <For each={props.locations}>
        {(location) => (
          <div class="location-card">
            <h3>{location.name}</h3>
            <div class="location-meta">
              <span class="label">Country:</span>
              <span class="value">{location.country}</span>
            </div>
            <div class="location-meta">
              <span class="label">Measurements:</span>
              <span class="value">{location.measurements}</span>
            </div>
            <button class="view-details">View Details</button>
          </div>
        )}
      </For>
    </div>
  );
}

Responsive Filter Panel

// src/components/FilterPanel.tsx
import { createSignal, Show } from 'solid-js';
import { createMediaQuery } from '@solid-primitives/media';

export function FilterPanel(props) {
  const isMobile = createMediaQuery('(max-width: 768px)');
  const [isOpen, setIsOpen] = createSignal(false);
  
  return (
    <div class="filter-panel">
      <Show when={isMobile()}>
        <button 
          class="filter-toggle"
          onClick={() => setIsOpen(!isOpen())}
        >
          <span>Filters</span>
          <span>{isOpen() ? '▲' : '▼'}</span>
        </button>
      </Show>
      
      <Show when={!isMobile() || isOpen()}>
        <div class="filter-content">
          {props.children}
        </div>
      </Show>
    </div>
  );
}

Corresponding CSS

/* src/styles/responsive.css */

/* Mobile-first base styles */
.location-list {
  width: 100%;
  padding: 1rem;
}

.mobile-cards {
  display: flex;
  flex-direction: column;
  gap: 1rem;
}

.location-card {
  background: white;
  border: 1px solid #e0e0e0;
  border-radius: 8px;
  padding: 1rem;
  box-shadow: 0 2px 4px rgba(0,0,0,0.1);
}

.location-card h3 {
  margin: 0 0 0.75rem 0;
  font-size: 1.125rem;
  color: #333;
}

.location-meta {
  display: flex;
  margin-bottom: 0.5rem;
  font-size: 0.875rem;
}

.location-meta .label {
  font-weight: 600;
  min-width: 120px;
  color: #666;
}

.location-meta .value {
  color: #333;
}

.view-details {
  width: 100%;
  margin-top: 0.75rem;
  padding: 0.75rem;
  background: #2563eb;
  color: white;
  border: none;
  border-radius: 6px;
  font-size: 1rem;
  cursor: pointer;
  min-height: 44px;
}

.filter-toggle {
  width: 100%;
  display: flex;
  justify-content: space-between;
  align-items: center;
  padding: 1rem;
  background: #f8f9fa;
  border: 1px solid #dee2e6;
  border-radius: 6px;
  font-size: 1rem;
  cursor: pointer;
  min-height: 44px;
}

.filter-content {
  padding: 1rem;
  background: white;
  border: 1px solid #e0e0e0;
  border-radius: 0 0 6px 6px;
  margin-top: -1px;
}

/* Tablet and desktop */
@media (min-width: 769px) {
  .location-list {
    padding: 2rem;
  }
  
  .filter-panel {
    position: sticky;
    top: 20px;
  }
  
  .filter-toggle {
    display: none;
  }
  
  .filter-content {
    border: 1px solid #e0e0e0;
    border-radius: 6px;
  }
}

/* Large desktop */
@media (min-width: 1200px) {
  .location-list {
    max-width: 1200px;
    margin: 0 auto;
  }
}

---

Testing Checklist

Before closing issue #46, verify:

Visual Checks

• No horizontal scrolling on any mobile device
• All content visible without zooming
• Text is readable (minimum 14px)
• Images scale appropriately
• Buttons and links are easily tappable (44x44px minimum)

Functional Checks

• All filters work on mobile
• Search functionality works
• Sort controls accessible
• List items can be selected/clicked
• Modal dialogs fit on screen
• Forms are usable

Performance Checks

• Page loads in < 3 seconds on 3G
• Smooth scrolling performance
• No layout shift during load
• Responsive images load appropriately

Device Testing

• iPhone SE (smallest common iOS device)
• iPhone 14 Pro
• Samsung Galaxy S23
• iPad
• Test in both portrait and landscape

Browser Testing

• Safari iOS
• Chrome Android
• Firefox Mobile
• Samsung Internet

---

Resources

SolidJS Resources:

• Solid Primitives - Media Queries
• SolidJS Documentation

Responsive Design:

• MDN: Responsive Design
• CSS Tricks: Media Queries

Testing:

• Chrome DevTools Device Mode
• BrowserStack - Cross-device testing
• Lighthouse CI

---

Getting Help

If you need assistance implementing these fixes:

1. OpenAQ Slack: Join the #tech channel
2. GitHub Discussions: Post in openaq-explorer discussions
3. Create a draft PR: Share work-in-progress for feedback
4. Tag maintainers: Mention relevant team members in issue comments