Open Checkout Quick Start

In this quick start tutorial, we’ll configure our development environment and make a code change to a fork of BigCommerce’s Open Checkout (also known as Optimized One-Page Checkout).



We recommend Windows 10 users to use Windows Subsystem for Linux.

Fork and install checkout-js

Fork and clone checkout-js; then, install dependencies.

# Clone the repo
git clone

# Install dependencies
cd checkout-js
npm ci

Start development server

Start webpack in watch mode and launch dev server.

npm run dev & npm run dev:server


  • Open your browser and navigate to to confirm the dev server is running (you should see content from build/).
  • To serve files over HTTPS, install an SSL on your development machine, or use ngrok.

Configure your sandbox

Next, configure your sandbox to use the files served up by your dev server.

  1. Login to your BigCommerce developer sandbox, and navigate to Advanced Settings > Checkout.
  2. Change Checkout Type to Custom Checkout.
  3. Under Custom Checkout Settings, copy and paste into Script URL.
  4. Save.

Learn more about installing custom checkouts.

Make a code change

Make a code change and wait a few seconds for webpack to reload the dev server. For example, the code below adds a <div> to the Checkout component defined in src/app/checkout/Checkout.tsx.

class Checkout extends Component<CheckoutProps & WithCheckoutProps & WithLanguageProps, CheckoutState> {
    // ...
    render(): ReactNode {
        // ...
        return <>
            <div className={ classNames({ 'is-embedded': isEmbedded() }) }>
                <div className="layout optimizedCheckout-contentPrimary">
                    <div>Open Checkout Quick Start Example</div>
                    { this.renderContent() }
                { errorModal }



Additional resources