Fitment

Purpose

Fitment is for managing the fitment data model and syncing fitments to Shopify (metaobjects/collections as applicable).

What you can do here

• Browse and manage fitment entities (makes, models, equipment types, etc).
• Import fitment data (CSV/import flows).
• Diagnose “missing fitments” and run sync operations to Shopify.

Key UI pages

• Fitment home
• Manage
• Import
• Missing fitments
• Models
• Makes
• Equipment types
• Browse

Related API routes

These are implemented under app/api/fitment/...:

• POST /api/fitment/import: import fitment data
• GET /api/fitment/search: search fitments
• GET /api/fitment/missing: identify missing fitments
• GET /api/fitment/models-hierarchy: hierarchy view
• Shopify-related fitment endpoints under app/api/fitment/shopify/...:
  • POST /api/fitment/shopify/sync: sync fitments
  • GET /api/fitment/shopify/status: sync status
  • POST /api/fitment/shopify/setup-definitions: setup metaobject definitions
  • Cleanup tools: delete-all, delete-collections

Troubleshooting

• Shopify sync fails: check /api/fitment/shopify/status and any GraphQL errors returned.
• Imports fail: validate the CSV shape and confirm which required columns are missing.