# Creem
A Creem component for Bijection.
- Package: @bijectionhq/creem
- Category: Payments
- Status: Preview
- License: MIT
- Bijection source (repository access required): https://github.com/bijectionhq/creem/tree/c6ea447308fa972a2cc22f55d1fd929660db8dc3/packages/integrations/convex
- Upstream: https://github.com/armitage-labs/creem/tree/cbb07d19b10efdb64399bf924d2cb838da170089/packages/integrations/convex
- Documentation: https://docs.bijection.com/components/using
- Directory: https://bijection.com/components/creem
## Get the source
Bijection repository access is required. Request access at https://bijection.com/contact.
```sh
git clone https://github.com/bijectionhq/creem.git
cd creem
git checkout c6ea447308fa972a2cc22f55d1fd929660db8dc3
cd packages/integrations/convex
```
## Before using this component
Read the package README at the recorded revision for setup, dependencies, and API examples. Upstream documentation describes the original package and may differ from the Bijection adaptation. This is a source candidate for evaluation. Catalog inclusion does not establish npm availability or runtime qualification. Check compatibility with your SDK and deployment before adoption. External providers run their own compute.
## Upstream package documentation
Recorded 2026-10-23. This describes @creem_io/convex; check the Bijection adaptation separately.
The @creem_io/convex package integrates Creem's Merchant of Record billing platform directly into Convex applications, providing backend helpers and React/Svelte UI widgets for subscriptions, one-time purchases, seat-based pricing, and customer portal access. It handles checkout session creation, webhook processing, and subscription state synchronization within the Convex backend. Creem acts as the legal seller of your software, managing global tax compliance across 140+ countries, payment processing, and automated payouts.
### Use cases
- Adding subscription billing to a Convex app without building a separate payment backend or managing Stripe webhook infrastructure yourself
- Implementing seat-based pricing where subscription state needs to be queryable from Convex functions alongside application data
- Dropping in pre-built React or Svelte checkout and customer portal widgets without writing custom billing UI components
- Selling software globally and offloading US state tax, EU VAT, and other compliance obligations to a Merchant of Record
- Handling subscription lifecycle events such as upgrades, downgrades, trials, and cancellations with webhook handlers that write directly to the Convex database
### How it works
The component is installed via npm as @creem_io/convex and configured with a Creem API key. It exposes backend helpers that run as Convex actions to call the Creem API for checkout session creation and subscription management, and webhook handlers that verify incoming Creem webhook payloads and persist subscription state to the Convex database.
Webhook events such as checkout.completed and subscription.canceled are verified using a webhook secret and dispatched to typed handler callbacks, following the same pattern as the broader Creem SDK. This keeps billing state in sync with your Convex tables without requiring a separate server.
The package ships pre-built React and Svelte UI widgets for checkout flows and the customer portal, which can be embedded directly into your frontend. These widgets coordinate with the backend helpers to initiate checkouts and reflect current subscription status from Convex queries.
Creem functions as a Merchant of Record, meaning tax calculation, VAT collection, fraud protection, and payout handling are all managed externally. Your application only needs to provision or revoke access based on the subscription events delivered through the webhook integration.
### Upstream README
The Merchant of Record for modern software teams
Sell software globally. We handle taxes, compliance, payments, and payouts.
---
## What is CREEM?
CREEM is a **Merchant of Record (MoR)** that lets software companies sell globally without worrying about sales tax, VAT, compliance, or payment infrastructure. We act as the legal seller of your software, so you can focus on building.
**What we handle for you:**
- ๐ **Global tax compliance** across 140+ countries (US state taxes, EU VAT, UK VAT, and more)
- ๐ณ **Payment processing** with optimized checkout experiences
- ๐ **Subscription management** with trials, upgrades, downgrades, and dunning
- ๐ธ **Automated payouts** to your bank account
- ๐ **Revenue analytics** and reporting
- ๐ก๏ธ **Fraud protection** and chargeback handling
- ๐ช **Storefronts** for no-code product pages
- ๐ค **Affiliate programs** with built-in tracking and payouts
## Repository Structure
This is a **pnpm monorepo** containing all of CREEM's open-source packages, SDKs, and documentation.
```
creem/
โโโ packages/
โ โโโ creem-sdk/ # Official TypeScript SDK (auto-generated via Speakeasy)
โ โโโ creem-io/ # Lightweight TypeScript wrapper (framework-agnostic)
โ โโโ nextjs/ # Next.js integration (@creem_io/nextjs)
โ โโโ better-auth/ # Better Auth plugin (@creem_io/better-auth)
โ โโโ convex/ # Convex integration (@creem_io/convex)
โ โโโ webhook-types/ # Shared webhook type definitions
โ โโโ docs/ # Documentation site (Mintlify)
โโโ .github/workflows/ # CI, release, and SDK generation pipelines
โโโ turbo.json # Turborepo build configuration
โโโ pnpm-workspace.yaml # Workspace package definitions
```
## Packages
| Package | npm | Description |
|---------|-----|-------------|
| [`creem`](./packages/creem-sdk) | [](https://www.npmjs.com/package/creem) | Official TypeScript SDK with full API coverage, MCP server, and standalone functions |
| [`creem_io`](./packages/creem-io) | [](https://www.npmjs.com/package/creem_io) | Lightweight wrapper SDK, framework-agnostic, zero dependencies |
| [`@creem_io/nextjs`](./packages/nextjs) | [](https://www.npmjs.com/package/@creem_io/nextjs) | Next.js integration with React components and webhook handlers |
| [`@creem_io/better-auth`](./packages/better-auth) | [](https://www.npmjs.com/package/@creem_io/better-auth) | Better Auth plugin for payments and subscription management |
| [`@creem_io/convex`](./packages/convex) | [](https://www.npmjs.com/package/@creem_io/convex) | Convex billing component with backend helpers and React/Svelte widgets |
| [`@creem_io/webhook-types`](./packages/webhook-types) | [](https://www.npmjs.com/package/@creem_io/webhook-types) | Shared TypeScript types for webhook events |
## Quick Start
### 1. Install
```bash
# Official SDK (recommended for most use cases)
npm install creem
# Or the lightweight wrapper
npm install creem_io
# Next.js integration
npm install @creem_io/nextjs
# Better Auth plugin
npm install @creem_io/better-auth
# Convex integration
npm install @creem_io/convex
```
### 2. Create a Checkout
```typescript
import { Creem } from "creem";
const creem = new Creem({
apiKey: process.env.CREEM_API_KEY,
});
const checkout = await creem.checkouts.create({
productId: "prod_123",
successUrl: "https://yourapp.com/success",
});
// Redirect your customer to checkout.checkoutUrl
```
### 3. Handle Webhooks
```typescript
import { Creem } from "creem_io";
const creem = new Creem({ apiKey: process.env.CREEM_API_KEY });
// Verify and parse webhook payload
const event = creem.webhooks.verify(rawBody, signature, webhookSecret);
switch (event.eventType) {
case "checkout.completed":
// Provision access
break;
case "subscription.canceled":
// Revoke access
break;
}
```
### Next.js Example
```typescript
// app/api/checkout/route.ts
import { createCheckout } from "@creem_io/nextjs/server";
export async function POST() {
const checkout = await createCheckout({
productId: "prod_123",
successUrl: "/success",
});
return Response.redirect(checkout.checkoutUrl);
}
```
```typescript
// app/api/webhook/creem/route.ts
import { handleWebhook } from "@creem_io/nextjs/server";
export const POST = handleWebhook({
onCheckoutCompleted: async (event) => {
// Provision access for the customer
},
onSubscriptionCanceled: async (event) => {
// Revoke access
},
});
```
## Documentation
The full documentation lives in [`packages/docs`](./packages/docs) and is deployed at **[docs.creem.io](https://docs.creem.io)**.
Built with [Mintlify](https://mintlify.com), it covers:
- **Getting Started** guides for new merchants
- **API Reference** with interactive examples
- **SDK guides** for every package in this repo
- **Webhook events** and payload schemas
- **MoR explainers** on tax compliance and payouts
### Running Docs Locally
```bash
# Install Mintlify CLI
npm i -g mintlify
# Start local dev server
cd packages/docs
mintlify dev
```
### AI-Friendly Docs
CREEM provides [`llms.txt`](https://docs.creem.io/llms.txt) and [`llms-full.txt`](https://docs.creem.io/llms-full.txt) for AI agents and LLMs to consume structured documentation. We also ship [Skill Files](https://docs.creem.io/ai/for-agents/skill-files) for agent frameworks that support them.
## Development
### Prerequisites
- [Node.js](https://nodejs.org/) v24+
- [pnpm](https://pnpm.io/) v11+
### Setup
```bash
# Clone the repo
git clone https://github.com/armitage-labs/creem.git
cd creem
# Install dependencies
pnpm install
# Build all packages
pnpm build
# Run tests
pnpm test
# Type check
pnpm typecheck
```
### Monorepo Commands
This repo uses [Turborepo](https://turbo.build/) for orchestrating builds across packages.
```bash
# Build everything
pnpm build
# Build a specific package
pnpm turbo build --filter=creem
# Run tests for a specific package
pnpm turbo test --filter=@creem_io/better-auth
# Format code
pnpm format
# Check formatting
pnpm format:check
```
### Changesets
We use [Changesets](https://github.com/changesets/changesets) for versioning and publishing.
```bash
# Create a changeset after making changes
pnpm changeset
# Version packages (CI does this automatically)
pnpm version-packages
# Publish (CI does this automatically)
pnpm release
```
## Architecture
```
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Your Application โ
โโโโโโโโโโโโฌโโโโโโโโโโโฌโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโค
โ creem โ creem_io โ nextjs โ better-auth โ
โ (SDK) โ(wrapper) โ (React) โ (plugin) โ
โโโโโโโโโโโโดโโโโโโโโโโโดโโโโโโโโโโโดโโโโโโโโโโโโโโโโโค
โ @creem_io/webhook-types โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ CREEM API (v1) โ
โ https://api.creem.io/v1 โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
```
- **`creem` (SDK):** Auto-generated from the OpenAPI spec via [Speakeasy](https://www.speakeasy.com/). Full API coverage, retry logic, MCP server support. This is the recommended SDK for most use cases.
- **`creem_io` (wrapper):** Hand-written lightweight SDK with zero dependencies. Framework-agnostic, works anywhere Node.js runs. Ideal for minimal setups or when you want full control.
- **`@creem_io/nextjs`:** React components and server utilities built specifically for Next.js App Router. Drop-in checkout buttons, webhook route handlers, and subscription access helpers.
- **`@creem_io/better-auth`:** Plugin for the [Better Auth](https://www.better-auth.com/) framework. Syncs CREEM customers with your auth users, manages subscriptions in your database, and handles webhooks automatically.
- **`@creem_io/webhook-types`:** Shared TypeScript type definitions for all CREEM webhook events. Used internally by other packages.
## CI/CD
| Workflow | Trigger | Description |
|----------|---------|-------------|
| **CI** | Push/PR to `main` | Builds, typechecks, tests, and lints changed packages |
| **Release** | Push to `main` | Creates release PRs via Changesets, publishes to npm |
| **SDK Generation** | Daily / manual | Regenerates the `creem` SDK from the latest OpenAPI spec |
| **Docs Deploy** | Changes to `packages/docs` | Deploys documentation to [docs.creem.io](https://docs.creem.io) via Mintlify |
## Contributing
We welcome contributions! Here's how to get started:
1. **Fork** the repository
2. **Create a branch** for your feature or fix
```bash
git checkout -b feat/my-feature
```
3. **Make your changes** and add tests where appropriate
4. **Create a changeset** if your change affects a published package
```bash
pnpm changeset
```
5. **Run checks** to make sure everything passes
```bash
pnpm build && pnpm test && pnpm typecheck
```
6. **Open a Pull Request** against `main`
### Contribution Guidelines
- Follow the existing code style (Prettier is configured)
- Write tests for new functionality
- Keep PRs focused on a single change
- Update documentation for user-facing changes
- Use [conventional commits](https://www.conventionalcommits.org/) for commit messages
### Package-Specific Notes
- **`creem` (SDK):** This package is auto-generated. Don't edit files in `src/` directly. Instead, update the OpenAPI spec or Speakeasy configuration.
- **`packages/docs`:** Documentation uses Mintlify MDX format. API reference pages are generated from `openapi.json`. See the [docs README](./packages/docs/README.md) for details.
- **`creem_io`:** When adding new API resources, follow the existing pattern in `resources/` and add corresponding types in `types/`.
## Community
- ๐ฌ [Discord](https://discord.gg/q3GKZs92Av) for questions and discussion
- ๐ [GitHub Issues](https://github.com/armitage-labs/creem/issues) for bug reports
- ๐ก [Feature Requests](https://creem.featurebase.app) on Featurebase
- ๐ฆ [Twitter/X](https://x.com/creem_io) for updates
## License
This project is licensed under the [MIT License](./LICENSE).
---
