medusa-astro-storefront

Couple Medusa backend with Astro static rendering and React islands for storefronts.

Updated Jan 20, 2026
One-click install
npx skills add https://github.com/christiananese/medusa-astro-starter --skill medusa-astro-storefront
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: medusa-astro-storefront
Source: https://github.com/christiananese/medusa-astro-starter/tree/main
Command: npx skills add https://github.com/christiananese/medusa-astro-starter --skill medusa-astro-storefront

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Build high-performance e-commerce storefronts by combining Medusa as a headless backend with Astro for static-first rendering and React islands.

Core Features & Use Cases

  • Static-first rendering with minimal JS and selective hydration to optimize Core Web Vitals.
  • Medusa as backend covering products, carts, checkout, orders, and customers for headless commerce.
  • Use case: deliver sub-second LCP storefronts with SEO-friendly static pages and dynamic islands for cart and checkout.

Quick Start

Initialize the storefront scaffold and start the development server to preview locally.

Frequently Asked Questions about medusa-astro-storefront

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a high-performance Medusa storefront with Astro?

Build a high-performance Medusa storefront by coupling Medusa as a headless backend with Astro static rendering and React islands for selective hydration. This architecture enforces static-first pages to optimize Core Web Vitals and deliver sub-second LCP.

What is the best way to optimize Core Web Vitals for a headless e-commerce storefront?

Optimize Core Web Vitals for headless e-commerce by using Astro static generation for SEO-friendly pages and React islands for dynamic cart and checkout components. This minimizes JavaScript and achieves sub-second LCP.

Can I use React islands for dynamic cart and checkout in an Astro storefront?

Yes, you can use React islands for dynamic cart and checkout in an Astro storefront. This approach combines static-first rendering for product pages with selective hydration for interactive e-commerce components.

Does the Medusa Astro storefront approach support static generation for product pages?

The Medusa Astro storefront approach fully supports static generation for product pages. It leverages Astro to pre-render SEO-friendly static pages while Medusa handles backend data for products, carts, and orders.

How do I architect a static-first storefront with Medusa and React islands?

Architect a static-first storefront by setting up Medusa as the backend for e-commerce data and using Astro for static rendering with React islands. The skill enforces a YAML frontmatter scaffold and allows optional resources in scripts and references.