Geins Checkout

Why use Geins Checkout?

Developer-friendly experience

Geins Checkout is designed with simplicity and flexibility in mind. Built on the Geins SDK, it streamlines checkout integration and reduces development time. Customize branding, integrate payment providers, and deploy with minimal configuration.

Flexible usage options

Choose between our hassle-free hosted version or self-host the repository on your own infrastructure. Both options provide the same powerful checkout functionality, giving you the flexibility to match your deployment preferences.

Open source and community-driven

Geins Checkout is open source under the MIT License, meaning you can contribute improvements, customize for your needs, and benefit from community-driven enhancements. Full transparency and no lock-in.

Production-ready

Designed for real-world e-commerce, Geins Checkout handles payment methods, custom branding, and seamless integration with Geins services. It's ready to handle production workloads right out of the box.

Getting started

Prerequisites

• A Geins account
• A generated checkout token (see token generation guide)
• For self-hosting: Node.js v20 or above and a package manager (npm, yarn, pnpm, or bun)

Option 1: Hosted version

Use our hosted checkout at checkout.geins.services. First, generate a checkout token using the Geins SDK, then access your checkout at:

https://checkout.geins.services/{YOUR_CHECKOUT_TOKEN}

Option 2: Self-hosted

Clone and run the checkout on your own infrastructure:

git clone https://github.com/geins-io/geins-checkout.git
cd geins-checkout
pnpm install
pnpm dev

git clone https://github.com/geins-io/geins-checkout.git
cd geins-checkout
npm install
npm run dev

git clone https://github.com/geins-io/geins-checkout.git
cd geins-checkout
yarn install
yarn dev

Create a .env file in the project root:

GEINS_DEBUG=true
LATEST_VERSION=v0
BASE_URL=https://localhost:3000
PRODUCT_IMAGE_DOMAIN=commerce.services
PRODUCT_IMAGE_BASE_URL=https://{ACCOUNT_NAME}.{DOMAIN}/product/raw/

Your checkout will be available at http://localhost:3000/{YOUR_CHECKOUT_TOKEN}.

What can you build?

Geins Checkout empowers you to build:

• Universal checkout experiences - Complete checkout solution for Geins e-commerce, with or without a storefront
• Custom branded flows - Fully customizable branding to match your unique look and feel while maintaining core functionality
• Extensive payment integrations - Supports integration with almost every payment provider available
• Headless commerce - Use checkout standalone or integrate with any frontend framework
• SDK-powered architecture - Built on the robust Geins SDK for optimal performance and seamless integration

Technology stack

Geins Checkout is built with modern, developer-friendly technologies:

Core technologies

• Nuxt.js - Vue.js framework for building universal applications
• TypeScript - Statically typed JavaScript for enhanced code quality
• shadcn-vue - High-quality Vue component library
• Tailwind CSS - Utility-first CSS framework for rapid UI development

Repository resources

Official links

• GitHub Repository - github.com/geins-io/geins-checkout - Source code, issues, and pull requests
• Hosted Checkout - checkout.geins.services - Use our hosted version
• Generate Token - sdk.geins.dev/guide/examples/generate-checkout-token.html - Learn how to generate checkout tokens

Contributing

Geins Checkout is open source under the MIT License, and we welcome contributions! Whether you're fixing bugs, adding features, improving documentation, or reporting issues, your contributions help make Geins Checkout better for everyone.

To get started:

1. Report issues - Found a bug or have a feature request? Open an issue on GitHub
2. Submit pull requests - Check the contributing guidelines in the repository's README
3. Improve documentation - Help us make Geins Checkout easier to understand and use
4. Share feedback - Let us know what features would enhance your development experience