Crossmint SDK

A comprehensive suite of tools for blockchain integration, authentication, and NFT functionality
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Why Crossmint?
   • Core Features
2. Package Overview
   • Client-Side Packages
   • Server-Side Packages
   • Demo Applications
3. Getting Started
4. Building SDK Locally
   • Prerequisites
   • Installation
   • Making Package Changes
5. Publishing
6. Documentation
   • SDK Reference Docs (Auto-Generated)
7. Contact

About The Project

The Crossmint SDK is a powerful collection of packages designed to simplify blockchain integration for developers. Our goal is to make Web3 development accessible without requiring extensive blockchain experience or cryptocurrency knowledge.

Why Crossmint?

• 🚀 Quick Integration: All our tools have 5-min quickstarts
• 💻 Developer-First: Build end-to-end blockchain solutions without deep Web3 expertise
• 🔒 Secure: Enterprise-grade security for all blockchain interactions
• 💳 Fiat-First: Enable users to participate in Web3 without cryptocurrency
• 🆓 Free to Start: Start developing at no cost

Core Features

• 💳 NFT checkout: with credit card and cross-chain
• 🔐 Authentication and session management
• 👛 Embedded wallets
• 📜 Verifiable credentials

Package Overview

Wallet SDK

• @crossmint/wallets-sdk: Universal Wallet SDK.

Client-Side Packages

• @crossmint/client-sdk-react-ui: React SDK, with UI components.

• @crossmint/client-sdk-react-native-ui: React Native SDK.

• @crossmint/client-sdk-auth: Headless typescript SDK for managing auth and user profiles.

• @crossmint/client-sdk-verifiable-credentials: Headless typescript SDK for Verifiable Credentials.

• @crossmint/client-sdk-smart-wallet [DEPRECATED]: Headless typescript SDK for smart wallets.

• @crossmint/wallets-sdk: Headless typescript SDK for EVM + Solana MPC / Smart Wallets.

Other:

• @crossmint/client-sdk-base: Core client-side functionality and essential building blocks for Crossmint integration. Typically you don't need to integrate against this directly.

Server-Side Packages

• @crossmint/server-sdk: Server-side SDK.

Demo Applications

• 🔒 Wallets Quickstart): Create and interact with Crossmint wallets. This quickstart uses Crossmint Auth and uses your email as a signer for that wallet. Demo
• 💳 Hosted Checkout Quickstart): Allow your customers to buy NFTs with credit card and crypto payments, using Crossmint's hosted checkout. This quickstart provides a seamless integration for accepting payments in your dApp. Demo
• 🏦 Fintech Quickstart): Create your own Fintech app in minutes using Crossmint wallets and onramp. Demo

Getting Started

To get started with the SDK, install the packages you need into your project.

ie. pnpm add @crossmint/wallets-sdk

Then, import the package you need.

ie. import { CrossmintWallet } from "@crossmint/wallets-sdk";

For more information on how to use the SDK, see the Crossmint SDK Documentation.

Building SDK locally

Prerequisites

node >= 20.19.4
pnpm

Installation

1. Clone the repository:

git clone https://github.com/Crossmint/crossmint-sdk.git

2. Install dependencies:

cd crossmint-sdk
pnpm install

3. Build all packages:

pnpm build

Making Package Changes

When modifying packages locally:

1. Make your changes in the relevant package
2. Rebuild the modified package:

# Inside the package directory
pnpm build

3. Reinstall dependencies in your project:

# From the root directory
pnpm install

4. Restart the demo application to see your changes

Publishing

1. Run pnpm change:add to select packages for update
2. Commit the generated changeset file
3. Merge your PR to main
4. A "Release packages" PR will be created automatically
5. Merge the release PR to publish to NPM

Documentation

For detailed documentation and guides, visit our official documentation.

SDK Reference Docs (Auto-Generated)

SDK reference pages on docs.crossmint.com are auto-generated from source code JSDoc annotations via TypeDoc. The pipeline:

1. Trigger: Push to main that touches watched paths (see .github/workflows/sdk-reference-docs-generate.yml)
2. Generate: TypeDoc + custom plugins produce MDX files for each package
3. Sync: A repository_dispatch sends the generated docs to crossbit-main, which opens a PR for review

Watched paths (changes here trigger doc generation):

• packages/wallets/src/**, packages/wallets/typedoc.json, packages/wallets/typedoc-custom-plugin.mjs
• packages/client/ui/react-ui/src/**, packages/client/ui/react-ui/scripts/**
• packages/client/ui/react-native/src/**, packages/client/ui/react-native/scripts/**
• packages/client/react-base/src/**

Manual trigger:

gh workflow run sdk-reference-docs-generate.yml -f packages="react-ui,react-native,node-wallets"

Key files:

Package	Config	Custom Plugin/Script
wallets-sdk	packages/wallets/typedoc.json	packages/wallets/typedoc-custom-plugin.mjs
react-ui	packages/client/ui/react-ui/typedoc.json	packages/client/ui/react-ui/scripts/generate-reference.mjs
react-native	packages/client/ui/react-native/typedoc.json	packages/client/ui/react-native/scripts/generate-reference.mjs

Contact

To get in touch with the Crossmint team, please visit our contact page. or on X

(back to top)