usePolyhavenMaterials

Poly Haven material library composable.

Import

const {
  materials,
  categories,
  isSearching,
  searchMaterials,
  fetchCategories,
  getMaterialInfo,
  getMaterialFiles,
} = usePolyhavenMaterials()

Return Values

Property	Type	Description
materials	Ref<PolyhavenMaterial[]>	Search results
categories	Ref<string[]>	Available categories
isSearching	Ref<boolean>	Search in progress

Methods

Method	Parameters	Returns	Description
searchMaterials	query: string, category?: string	Promise<void>	Search textures
fetchCategories	—	Promise<void>	Load categories
getMaterialInfo	id: string	Promise<MaterialInfo>	Get asset details
getMaterialFiles	id: string	Promise<MaterialFiles>	Get file URLs

API Routes Used

• GET /api/polyhaven/search — Search textures
• GET /api/polyhaven/categories — Get categories
• GET /api/polyhaven/info/[id] — Asset details
• GET /api/polyhaven/files/[id] — Asset file URLs

Integration Notes

• Proxied through Nuxt server routes (not called directly from client)
• Results cached server-side per type + filter hash
• Debounced search on client side
• Textures are the primary asset type for the materials library

Source

app/composables/usePolyhavenMaterials.ts