Add HydroBASINS North America Level 8 polygon data

Issue created with ChatGPT models' help

---

Description

Add HydroBASINS North America Level 8 polygon data into the repository by converting the provided HydroBASINS GIS dataset into valid GeoJSON format.

HydroBASINS contains multiple hierarchical watershed levels (12 total levels), but this issue should only focus on Level 8 polygon data for North America to keep the contribution small and beginner-friendly.

The converted GeoJSON file should then be uploaded into the repository fixtures folder so the existing map setup can consume and render the dataset.

---

Goals

• Obtain HydroBASINS North America Level 8 polygon dataset
• Convert the source GIS data into valid GeoJSON
• Upload converted GeoJSON into the repo fixtures folder
• Verify the GeoJSON structure remains valid
• Keep implementation lightweight and beginner-friendly

---

Implementation Instructions

• Download the HydroBASINS Standard North America dataset
• Focus only on:

Level 8 files: hybas_na_lev08_v1c

• Ignore the remaining HydroBASINS levels for this issue

• Convert to valid .geojson format by selecting all geospatial files in the dataset for Level 8:

  • dBase database file (.dbf)

  • Projection file (.prj)

  • Binary spatial index file (.sbn)

  • ESRI spatial index shapefile (.sbx)

  • Shapefile (.shp)

  • Shapefile XML (.shp.xml)

  • File Geodatabase (.gdb)

  • Compiled shapefile (.shx)

  • or other provided GIS formats

• Contributors may use standard GIS conversion workflows/tools including:

  • Geoutil
  • MyGeoData
  • Mapshaper

• Name the final GeoJSON file:

HydroBASINS Level 8 (North America).geojson

• Upload the GeoJSON file into:

public/fixtures/

Repo path:

https://github.com/OpenSourceFellows/map_dashboard_hackathon/tree/main/public/fixtures

• Verify the GeoJSON structure is valid
• Verify the dataset renders correctly in the existing map setup
• Keep the dataset limited to North America only

Optional lightweight cleanup improvements:

• Remove unnecessary attributes/properties
• Reduce file size if conversion output is extremely large
• Preserve polygon geometry accuracy during conversion

---

Expected Functionalities

GeoJSON Conversion

• HydroBASINS Level 8 polygon data converts successfully into valid GeoJSON
• Polygon geometry and key properties remain intact after conversion

Repository Integration

• GeoJSON file is uploaded into the fixtures folder
• Existing map setup can load and render the dataset

---

Notes

• HydroBASINS contains 12 hierarchical levels, but this issue only covers Level 8 polygons
• Contributors may use any reasonable GIS conversion workflow/tool
• Keep PR scope small and focused on dataset conversion/upload
• No frontend UI work is required for this issue
• Contributors do not need to process all HydroBASINS layers

---

Acceptance Criteria

• HydroBASINS North America Level 8 polygon dataset converted to valid GeoJSON
• GeoJSON file uploaded into public/fixtures/
• File named HydroBASINS Level 8 (North America).geojson
• GeoJSON structure is valid and readable
• Dataset renders correctly in existing map setup
• PR scope remains small and beginner-friendly

---

Resources

1. HydroBASINS Product Page
2. HydroBASINS Technical Documentation PDF

Start with the HydroBASINS Standard North America download and the Level 8 file hybas_na_lev08_v1c; inspect the existing map setup and public/fixtures/ to understand how fixture data is loaded. Convert only the North America Level 8 polygons to valid GeoJSON, save it as HydroBASINS Level 8 (North America).geojson, and verify that the map renders it correctly.