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-sdksAvailable SDKs
Core Client SDK
🟨 @savvagent/sdk
Core TypeScript/JavaScript SDK with real-time WebSocket updates, caching, and type-safe API
Framework SDKs (Beta)
⚛️ @savvagent/react
React hooks integration
🟩 @savvagent/vue
Vue 3 composables
🔷 @savvagent/solid
SolidJS primitives
🟧 @savvagent/svelte
Svelte stores
▲ @savvagent/nextjs
Next.js App & Pages Router support
💿 @savvagent/remix
Remix loaders & actions integration
🟧 @savvagent/sveltekit
SvelteKit server-side integration
🚀 @savvagent/astro
Astro framework integration
Mobile SDKs (Beta)
🍎 SavvagentSDK (iOS)
Native Swift with async/await, SwiftUI/UIKit support
🤖 savvagent-android-sdk
Native Kotlin with Jetpack Compose, Flow-based updates
Server SDKs (Beta)
🟢 @savvagent/node-server
Node.js with Express, Fastify, NestJS compatibility
☕ savvagent-java-server-sdk
Java 11+ with Maven/Gradle support
🐹 savvagent-go-server-sdk
Go 1.21+ with idiomatic patterns
🦀 savvagent (Rust)
Rust 1.70+ with Tokio async runtime
MCP Integrations (Beta)
🔌 @savvagent/mcp-sdk
Base SDK for Model Context Protocol integrations
🐛 @savvagent/mcp-sentry
Sentry error tracking integration
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/svelteBasic 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
new-payment-flow.Support & Resources
Getting Help
- SDK Documentation: GitHub Repository
- API Documentation: Flag Consumer API Reference
- Issues & Bugs: Report on GitHub
- Email Support: support@savvagent.com
🚀 Ready to Integrate?
Head over to the SDK repository to get started with comprehensive documentation, working examples, and framework-specific integration guides.