Skip to main content

Pick Your SDK

Install the latest version with @latest, or specify a version:
Or specific version:

Get Your API Key

All SDKs require an API key from your project dashboard: πŸ‘‰ Dashboard β†’ Settings β†’ API Keys

Setup by Framework

React

Next.js (App Router)

Wrap GatelyProvider in a client component to avoid SSR issues:

Node.js (Express)

Node.js (Fastify)

Environment Variables

Never commit .env files to version control. Add them to .gitignore.

Troubleshooting

Wrap GatelyProvider in a 'use client' component β€” it cannot run in a Server Component directly. See the Next.js setup above.
Make sure you’re running @gately/react@2.2.0 or @gately/nextjs@2.2.0. Update to the latest version:
Verify your key in the dashboard and ensure it’s set in your environment variables, not hardcoded.