MVP Compatibility Matrix
Which backends, deployment targets, and runtime versions work with each MVPHub MVP kit and template family. Updated when new listings land or when a supported version reaches end-of-life.
Backend compatibility
| MVP family | Medusa v2 | Shopify Storefront API | Shopify Admin API | WooCommerce REST | BigCommerce | Custom API |
|---|---|---|---|---|---|---|
Next.js Storefront v16.0 | ||||||
Shopify Theme (OS 2.0) vOS 2.0 | ||||||
React Native (Expo) vExpo 55 | ||||||
Nuxt Storefront v3.x | ||||||
SvelteKit Storefront v2.x | ||||||
Remix Storefront vReact Router v7 (framework mode) | ||||||
Astro Storefront v5.x | ||||||
Flutter Mobile App vFlutter 3.x |
Next.js Storefront: Partial support = works via custom API client but not shipped out of the box. Static export not supported because of server components and ISR.
Shopify Theme (OS 2.0): Shopify OS 2.0 themes run on the Shopify platform only. You install them through the Shopify admin; there is no separate deployment.
React Native (Expo): Mobile apps distribute through the Apple App Store and Google Play Store. EAS (Expo Application Services) handles build, sign, and submit flows.
Nuxt Storefront: Nitro (Nuxt's server engine) supports every major serverless target. Static export works for SSG-only builds but not for ISR/SSR routes.
SvelteKit Storefront: SvelteKit adapters support every major target. Svelte 5 with runes is the required version. Smallest first-party JS bundle of any web stack.
Remix Storefront: Remix merged into React Router v7 in late 2024. The loader/action data model is preserved. Static export not supported because the framework assumes a server runtime for actions.
Astro Storefront: Only web stack in the catalog that supports pure static hosting for the whole site. Hybrid SSG + SSR is the typical ecommerce setup — SSG for content pages, SSR for product pages with live inventory.
Flutter Mobile App: Native mobile app — distributes through the Apple App Store and Google Play Store. Uses Dart, not JavaScript. Code cannot be shared with a web storefront without significant glue work.
Deployment target compatibility
| MVP family | Vercel | Cloudflare Pages | Netlify | AWS Amplify | Self-hosted (Node) | Static (S3 + CDN) |
|---|---|---|---|---|---|---|
Next.js Storefront Node 20.x / 22.x | ||||||
Shopify Theme (OS 2.0) Node N/A (Liquid) | ||||||
React Native (Expo) Node 20.x / 22.x (build tools) | ||||||
Nuxt Storefront Node 20.x / 22.x | ||||||
SvelteKit Storefront Node 20.x / 22.x | ||||||
Remix Storefront Node 20.x / 22.x | ||||||
Astro Storefront Node 20.x / 22.x | ||||||
Flutter Mobile App Node N/A (Dart SDK) |
Version support policy
Headless ecommerce depends on API stability. These are the versions we actively maintain across every MVP kit and template family. Older versions may still work but are not guaranteed.
| Dependency | Current | Minimum supported | Upgrade cadence |
|---|---|---|---|
| Next.js | 16.0 | 15.0 | Track stable within 30 days of release |
| React | 19 | 18 | Track stable within 30 days of release |
| Node.js | 22 LTS | 20 LTS | Drop EOL versions within 60 days of EOL date |
| Shopify Storefront API | 2026-01 | 2025-10 | Quarterly — Shopify releases versions 4x/year |
| Medusa | 2.x | 2.0 | Minor releases tracked within 60 days |
| Expo SDK | 55 | 53 | Annual major version upgrade |
How compatibility is verified
Every release cycle, each MVP kit and template family is tested against the backends and deployment targets marked as supported. Automated Playwright E2E tests cover cart, product detail, and checkout flows on every target.
A "partial" rating means the template doesn't ship a prebuilt integration but the API layer is abstracted enough that you can write your own client with modest effort (typically 1-3 days). We list them here because they're practically achievable, not because they work out of the box.
If you need a combination not listed here, open a request — most unsupported pairings are unsupported because no one has asked for them yet, not because they're technically impossible.
Pick a foundation you can maintain
Compatibility is the single biggest predictor of long-term MVP success. Start with a stack that fits your ops team and your deployment target.