> ## Documentation Index
> Fetch the complete documentation index at: https://docs.solvapay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Manual setup for SolvaPay SDK packages and environment variables.

> Recommended: use [CLI setup](./cli) with `npx solvapay init`.\
> This page covers the manual setup path.

## Prerequisites

* Node.js version 18.17 or higher
* npm, yarn, or pnpm
* TypeScript 5.0+ (recommended)

## Install packages by use case

### Server-side protection

```bash theme={null}
npm install @solvapay/server
```

### React checkout components

```bash theme={null}
npm install @solvapay/react
```

### Next.js integration

```bash theme={null}
npm install @solvapay/next
```

### Auth adapters

```bash theme={null}
npm install @solvapay/auth
```

### Supabase Edge Functions

For Deno-based Supabase Edge Functions, no npm install is needed. Use an import map in `supabase/functions/deno.json` instead. See the [Supabase Edge Functions guide](/sdks/typescript/guides/supabase-edge) for setup.

### Supabase adapter for React

```bash theme={null}
npm install @solvapay/react-supabase @supabase/supabase-js
```

### Core types only

```bash theme={null}
npm install @solvapay/core
```

## Environment variables

Required for production:

```bash theme={null}
SOLVAPAY_SECRET_KEY=sk_live_...
```

Optional:

```bash theme={null}
SOLVAPAY_API_BASE_URL=https://api.solvapay.com
```

## Stub mode

If `SOLVAPAY_SECRET_KEY` is not set, SDK calls run in stub mode for local testing.

```typescript theme={null}
import { createSolvaPay } from '@solvapay/server'

const solvaPay = createSolvaPay()
```

## Next steps

* [Quick start](./quick-start)
* [Core concepts](./core-concepts)
* [Express guide](../guides/express)