Skip to content

geins-io/vercel-nextjs-commerce

 
 

Repository files navigation

Image for: Repository files navigation

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

Image for: 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?

Image for: 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

Image for: Getting Started

To run this application locally, follow these steps:

Prerequisites

Ensure you have the following installed:

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.

Languages

Image for: Languages
  • TypeScript 99.3%
  • Other 0.7%