controller-native

Integrate Cartridge Controller authentication into native mobile apps.

4|6|Updated Nov 8, 2024
One-click install
npx skills add https://github.com/cartridge-gg/docs --skill controller-native
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: controller-native
Source: https://github.com/cartridge-gg/docs/tree/main/skills/controller-native
Command: npx skills add https://github.com/cartridge-gg/docs --skill controller-native

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Integrate Cartridge Controller authentication into native mobile apps.

Core Features & Use Cases

  • Native Bindings (Controller.c): high-performance native app integration for signing and transactions on iOS/Android.
  • Web Wrapper (Capacitor): wrap web apps for app-store distribution while preserving native auth flows.
  • SessionConnector and SessionAccount: native/web authentication flows with local keypair creation and session management.
  • ControllerAccount (headless/server-side): server-side signing workflow with a native module integration.
  • iOS (Swift) bindings: UniFFI-based Swift bindings for easy integration in Swift apps.
  • Android (Kotlin) bindings: UniFFI-based Kotlin bindings for native Android apps.
  • Capacitor configuration and deep linking: bridging web apps to native sign-in flows including App Site Association passkeys.

Quick Start

Install the native bindings for your target platform and initialize a SessionConnector with your policies and RPC endpoint to begin native authentication.

Frequently Asked Questions about controller-native

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate Controller authentication into a native mobile app?

Controller native integration provides UniFFI-based Swift and Kotlin bindings to handle local keypair signing and session-based authentication directly within iOS and Android applications.

Can I use Capacitor to wrap my web app while keeping native sign-in flows?

Capacitor wraps web apps for app-store distribution while preserving native authentication flows by configuring deep linking and Apple App Site Association passkeys for native sign-in.

Does this native mobile session management work with both Swift and Kotlin?

Yes, native bindings support both Swift for iOS and Kotlin for Android via UniFFI, enabling SessionConnector and SessionAccount to manage local keypair creation and session authentication.

What is the best way to handle server-side signing workflows in a native mobile environment?

Use ControllerAccount for headless server-side signing workflows, integrating native modules to execute transactions and manage session authentication without a direct mobile UI.

Do I need to configure Apple App Site Association passkeys for iOS native authentication?

Yes, configuring Apple App Site Association passkeys is required when bridging web apps to native sign-in flows on iOS, ensuring secure credential sharing and authentication continuity.