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

# Installation

Welcome to the Simpu Email SDK documentation! This guide will help you get started with using the SDK components and hooks in your React applications.

## Installation

The Simpu Email SDK is designed to work within this monorepo structure. If you're building an external application, you would install it via npm:

```bash theme={null}
npm install @simpu/mail-sdk
# or
yarn add @simpu/mail-sdk
# or
pnpm add @simpu/mail-sdk
```

## Configuration

1. Configure the SDK with your Simpu API credentials:

```jsx theme={null}
<SimpuProvider
  apiUrl="https://api.simpu.co"           // API base URL
  accessToken="your-access-token"         // Your authentication token
  organisationID="your-organisation-id"   // Your organisation ID
>
```

<Note>
  **Always wrap your app with the SimpuProvider** - This ensures all components
  and hooks have access to the necessary Simpu API context.
</Note>

2. Import CSS styles (optional)

```jsx theme={null}
import "@simpu/mail-sdk/styles.css";
```

## Next Steps

* Explore the [Core](/sdk/mails/core/introduction) SDK package if you need to implement core email functionality without the SDK's built-in UI components.
* Check out the [UI](/sdk/mails/ui/introduction) package with pre-built UI components and pages for quickly integrating email marketing into your product.
* See [Examples](/sdk/mails/examples) for complete implementation examples.
* Review the API documentation for backend integration details.

Happy building! 🚀