Swag Boilerplate

🧦 Build your own Headless eCommerce storefront with Next.js and Snipcart, and deliver swag powered by Printful. End to end commerce, styled using Tailwind CSS and deployed on Vercel.

Demo · Watch video demo · Learn more

Headless Dropshipping

Features

Realtime shipping prices
Secure payments
Automatic fulfillment
Built with Next.js
Cart & Checkout with Snipcart
Styled with Tailwind CSS
Fully Typed
Recover abandoned carts
One click deploy
... and more coming soon!

Setup

You'll first need to setup Snipcart & Printful before you can run the storefront locally, or deploy.

1. Setup Printful

You can [login](https://www.printful.com/auth/login), or [sign up](https://www.printful.com/auth/register) with Facebook, Google, Apple, and your email.

Create a new store

You'll want to select **Manual order platform / API** from the available methods when [creating a new store](https://www.printful.com/dashboard/store).

Add products to your inventory

Let's add a product to your store. 1. Select from over 200 hundred products which you would like to sell. 2. Configure the product design by adding your logo, selecting available colors, and sizes. 3. Next, proceed to mockups to select the image that will be shown in the storefront. You can select from people wearing your product, to flat wrinkled mockups. **Make sure to select `PNG` as your "mockup format" when creating your product.** 4. Next, proceed to details where you can name your product. This name will be shown in the storefront. 5. Next, proceed to pricing, and set some prices. Here you'll see the price it costs you, and the retail prices you'll charge your customers. You can quickly increase/decrease the profit margin here too. 6. **Save product** That's it! 🎉 Repeat this step for all products you want to sell. ℹ️ Don't forget, shipping and taxes are extra! ℹ️ You can optionally create a [**Product Template**](https://www.printful.com/dashboard/product-templates) for items you may want to add to additional stores later.

Configure selling preferences

Inside **Settings** > **Stores**, you'll want to configure your default selling preferences. You can specify your selling region. You can opt to sell worldwide, and choose products from a wide variety of products, or you can set a specific region, such as the UK. Depending on where you sell, you'll be liable to pay (or collect + pay) VAT. If you are VAT registered, provide Printful your VAT ID so orders can reflect a zero VAT amount where applicable. 📺 [Learn more about VAT and Printful](https://www.youtube.com/watch?v=LiqGcE267UA) ℹ️ If you need to collect VAT from customers, make sure to enable the Tax API with Snipcart.

Configure shipping preferences

Inside **Settings** > **Stores** > **Shipping**, you'll want to configure the USA & Europe settings. The defaults should work for most, but you might want to make some adjustments for domestic and international shipping.

Create a Printful Private token

Inside **Settings** > **Stores** > **API**, click visit [Printful Developers](https://developers.printful.com/login). From here you will want to create a new **Private token**, select the store you want to give this token access to, select the permissions (all), set an expiry and copy the value for use later as `PRINTFUL_API_KEY`.

Add a billing method

You'll want to add a [billing method](https://www.printful.com/dashboard/billing/billing-methods) to Printful so you can fulfill orders. When a customer makes an order, Printful will charge YOU to process the order. 📺 [Learn more how Printful processes payments for order fulfillment](https://www.youtube.com/watch?v=_5lsHL8wji4&t=2s).

2. Setup Snipcart

You'll need to [register](https://app.snipcart.com/register), or [login](https://app.snipcart.com) to Snipcart.

API key

Head over to [Account > API Keys](https://app.snipcart.com/dashboard/account/credentials) to get your `Public API Key`. You'll want to switch to **LIVE** mode. Make a copy of your `Public API Key` for use later. You'll need it when deploying, or running locally.

Configure your website domain

It's important you configure your **Default Website Domain** so Snipcart can successfully validate product prices. You may also want to add other domains, and subdomains if you're working locally with this. The domain you provide here will be your live URL, such as `headlessdropshipping.com`. You should also configure a Redirect URL. I have this set to the root domain of my store.

Configure webhooks

You'll want to configure the endpoint for webhooks. This webhook will be triggered throughout various stages of the pre, and post purchase stages. For example, when a customer places a successful order, this webhook will be triggered, and it will call a function to add the order to Printful. **The webhook URL you provide here will be your domain appended by `/api/snipcart/webhook`.**

Enable shipping

Unless you want to cover the cost of all shipping, you should enable Shipping. Below the heading **Custom Shipping**, select **Webhooks**, and **Configure** it. \*\*The endpoint URL you provide here will be your domain appended by `/api/snipcart/shipping`.

Enable taxes (optional)

Similar to shipping, you can enable custom taxes via a webhook. **You should only enable this if you are VAT registered**. Make sure to inform Printful of your VAT ID. You will want to turn on webhooks, and click **Configure**. \*\*The endpoint URL you provide here will be your domain appended by `/api/snipcart/tax`. The taxes you must collect are then calculated by Printful.

Configure your payment gateway

You should enable **SCA** (Strong Customer Authentication) for purchases. To connect a payment gateway, click on **Connect** next to the gateway, such as Stripe.

Configure regional settings

You'll want to configure your [regional settings](https://app.snipcart.com/dashboard/settings/regional) for Snipcart. I would match the currency you buy with Printful with what you show on the store here. Printful will return a currency with your variants, this is what is added to the cart. It's important Snipcart knows about this currency, and how to format it in the cart/checkout.

Create a recovery campaign

You should [create a new recovery campaign](https://app.snipcart.com/dashboard/campaigns/create) for abandoned carts. You can specify when this should be invoked (on orders above a certain amount), and what email is sent. You can include a custom discount to the campaign so you can try to recover lost sales.

Add a credit card

See [Snipcart pricing](https://snipcart.com/pricing) and add a credit card to your account. Snipcart has a monthly fee if you are below a certain sales amount.

With Snipcart you can invite multiple users to your account, configure your invoice templates, email templates, and much more. You should do all of this to ensure a great end to end experience for your customers.

3. Deploy

You'll need your PRINTFUL_API_KEY and NEXT_PUBLIC_SNIPCART_API_KEY to deploy.

Running locally

Copy the example env.local file, and add the necessary ENV variables.

cp .env.local.example .env.local

You'll next want to install the project dependencies, and start the local server:

npm install
npm run dev

Open http://localhost:3000 to see the storefront locally! 🚀

notrab / headless-dropshipping-starter