Skip to main content
  1. Getting Started

SDK Integration Guide

Deep dive into Savvagent SDKs. Learn about integration, configuration options, and best practices for all supported platforms.

📦 Official SDK Repository

All Savvagent SDKs, integrations, and examples are maintained in the dedicated SDK repository:

github.com/savvagent/savvagent-sdks

Available SDKs

Core Client SDK

🟨 @savvagent/sdk

Core TypeScript/JavaScript SDK with real-time WebSocket updates, caching, and type-safe API

npm install @savvagent/sdk
View Documentation →

Framework SDKs (Beta)

⚛️ @savvagent/react

React hooks integration

npm install @savvagent/react
Beta

🟩 @savvagent/vue

Vue 3 composables

npm install @savvagent/vue
Beta

🔷 @savvagent/solid

SolidJS primitives

npm install @savvagent/solid
Beta

🟧 @savvagent/svelte

Svelte stores

npm install @savvagent/svelte
Beta

▲ @savvagent/nextjs

Next.js App & Pages Router support

npm install @savvagent/nextjs
Beta

💿 @savvagent/remix

Remix loaders & actions integration

npm install @savvagent/remix
Beta

🟧 @savvagent/sveltekit

SvelteKit server-side integration

npm install @savvagent/sveltekit
Beta

🚀 @savvagent/astro

Astro framework integration

npm install @savvagent/astro
Beta

Mobile SDKs (Beta)

🍎 SavvagentSDK (iOS)

Native Swift with async/await, SwiftUI/UIKit support

Swift Package Manager
Beta iOS 15+
View Documentation →

🤖 savvagent-android-sdk

Native Kotlin with Jetpack Compose, Flow-based updates

Gradle / Maven
Beta Android 8+
View Documentation →

Server SDKs (Beta)

🟢 @savvagent/node-server

Node.js with Express, Fastify, NestJS compatibility

npm install @savvagent/node-server
Beta

☕ savvagent-java-server-sdk

Java 11+ with Maven/Gradle support

Maven / Gradle
Beta Java 11+

🐹 savvagent-go-server-sdk

Go 1.21+ with idiomatic patterns

go get github.com/savvagent/savvagent-go-server-sdk
Beta Go 1.21+

🦀 savvagent (Rust)

Rust 1.70+ with Tokio async runtime

cargo add savvagent
Beta Rust 1.70+

MCP Integrations (Beta)

🔌 @savvagent/mcp-sdk

Base SDK for Model Context Protocol integrations

npm install @savvagent/mcp-sdk
Beta

🐛 @savvagent/mcp-sentry

Sentry error tracking integration

npm install @savvagent/mcp-sentry
Beta

Quick Start

Installation

# Core SDK
npm install @savvagent/sdk

# Framework-specific (choose one)
npm install @savvagent/react
npm install @savvagent/vue
npm install @savvagent/nextjs
npm install @savvagent/svelte

Basic Usage

import { SavvagentClient } from '@savvagent/sdk';

const client = new SavvagentClient({
  apiKey: 'sdk_prod_...',
  apiUrl: 'https://api.savvagent.com'
});

// Evaluate a flag
const result = await client.evaluateFlag('new-checkout', {
  user_id: 'user-123',
  attributes: {
    plan: 'premium'
  }
});

if (result.enabled) {
  // Show new checkout
}

💡 Complete SDK Documentation

For complete SDK documentation, framework integration guides, and working examples, visit the official SDK repository.

Framework Examples

The SDK repository includes complete working examples for popular frameworks:

⚛️ React

React with hooks and context

▲ Next.js

Next.js App Router integration

🟩 Vue 3

Vue 3 Composition API

🟧 Svelte

SvelteKit integration

🟢 Node.js

Backend server integration

🍎 iOS

Native Swift integration

🤖 Android

Native Kotlin integration

Key Features

⚡ Sub-1ms Evaluation

Flag evaluation happens entirely in-memory after initialization for maximum performance.

🔄 Real-time Updates

SDKs automatically connect via WebSocket/SSE for instant flag updates without polling.

📊 Automatic Telemetry

Events are batched and sent automatically for analytics and AI error detection.

💾 Smart Caching

Flags are cached locally with configurable TTL to minimize API calls and maximize performance.

🎯 Sticky Targeting

Consistent hashing ensures users always see the same flag state for percentage rollouts.

🛡️ Graceful Degradation

SDKs fail gracefully with safe defaults if the API is unreachable or a flag doesn't exist.

📝 TypeScript First

Full TypeScript support with comprehensive type definitions out of the box.

🌍 Multi-Platform

SDKs for web, mobile (iOS/Android), and server environments (Node.js, Java, Go, Rust).

API Reference

For detailed information about the API endpoints that SDKs interact with, see the API documentation:

📚 Flag Consumer API

Complete REST API documentation for evaluation, telemetry, analytics, and audit endpoints.

📖 Complete API Docs

Comprehensive API reference with all request/response examples and evaluation logic details.

Best Practices

✓
Initialize Once: Create a single SDK instance and reuse it throughout your application.
✓
Use Anonymous IDs: The SDK generates anonymous IDs automatically for sticky flag behavior.
✓
Subscribe to Real-time Updates: Always listen for flag updates to ensure your UI reflects the latest state.
✓
Use Descriptive Flag Keys: Use kebab-case keys like new-payment-flow.
✓
Clean Up Event Listeners: Always remove event listeners in component cleanup to prevent memory leaks.
✗
Don't Hardcode SDK Keys: Use environment variables. Never commit SDK keys to version control.

Support & Resources

Getting Help

🚀 Ready to Integrate?

Head over to the SDK repository to get started with comprehensive documentation, working examples, and framework-specific integration guides.

View SDK Repository → Getting Started Guide

Menu

User

  • Profile
  • Organization
  • Language
  • Theme

Terms of Service

Terms of Service

Last Updated: November 25, 2025

1. Acceptance of Terms

By accessing or using the Savvagent service (the "Service"), provided by Savvagent, LLC, a Utah limited liability company, you agree to be bound by these Terms of Service ("Terms"). If you are using the Service on behalf of an organization, you represent and warrant that you have the authority to bind that organization to these Terms. If you do not agree to these Terms, you may not access or use the Service.

2. Description of Service

Savvagent provides an AI-powered feature flag management platform that enables software teams to control feature rollouts, conduct A/B testing, and correlate feature flag states with production errors. The Service includes web-based management tools, SDKs for various programming languages, APIs, and integrations with third-party observability tools through the Model Context Protocol (MCP).

3. Account Registration and Security

To access the Service, you must create an account. You agree to:

  • Provide accurate, current, and complete information during registration
  • Maintain the security of your account credentials and TOTP authenticator
  • Promptly notify us of any unauthorized access or security breach
  • Be responsible for all activities that occur under your account

4. Acceptable Use

You agree not to:

  • Use the Service in violation of any applicable laws or regulations
  • Attempt to gain unauthorized access to any part of the Service
  • Interfere with or disrupt the integrity or performance of the Service
  • Reverse engineer, decompile, or disassemble any part of the Service
  • Resell, sublicense, or transfer your rights to the Service without authorization
  • Use the Service for competitive benchmarking without prior written consent
  • Upload or transmit malicious code, viruses, or harmful data

5. Customer Data

You retain all rights to the data you submit to the Service ("Customer Data"). You grant us a limited license to process Customer Data solely to provide and improve the Service. We will not access, use, or disclose Customer Data except as necessary to provide the Service, comply with the law, or as otherwise set forth in our Privacy Policy.

Sensitive Data

You agree not to submit sensitive personal data to the Service unless you have appropriate safeguards in place. Sensitive data includes health information protected by HIPAA, payment card data subject to PCI-DSS, government identification numbers, and data protected by similar regulations.

6. Intellectual Property

The Service and all related technology, documentation, and content are the exclusive property of Savvagent, LLC and its licensors. These Terms do not grant you any rights to use our trademarks, logos, or other brand features without prior written consent.

7. Fees and Payment

Certain features of the Service require payment. Fees are non-refundable except as required by law or as expressly stated in your subscription agreement. We may change our fees upon reasonable notice. Continued use of paid features after a fee change constitutes acceptance of the new fees.

8. Termination

Either party may terminate these Terms at any time. Upon termination, your right to access the Service will cease immediately. We will retain Customer Data for 30 days following termination, after which it may be deleted. Provisions that by their nature should survive termination will survive, including intellectual property rights, disclaimers, and limitations of liability.

9. Disclaimer of Warranties

THE SERVICE IS PROVIDED "AS IS" AND "AS AVAILABLE" WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE, AND NON-INFRINGEMENT. WE DO NOT WARRANT THAT THE SERVICE WILL BE UNINTERRUPTED, ERROR-FREE, OR COMPLETELY SECURE.

10. Limitation of Liability

TO THE MAXIMUM EXTENT PERMITTED BY LAW, SAVVAGENT SHALL NOT BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, OR PUNITIVE DAMAGES, OR ANY LOSS OF PROFITS OR REVENUES, WHETHER INCURRED DIRECTLY OR INDIRECTLY. OUR TOTAL LIABILITY FOR ANY CLAIMS ARISING FROM OR RELATED TO THESE TERMS OR THE SERVICE SHALL NOT EXCEED THE AMOUNTS PAID BY YOU TO SAVVAGENT IN THE TWELVE (12) MONTHS PRECEDING THE CLAIM.

11. Indemnification

You agree to indemnify, defend, and hold harmless Savvagent and its officers, directors, employees, and agents from any claims, damages, losses, liabilities, and expenses (including reasonable attorneys' fees) arising from your use of the Service, your violation of these Terms, or your violation of any rights of a third party.

12. Modifications to Terms

We may modify these Terms at any time by posting the revised Terms on our website. Material changes will be notified via email or through the Service. Your continued use of the Service after any changes constitutes acceptance of the modified Terms.

13. Governing Law and Dispute Resolution

These Terms shall be governed by and construed in accordance with the laws of the State of Utah, United States, without regard to its conflict of law provisions. You agree that any legal action or proceeding arising out of or relating to these Terms or the Service shall be brought exclusively in the state or federal courts located in Utah, and you hereby consent to the personal jurisdiction and venue of such courts.

15. Contact Information

If you have any questions about these Terms, please contact us at:

legal@savvagent.com

We use cookies

We use cookies to improve your experience on our site. Some are essential for the site to work, while others help us understand how you use it. Learn more in our Privacy Policy