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.