Frontend: Create pages to display locations and categories data

Resolved 💬 3 comments Opened Dec 3, 2025 by roku674 Closed Jan 4, 2026

Summary

The backend now has public API endpoints for locations (states, cities, ZIP codes) and business categories (NAICS codes). The frontend needs pages to display this data.

Backend API Endpoints Available

Locations API

  • GET /api/locations/states - List all states
  • GET /api/locations/states/{stateCode} - Get single state
  • GET /api/locations/states/{stateCode}/cities - List cities in a state
  • GET /api/locations/cities/{stateCode}/{citySlug} - Get city details
  • GET /api/locations/cities/{stateCode}/{citySlug}/zipcodes - List ZIP codes in a city
  • GET /api/locations/zipcodes/{zip} - Get ZIP code details
  • GET /api/locations/search?q={query}&limit=10 - Search locations

Categories API

  • GET /api/categories - List top-level NAICS sectors
  • GET /api/categories?includeChildren=true - Full hierarchy
  • GET /api/categories/{naicsCode} - Get category by NAICS code
  • GET /api/categories/{naicsCode}/children - Get subcategories
  • GET /api/categories/by-slug/{slug} - Get category by slug
  • GET /api/categories/search?q={query} - Search categories

Frontend Requirements

Location Browser Page

  • Browse states -> cities -> ZIP codes hierarchy
  • Search functionality for locations
  • Display city details (county, coordinates, timezone)

Category Browser Page

  • Display NAICS business categories in hierarchical tree
  • Expandable/collapsible category sections
  • Search functionality for categories
  • Show category icons

Integration Points

  • Location selector component for business registration
  • Category selector component for business classification
  • Search autocomplete using the search endpoints

Data Available

  • 54 states/territories
  • 29,539 cities
  • 38,958 ZIP codes
  • 165 NAICS business categories (20 sectors + subsectors + industry groups)

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗