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

# SDKs

> Bibliotecas oficiais para integrar o Triglit em suas aplicações

O Triglit oferece SDKs oficiais para facilitar a integração com a API pública. Escolha o SDK que melhor se adequa ao seu projeto.

<CardGroup cols={2}>
  <Card title="TypeScript SDK" icon="code" href="/sdks/typescript-sdk">
    Biblioteca oficial para consumo da API pública do Triglit. Use em Node.js, TypeScript ou JavaScript.
  </Card>

  <Card title="React SDK" icon="react" href="/sdks/react-sdk">
    Componentes React prontos para uso, incluindo editor de workflows visual e hooks para gerenciamento de estado.
  </Card>
</CardGroup>

## Comparação Rápida

| Característica      | TypeScript SDK                       | React SDK                        |
| ------------------- | ------------------------------------ | -------------------------------- |
| **Uso**             | Backend/Frontend (qualquer ambiente) | Frontend React                   |
| **Instalação**      | `npm install triglit`                | `npm install @triglit/react-sdk` |
| **Funcionalidades** | Cliente HTTP completo                | Componentes UI + Hooks           |
| **Editor Visual**   | ❌                                    | ✅                                |
| **TypeScript**      | ✅                                    | ✅                                |
| **i18n**            | ❌                                    | ✅                                |

## Quando Usar Cada SDK

### Use o TypeScript SDK quando:

* Você precisa integrar o Triglit em um backend (Node.js, Deno, Bun)
* Você quer construir sua própria UI customizada
* Você precisa de controle total sobre as requisições HTTP
* Você está usando frameworks não-React (Vue, Angular, Svelte, etc.)

### Use o React SDK quando:

* Você está construindo uma aplicação React ou Next.js
* Você quer um editor de workflows visual pronto para uso
* Você quer componentes pré-construídos e estilizados
* Você quer hooks otimizados para gerenciamento de estado

## Instalação Rápida

<CodeGroup>
  ```bash TypeScript SDK theme={null}
  npm install triglit
  ```

  ```bash React SDK theme={null}
  npm install @triglit/react-sdk
  ```
</CodeGroup>

## Exemplo Rápido

<CodeGroup>
  ```typescript TypeScript SDK theme={null}
  import Triglit from 'triglit';

  const client = new Triglit({ apiKey: 'pk_...' });
  const workflows = await client.workflows.list();
  ```

  ```tsx React SDK theme={null}
  import { TriglitProvider, WorkflowEditor } from '@triglit/react-sdk';

  function App() {
    return (
      <TriglitProvider config={{ apiKey: 'pk_...' }}>
        <WorkflowEditor workflowId="wf_123" />
      </TriglitProvider>
    );
  }
  ```
</CodeGroup>

<Tip>
  Você pode usar ambos os SDKs no mesmo projeto! Use o TypeScript SDK no backend e o React SDK no frontend.
</Tip>