A One-time purchase plan for Haulora – Multi-Purpose Marketplace Store.
Largest Contentful Paint — Slow 4G sim
Interaction to Next Paint (target)
Cumulative Layout Shift
Post-fetchPriority fix. Remaining mobile LCP bottleneck is the commerce CDN image payload on Slow 4G; further gains require Next.js <Image>, CDN preconnect, or smaller hero variants.
Desktop: LCP 0.50s · Score 100/100. Mobile Lighthouse score: 98/100.
The complete Haulora storefront: Next.js 16 source, the 208-product demo catalogue with all its photos and banners, the Medusa v2 integration and catalogue import script, unit and end-to-end tests, README, SETUP guide and licence.
✓ Instant download
✓ Full source code
✓ Documentation included
Framework advantages, typical use cases in this domain, and how this plan compares to the alternatives.
Next.js is a React framework that suits a large catalogue well. One app can prerender the home page, department pages and every product page, keep them fast with static HTML, and keep the interactive parts (bag, quick add, option picker, search suggestions, account) as small client components. React Server Components keep the JavaScript sent to the browser low on long product grids, which matters most on phones.
Framework advantages
A store that sells everything lives on search traffic and on phones. With 14 departments, 55 sub-categories and hundreds of products, each department, category and product needs its own crawlable URL, title and structured data, and filtered views need clean URLs too. Haulora keeps filters and sort orders in the URL and prerenders product pages, so every one of those pages can rank, while the shopping parts stay interactive.
Big value marketplaces sell on discovery more than on search. Shoppers arrive for one cheap item and stay for the deals, so the home page has to keep giving them reasons to scroll: time-limited lightning deals, price-point tiles, ranked bestsellers, themed edits and an endless personalised feed. Every product card has to sell on its own, with the discount, rating, number sold and a one-tap add.
The other half is trust and friction. A free-shipping threshold just above the average order, visible coupons, delivery dates on every product page and a short one-page checkout lift conversion. Clear stock states and sizes in a quick-add sheet keep shoppers on the grid instead of bouncing between pages.
The catalogue engine reads one JSON file in demo mode (products, variants, categories, collections, ratings and deal data) and serves it through a single data-mode switch, so pages never know whether data came from the file or from Medusa. In live mode the same functions call the Medusa v2 JS SDK for products, categories, carts, promotions, shipping options, payment sessions and customer accounts. The bag, checkout and account features go through one dispatcher with a demo implementation (cookies, simulated payments, a demo shopper with past orders) and a Medusa implementation (real carts and orders, with Stripe Payment Element, PayPal Buttons or manual payment).
scripts/seed-medusa.mjs imports the whole demo catalogue into a Medusa backend through the Admin API: the category tree and every product with its variants, prices, images and stock. It also creates what the storefront needs to sell: a USD region, a stock location, standard and express shipping options, the demo's promo codes and a publishable API key. It is safe to run more than once, and you can replace the JSON with your own products and run it again.
You need Node.js 20.9 or later (22 LTS recommended) and pnpm. pnpm dev starts the store in demo mode with no environment variables. pnpm build produces a standalone server, so the same build runs on Vercel, in a small Docker image or on any Node host behind a reverse proxy. Tests: pnpm test (Vitest) and pnpm test:e2e (Playwright on desktop and phone, with axe accessibility scans).
Haulora is a single-merchant store: brands appear as sellers, but there is no multi-vendor onboarding, seller dashboard or payout split. Demo mode is for previews and screenshots only; anything a shopper does stays in their browser. Live mode needs a Medusa v2 backend that you host yourself; the import script sets up a US region, shipping and the demo's promo codes, and you add your own payment providers (Stripe, PayPal or manual). The Terms and Privacy pages are samples to replace with your own.