SDK Introduction

The Gately SDKs provide a simple, type-safe way to integrate authentication and user management into your applications — whether you’re building a React SPA, a Next.js app, or a Node.js backend.

Available SDKs

@gately/react

Hooks-based authentication for React apps

@gately/nextjs

App Router, Server Components & middleware

@gately/nodejs

JWT verification for Express & Fastify

Features

Authentication

Email/password, magic links, and social login

User Management

Profiles, sessions, and account management

Route Protection

Middleware and hooks for protecting pages

TypeScript

Full type definitions included in every SDK

API Keys

All SDKs use an apiKey parameter. Get yours from your project dashboard: 👉 Dashboard → Settings → API Keys

# .env.local
NEXT_PUBLIC_GATELY_API_KEY=your_api_key_here

Never commit API keys to version control. Always use environment variables.

Quick Start

React
Next.js
Node.js

npm install @gately/react

import { GatelyProvider, useGately } from '@gately/react'

function App() {
  return (
    <GatelyProvider apiKey={process.env.REACT_APP_GATELY_API_KEY}>
      <Dashboard />
    </GatelyProvider>
  )
}

function Dashboard() {
  const { user, isAuthenticated, logout } = useGately()

  if (!isAuthenticated) return <p>Not logged in</p>

  return (
    <div>
      <p>Welcome, {user?.email}</p>
      <button onClick={logout}>Logout</button>
    </div>
  )
}

npm install @gately/nextjs

// app/layout.tsx
import { GatelyProvider } from '@gately/nextjs'

export default function RootLayout({ children }) {
  return (
    <html>
      <body>
        <GatelyProvider apiKey={process.env.NEXT_PUBLIC_GATELY_API_KEY}>
          {children}
        </GatelyProvider>
      </body>
    </html>
  )
}

// Any client component
'use client'
import { useGately } from '@gately/nextjs'

export function Profile() {
  const { user, isAuthenticated } = useGately()
  if (!isAuthenticated) return null
  return <p>{user?.email}</p>
}

npm install @gately/nodejs

import express from 'express'
import { requireAuth, verifyToken } from '@gately/nodejs'

const app = express()
const apiKey = process.env.GATELY_API_KEY

// Protect a route
app.get('/api/me', requireAuth(apiKey), (req, res) => {
  res.json({ user: req.auth?.user })
})

Next Steps

Installation

Install the SDK for your framework

Configuration

Configure the SDK options

React SDK

Full React SDK reference

API Keys

Get your API keys

Getting Started

Features

Platform Guides

SDK

Authentication

Users

Campaigns

Contacts

Protection

Available SDKs

@gately/react

@gately/nextjs

@gately/nodejs

Features

Authentication

User Management

Route Protection

TypeScript

API Keys

Quick Start

Next Steps

Installation

Configuration

React SDK

API Keys

​Available SDKs

@gately/react

@gately/nextjs

@gately/nodejs

​Features

Authentication

User Management

Route Protection

TypeScript

​API Keys

​Quick Start

​Next Steps

Installation

Configuration

React SDK

API Keys

Available SDKs

Features

API Keys

Quick Start

Next Steps