Files
school_compare/nextjs-app/components/HomeView.tsx
Tudor 1c0e6298f2
All checks were successful
Build and Push Docker Images / Build Backend (FastAPI) (push) Successful in 34s
Build and Push Docker Images / Build Frontend (Next.js) (push) Successful in 1m12s
Build and Push Docker Images / Trigger Portainer Update (push) Successful in 0s
Fix: Improve UX with empty state, miles, and metric labels
1. Show empty state by default on home page
   - Don't fetch or display schools until user searches
   - Show helpful message prompting users to search
   - Only fetch schools when search params are present

2. Change distance search to miles
   - Display 0.5, 1, and 2 mile options instead of km
   - Convert miles to km when sending to API (backend expects km)
   - Convert km back to miles for display in location banner
   - Maintains backend compatibility while improving UX

3. Fix metric labels in rankings dropdown
   - Backend returns 'name' and 'type' fields
   - Frontend expects 'label' and 'format' fields
   - Added transformation in fetchMetrics to map fields
   - Dropdown now shows proper labels like "RWM Combined %"
     instead of technical codes like "rwm_expected_pct"

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-02 22:21:55 +00:00

119 lines
3.7 KiB
TypeScript

/**
* HomeView Component
* Client-side home page view with search and filtering
*/
'use client';
import { useSearchParams } from 'next/navigation';
import { FilterBar } from './FilterBar';
import { SchoolCard } from './SchoolCard';
import { Pagination } from './Pagination';
import { EmptyState } from './EmptyState';
import { useComparisonContext } from '@/context/ComparisonContext';
import type { SchoolsResponse, Filters } from '@/lib/types';
import styles from './HomeView.module.css';
interface HomeViewProps {
initialSchools: SchoolsResponse;
filters: Filters;
}
export function HomeView({ initialSchools, filters }: HomeViewProps) {
const searchParams = useSearchParams();
const { addSchool } = useComparisonContext();
const hasSearch = searchParams.get('search') || searchParams.get('postcode');
const isLocationSearch = !!searchParams.get('postcode');
return (
<div className={styles.homeView}>
{/* Hero Section */}
<section className={styles.hero}>
<h1 className={styles.heroTitle}>
Compare Primary School Performance
</h1>
<p className={styles.heroDescription}>
Search and compare KS2 results for thousands of schools across England
</p>
</section>
{/* Search and Filters */}
<FilterBar filters={filters} showLocationSearch />
{/* Location Info Banner */}
{isLocationSearch && initialSchools.location_info && (
<div className={styles.locationBanner}>
<span className={styles.locationIcon}>📍</span>
<span>
Showing schools within {(initialSchools.location_info.radius / 1.60934).toFixed(1)} miles of{' '}
<strong>{initialSchools.location_info.postcode}</strong>
</span>
</div>
)}
{/* Results Section */}
<section className={styles.results}>
{!hasSearch && initialSchools.schools.length > 0 && (
<div className={styles.sectionHeader}>
<h2>Featured Schools</h2>
<p className={styles.sectionDescription}>
Explore schools from across England
</p>
</div>
)}
{hasSearch && (
<div className={styles.resultsHeader}>
<h2>
{initialSchools.total.toLocaleString()} school
{initialSchools.total !== 1 ? 's' : ''} found
</h2>
</div>
)}
{initialSchools.schools.length === 0 ? (
<EmptyState
title={hasSearch ? "No schools found" : "Search for Schools"}
message={
hasSearch
? "Try adjusting your search criteria or filters to find schools."
: "Use the search above to find schools by name or search by location to discover schools near a postcode."
}
action={
hasSearch
? {
label: 'Clear Filters',
onClick: () => {
window.location.href = '/';
},
}
: undefined
}
/>
) : (
<>
<div className={styles.grid}>
{initialSchools.schools.map((school) => (
<SchoolCard
key={school.urn}
school={school}
onAddToCompare={addSchool}
/>
))}
</div>
{initialSchools.total_pages > 1 && (
<Pagination
currentPage={initialSchools.page}
totalPages={initialSchools.total_pages}
total={initialSchools.total}
/>
)}
</>
)}
</section>
</div>
);
}