We're excited to announce the official release of the InsForge Swift and Kotlin SDKs. These native SDKs provide iOS/macOS and Android/JVM developers with a clean, type-safe way to integrate InsForge backend services.
Architecture
Design Principles
Both SDKs use a modular architecture with a facade pattern, providing a unified entry point:
text
┌─────────────────────────────────────────────────────┐
│ InsForgeClient (Entry Point) │
├─────────┬─────────┬─────────┬─────────┬─────────────┤
│ Auth │Database │ Storage │Functions│ Realtime │
├─────────┴─────────┴─────────┴─────────┴─────────────┤
│ Core Layer │
│ (HTTP Client, Logging, Error Handling) │
└─────────────────────────────────────────────────────┘
Key benefits:
- On-demand loading: Initialize only the modules you need
- Separation of concerns: Each module has independent configuration and lifecycle
- Extensibility: New modules won't affect existing code
- Thread safety: Swift uses Actor isolation; Kotlin uses coroutines
Feature Modules
Both SDKs support all core InsForge features:
| Module | Features |
|---|---|
| Auth | Email/password, OAuth, email verification, password reset |
| Database | Type-safe queries (PostgREST style) |
| Storage | Object storage with S3-compatible backend, presigned URLs |
| Functions | Serverless function invocation |
| Realtime | Pub/sub messaging |
| AI | Chat completion, image generation |
Platform Support
Swift SDK - Apple Platforms
| Platform | Minimum Version |
|---|---|
| iOS | 13.0+ |
| macOS | 10.15+ |
| tvOS | 13.0+ |
| watchOS | 6.0+ |
| visionOS | 1.0+ |
Kotlin SDK - JVM & Android
The Kotlin SDK supports both JVM and Android:
- Android: SharedPreferences session persistence, OAuth browser launch
- JVM Server: Server apps, CLI tools, desktop apps
Technology stack:
| Component | Choice | Notes |
|---|---|---|
| HTTP Client | Ktor + OkHttp | OkHttp engine supports both JVM and Android |
| JSON | Kotlinx Serialization | Compile-time code generation |
| Async | Kotlinx Coroutines | Structured concurrency |
| Logging | Napier | Cross-platform, auto-adapts to Logcat on Android |
| Realtime | Socket.IO | Auto-reconnect, message acknowledgment |
Open Source
Both SDKs are fully open source under the Apache License 2.0:
- Swift SDK: https://github.com/InsForge/insforge-swift
- Kotlin SDK: https://github.com/InsForge/insforge-kotlin
Contributing
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Commit changes:
git commit -m 'Add amazing feature' - Push:
git push origin feature/amazing-feature - Open a Pull Request
We welcome contributions including:
- New features
- Documentation
- Bug fixes
- Performance improvements
- Test coverage
Getting Started
Please refer to the official documentation for each SDK: