commerce/README.md

Next.js Commerce x Geins

A high-performance, server-rendered Next.js (15 RC) App Router ecommerce application.

This template showcases the integration of Geins Commerce API with Next.js Commerce, leveraging the open-source Geins SDK.

Features

• React Server Components: Build fast and scalable UIs with Next.js's server-first approach.
• Server Actions: Simplify backend logic and data fetching.
• Modern React APIs: Including Suspense and useOptimistic.
• Integration with Geins: Harness the power of Geins for exceptional ecommerce capabilities.

What is Geins?

Geins is the ultimate toolkit for modern commerce. With Geins, developers and agencies can craft unique, tailored shopping experiences using:

• A hybrid model combining the reliability of a managed platform with open-source flexibility.
• A robust API-first approach enabling precise customization.
• Features for managing channels, content, CRM, events, and more.

Explore the Geins Commerce API documentation for detailed usage instructions and capabilities.

Getting Started

To run this application locally, follow these steps:

Prerequisites

Ensure you have the following installed:

• Node.js (v20 or later)
• Geins API-Key

Environment Variables

Set up your environment variables as defined in .env.example. It's recommended to use Vercel's Environment Variables for secure storage.

⚠️ Important: Never commit your .env file to version control.

Steps to Run Locally

1. Clone this repository:

   git clone https://github.com/geins-io/vercel-nextjs-commerce.git
   cd <your-repo>
   

2. Install dependencies:

   pnpm install
   

3. Link your local instance with Vercel and pull environment variables:

   npm i -g vercel
   vercel link
   vercel env pull
   

4. Start the development server:

   pnpm dev
   

5. Access the app on http://localhost:3000.