Skip to content

shopnex-ai/shopnex

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

486 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

shopnex



License Build Contributions Last Commit Discord Chat

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:

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

πŸ› οΈ Contributing

πŸ’‘ Pro tip: Don't forget to ⭐ star the repo and fork it to make it your own!

We welcome contributions! If you find any bugs or have ideas for improvements, feel free to:

  • πŸ› Open an issue to report bugs or request features.
  • πŸ”§ Fork the repo and submit a pull request with your improvements.
  • πŸ’¬ Join our Discord community for discussions and support.

Before contributing, please:

  • Check existing issues and PRs to avoid duplication.
  • Follow any project-specific contribution guidelines (if available).

πŸ“„ License

Shopnex is licensed under the MIT License.