Building Admin Dashboard Customizations

What it does

This skill enables AI agents to build custom user interface (UI) extensions for the MedusaJS Admin dashboard. It leverages the Admin SDK and Medusa UI components to create tailored admin experiences, including widgets, pages, forms, and navigation elements. This is specifically focused on admin dashboard development, not backend API route creation or storefront modifications.

When to use it

This skill is valuable for:

• Creating custom widgets for product, order, or customer pages within the Medusa Admin dashboard.
• Building entirely new admin pages with specific functionality.
• Implementing forms and modals for data entry and interaction.
• Displaying data using tables or lists in a customized format.
• Adding navigation links between different sections of the admin dashboard.

Key capabilities

• Creating widgets, custom pages, forms, and modals within the Medusa Admin dashboard.
• Implementing custom navigation elements.
• Utilizing Medusa UI components for consistent styling and functionality.
• Provides guidance on best practices for structuring admin UI features.
• Highlights critical rules to avoid common mistakes in implementation (e.g., conditional display queries).

Example prompts

• "How do I create a custom widget to display recent customer orders?"
• "What's the process for building a new admin page for managing product discounts?"
• "Can you show me how to implement a modal form for creating new customers?"

Tips & gotchas

• Reference Files are Essential: Before writing code, always load relevant reference files (data-loading.md, forms.md, display-patterns.md, table-selection.md, navigation.md, typography.md) based on the specific task at hand. The quick reference provided is not sufficient for implementation.
• SDK Configuration is Critical: Ensure the SDK client configuration in src/admin/lib/client.ts uses exact values; incorrect configurations will cause errors.
• Planning First: Consult this skill first for planning and understanding admin UI feature structure, rather than relying solely on the MedusaDocs MCP server.