This is an Open Source implementation of Sitecore Commerce using the OrderCloud Javascript SDK. You can use it as a starting point to discover how Sitecore Commerce administrative projects are built and teach you about the various Sitecore services that are involved and how they work together.

Important Note: This application is not production-ready.

It is meant as a demonstration and learning tool for enabling sales and speeding up the solution development process.

This app is capable of showcasing different marketplace scenarios and commerce strategies: B2B, B2C, B2B2C. It is actively being worked on and maintained by internal developers at Sitecore and the larger Sitecore community. You can expect some major changes in the near future regarding design system choice, feature additions / modifications, and further integrations with additional Sitecore services.

OrderCloud is a B2B, B2C, B2X commerce and marketplace development platform, OrderCloud delivers cloud-based, API-first, headless eCommerce architecture. Limitless customizations and endless freedom for growth to support your complete commerce strategy.

A simple, powerful and flexible Commerce Seller Application built on top of Sitecore OrderCloud API and the Javascript SDK built with:

• React
• Next.JS
• Typescript
• Chakra UI
• Toolings for linting, formatting, and conventions configured eslint, prettier, husky, lint-staged, commitlint, commitizen, and standard-version
• SEO optimization configured with next-seo and next-sitemap. you'll need to reconfigure or tinker with it to get it right according to your needs, but it's there if you need it.

• Create, read, update delete product catalogs and categories
• Create, read, update delete products with Extended propreties
• Create, read, update delete promotions
• Create, read, update, delete buyers
• Create, read, update, delete user groups and users
• Read, Update Orders

Create an OrderCloud Marketplace instance (https://portal.ordercloud.io)

Using the Deploy Button below, you'll deploy on Vercel the Next.js project as well as connect it to your Sitecore Commerce OrderCloud sandbox.

1. Using this repository as a template, create a new repository.
2. Clone your new repository locally
3. Copy the .env.local.example file in the root directory to .env.local (ignored by default during your next Git commit):

cp .env.local.example .env.local

Then set each variable on .env.local: NEXT_PUBLIC_APP_NAME Application Name used on Page title. NEXT_PUBLIC_OC_CLIENT_ID ClientID from portal.ordercloud.io
NEXT_PUBLIC_OC_API_URL='https://sandboxapi.ordercloud.io' Sandbox URL from portal.ordercloud.io
NEXT_PUBLIC_OC_MARKETPLACE_ID NEXT_PUBLIC_OC_MARKETPLACE_NAME NEXT_PUBLIC_OC_USELIVEANALYTICSDATA='false'

Your .env.local file should look like this:

NEXT_PUBLIC_APP_NAME='Sitecore Commerce Seller App'
NEXT_PUBLIC_OC_CLIENT_ID='****0BAC-****-4711-B01F-1A**4F7*****'
NEXT_PUBLIC_OC_API_URL='https://sandboxapi.ordercloud.io'
NEXT_PUBLIC_OC_MARKETPLACE_ID='SitecoreCommerce'
NEXT_PUBLIC_OC_MARKETPLACE_NAME='Sitecore Commerce'
NEXT_PUBLIC_OC_USELIVEANALYTICSDATA='false'

3. Run Next.js in development mode

npm install
npm run dev

Your app should be up and running on http://localhost:3000!

In some cases it may be useful to have your own marketplace. Maybe you need to create data for a specific workflow, or perhaps you want to insulate yourself from unwanted data changes right before a demo. To make this easy we've included a CLI command that will create a marketplace for you and pre-populate it with products from the play shop marketplace.

npm run seed -- -u=YOUR_PORTAL_USERNAME -p=YOUR_PORTAL_PASSWORD -n=YOUR_MARKETPLACE_NAME

Next, find the admin client ID and set it as NEXT_PUBLIC_OC_CLIENT_ID in your .env.local file.

Then, run the application by running npm run dev.

Finally, log in as initialadminuser with the password Testingsetup123!

This project uses Jest for unit testing. To write a unit test:

1. Create a file under either test/components or tests/pages that ends in .test.tsx (so it gets picked up by test runner)
2. Write your unit test
3. Run unit tests by running the command npm test

To deploy your local project to Vercel, push it to public GitHub/GitLab/Bitbucket repository then import to Vercel.

Check out the Discussion board. You ask questions or suggest answers in our Q&A board.

Check out our Contributing guide.

Changes from release-to-release are tracked in the Changelog wiki page.

Larger roadmap items are outlined in the project milestones

• OrderCloud Javascript SDK
• OrderCloud API Reference
• Next.js Documentation - learn about Next.js features and API.
• Learn Next.js - an interactive Next.js tutorial.
• Chakra UI
• TypeScript