shopnex-starter

Shopify-style storefront and admin built on Payload CMS and Next.js with Stripe payments

Overview

Summary generated from the README

ShopNex is an open source eCommerce starter that pairs Payload CMS with a Next.js storefront. It covers products with variants, collections, cart, checkout and orders, with Stripe for payments. The project is a TypeScript monorepo using Turbo and can be scaffolded with a create-shopnex-app command.

Features

Product management with variants, pricing and inventory tracking
Cart, checkout and order management
Stripe payment integration
Shipping and tax handling
Sales analytics dashboard with charts
CSV import and export for bulk data

Good for

Launching an online store as a self-hosted alternative to Shopify
Building a custom headless storefront on Next.js with a Payload-managed catalog

From the author

Starter for building Shopify-like storefronts using Payload CMS

Get started

git clone https://github.com/shopnex-ai/shopnex.git

README

shopnex

License Build Last Commit

ShopNex – The Open Source eCommerce Built on Payload CMS

ShopNex is a modern eCommerce platform powered by Payload CMS, designed to help you launch a fully functional online store with minimal setup. Build scalable commerce solutions with our streamlined development experience.

🚀 Quick Start

Get your ShopNex store running in under 2 minutes:

npx create-shopnex-app my-store
cd my-store
pnpm dev

That's it! Your store will be running at:

CMS Admin: http://localhost:3000/admin
Storefront: http://localhost:3000

Alternative Package Managers

# Using pnpm (recommended)
pnpm dlx create-shopnex-app my-store

# Using yarn
yarn create shopnex-app my-store

# Using npx
npx create-shopnex-app my-store

✨ Core Features

🛒 Complete E-commerce

Product Management - Variants, pricing, inventory tracking
Order Processing - Cart, checkout, order management
Collections & Categories - Organize your product catalog
Gift Cards - Digital gift card system

💳 Payments & Shipping

Stripe Integration - Secure payment processing
Multiple Payment Methods - Cards, digital wallets
Shipping Management - Rates, locations, tracking
Tax Calculation - Automated tax handling

📊 Business Intelligence

Analytics Dashboard - Sales tracking with charts
Store Settings - Currency, policies, branding
Import/Export - Bulk data management via CSV
Rate Limiting - API protection and security

🎨 Customization

Rich Text Editor - Tiptap-powered content editing
Media Management - Optimized image handling
Theme System - Customizable store appearance
Plugin Architecture - Extensible functionality

🚀 Developer Experience

TypeScript - Full type safety
Next.js 15 - Latest React features
SQLite/Database - Flexible data storage
Testing Suite - E2E and integration tests

📁 Project Structure

my-store/
├── src/
│   ├── app/
│   │   ├── (payload)/        # Payload CMS admin & API
│   │   └── (storefront)/     # Next.js storefront
│   ├── collections/          # Data models
│   │   ├── Products/
│   │   ├── Orders/
│   │   ├── Collections/
│   │   └── Users/
│   ├── fields/              # Reusable field types
│   └── utils/               # Helper functions
├── payload.config.ts        # Payload CMS configuration
└── package.json

🗺️ Roadmap

✅ Done · 🔄 In Progress · 📋 Planned · 🔍 Investigating

🛒 Core	🔌 Plugins	🎨 Storefronts	📚 Docs
✅ Product Management	✅ Stripe Payment	✅ Custom Storefront	📋 Self-Hosting
✅ Inventory Management	✅ CJ Dropshipping	✅ Builder.io	📋 Plugin Development
✅ Checkout Flow	📋 Shippo Fulfillment	✅ Puck Editor	📋 Storefront Integration
✅ Cart Management	📋 PayPal Payment	📋 Plasmic	📋 Authentication
📋 Order History / Tracking	📋 Mollie Payment	🔍 Mobile (React Native)	📋 Multi-Tenancy Guide
📋 Omni-Channel	📋 Shopify Source	🔍 POS Integration
📋 Shipping Management	📋 Brightpearl	🔍 Marketplaces