Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/bagisto/nextjs-commerce

Develop and deploy headless commerce storefronts that convert with Vercel + Bagisto. Build your next store with Next.js and Bagisto
https://github.com/bagisto/nextjs-commerce

headless headless-commerce nextjs nextjs-commerce

Last synced: 3 months ago
JSON representation

Develop and deploy headless commerce storefronts that convert with Vercel + Bagisto. Build your next store with Next.js and Bagisto

Awesome Lists containing this project

README

        

# Next.js Commerce Bagisto

> Note: Looking for Bagisto Next.js Commerce v1? View the [code](https://github.com/bagisto/nextjs-commerce/tree/v1), [demo](https://bagisto-commerce.vercel.app/), and [release notes](https://github.com/bagisto/nextjs-commerce/releases/tag/v1)

A Next.js 14 and App Router-ready ecommerce template featuring:

- Next.js App Router
- Optimized for SEO using Next.js's Metadata
- React Server Components (RSCs) and Suspense
- Server Actions for mutations
- Edge Runtime
- New fetching and caching paradigms
- Dynamic OG images
- Styling with Tailwind CSS
- Checkout and payments with Bagisto
- Automatic light/dark mode based on system settings

Demo live at: [Bagisto Store](https://v2-bagisto-demo.vercel.app/)

## Configuration

### Setup Bagisto Store

- For `BAGISTO_CURRENCY_CODE` and `BAGISTO_STORE_ENDPOINT`, you need to install the [Bagisto](https://github.com/bagisto/bagisto/tree/v2.0.0).
- Then, you need to install the [Bagisto Headless Extension](https://github.com/bagisto/headless-ecommerce/tree/v2.0.1) in the Bagisto.
- Now you need to host the full application so that you have store endpoint and if you are in development mode then you can use Ngrok also.
- After that you can proceed with setting up Next.js commerce.

## Running locally

You will need to use the environment variables defined in [`.env.example`](.env.example) to run Next.js Commerce. It's recommended you use [Vercel Environment Variables](https://vercel.com/docs/concepts/projects/environment-variables) for this, but a `.env` file is all that is necessary.

> Note: You should not commit your `.env` file or it will expose secrets that will allow others to control your Bagisto store.

1. Install Vercel CLI: `npm i -g vercel`
2. Link local instance with Vercel and GitHub accounts (creates `.vercel` directory): `vercel link`
3. Download your environment variables: `vercel env pull`

```bash
pnpm install
pnpm dev
```

Your app should now be running on [localhost:3000](http://localhost:3000/).

#### Features Available

The following features can be enabled or disabled. This means that the UI will remove all code related to the feature.
For example: Turning `cart` off will disable Cart capabilities.

- cart
- search
- customerAuth
- customCheckout