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

# Development

> Integrate Suggix with your product, authentication flow, and custom domain.

This document explains how to integrate **Suggix** into your product, including:

* Embedding the feedback portal
* Setting up a custom domain
* Enabling SSO login

***

## Integrate the feedback portal

Suggix provides a hosted feedback portal that you can embed or link to from your product.

### Direct link

The simplest way is to link users directly to your Suggix portal:

```text theme={null}
https://{workspace}.suggix.com
```

You can place this link in:

* Navigation menus
* Help / Feedback buttons
* User dashboards
* Product update emails
* Support center articles

### Custom domain

If you want the portal to live under your own domain, configure a custom domain such as:

```text theme={null}
https://feedback.example.com
```

See the [Custom Domains guide](/development/custom-domains) for DNS and SSL setup.

## Authenticate users with SSO

Suggix supports JWT-based Single Sign-On (SSO) so users can access your feedback portal from your existing authentication flow.

Use SSO when you want to:

* Avoid asking users to create a separate Suggix account
* Identify feedback by your application's user IDs
* Keep voting and commenting tied to authenticated users
* Redirect unauthenticated users back to your own login page

See the [SSO Integration guide](/development/sso) and [Generate SSO Token guide](/development/jwt) for implementation details.

## Recommended integration flow

<Steps>
  <Step title="Create and configure your workspace">
    Set your workspace name, logo, brand color, and public subdomain in [Workspace General Settings](/settings/general).
  </Step>

  <Step title="Create feedback boards">
    Add boards for the types of feedback you want to collect. See [Feedback Boards](/guides/boards).
  </Step>

  <Step title="Add product entry points">
    Link to your portal from your app navigation, user menu, help menu, or feedback button.
  </Step>

  <Step title="Enable SSO if needed">
    Generate JWT tokens server-side and redirect users to the portal with the `ssoToken` query parameter.
  </Step>

  <Step title="Configure a custom domain">
    Add DNS records after your portal workflow is ready for users.
  </Step>
</Steps>

<Warning>
  Never generate SSO tokens in browser-side code. The SSO private key must stay on your server.
</Warning>