BlueConic SDK AI Integration

Public AI integration guidance for BlueConic SDKs. This repository provides a reusable blueconic-sdk-integration skill for implementing developers who need to integrate, instrument, verify, or audit BlueConic mobile and web SDKs in customer apps.

The skill is the canonical source of SDK integration knowledge. The installer can generate Claude Code, Cursor, and Codex adapters from the same skill so platform-specific guidance stays in one place.

Repository Layout

skills/
  blueconic-sdk-integration/
    SKILL.md
    agents/openai.yaml
    assets/blueconic-mark.svg
    references/
      android.md
      ios.md
      react-native.md
      flutter.md
      web.md
scripts/
  install-blueconic-sdk-ai-integration.sh
docs/
  TOOLING.md

Canonical instructions live in skills/blueconic-sdk-integration/SKILL.md, and platform details live in skills/blueconic-sdk-integration/references/*.md. skills/blueconic-sdk-integration/agents/openai.yaml provides OpenAI/Codex skill UI metadata, including the local BlueConic mark in skills/blueconic-sdk-integration/assets/.

Supported SDK Platforms

• Android native SDK 7.2.0
• iOS native SDK 5.2.0
• React Native SDK 5.2.0, using Android 7.2.0 and iOS 5.2.0
• Flutter SDK 1.1.0, using Android 7.2.0 and iOS 5.2.0
• Web SDK 1.0.0

Workflows

Each platform reference has the same workflow sections:

• Integrate
• Track Journeys
• Dialogues And Listeners
• Privacy Review
• Build Verification
• Final Audit

For a full customer integration, use:

Integrate -> Track Journeys -> Dialogues And Listeners -> Build Verification -> Privacy Review -> Final Audit

For narrower requests, read only SKILL.md and the relevant platform workflow section.

Install

Install the canonical skill into a customer app repository:

bash <(curl -fsSL https://raw.githubusercontent.com/blueconic/blueconic-sdk-ai-integration/main/scripts/install-blueconic-sdk-ai-integration.sh) --platform=android --target=skill

Install all generated adapters for one platform:

bash <(curl -fsSL https://raw.githubusercontent.com/blueconic/blueconic-sdk-ai-integration/main/scripts/install-blueconic-sdk-ai-integration.sh) --platform=android --target=all
bash <(curl -fsSL https://raw.githubusercontent.com/blueconic/blueconic-sdk-ai-integration/main/scripts/install-blueconic-sdk-ai-integration.sh) --platform=ios --target=all
bash <(curl -fsSL https://raw.githubusercontent.com/blueconic/blueconic-sdk-ai-integration/main/scripts/install-blueconic-sdk-ai-integration.sh) --platform=react-native --target=all
bash <(curl -fsSL https://raw.githubusercontent.com/blueconic/blueconic-sdk-ai-integration/main/scripts/install-blueconic-sdk-ai-integration.sh) --platform=flutter --target=all
bash <(curl -fsSL https://raw.githubusercontent.com/blueconic/blueconic-sdk-ai-integration/main/scripts/install-blueconic-sdk-ai-integration.sh) --platform=web --target=all

Install every platform and every adapter:

bash <(curl -fsSL https://raw.githubusercontent.com/blueconic/blueconic-sdk-ai-integration/main/scripts/install-blueconic-sdk-ai-integration.sh) --platform=all --target=all

The installer always writes into the current working directory and always downloads from the main branch when run through curl.

Supported parameters:

• --target=skill|claude|cursor|codex|all: what to install. Default: skill.
• --platform=android|ios|react-native|flutter|web|all: which SDK platform guidance to install. Default: android.
• --version: print the installer version.
• --help or -h: print usage.

Tooling

Claude Code, Cursor, and Codex adapter details are documented in docs/TOOLING.md.

Maintainer Workflow

When an SDK changes:

1. Update the affected platform reference under skills/blueconic-sdk-integration/references/.
2. Update SKILL.md only if routing, operating rules, or shared workflow expectations changed.
3. Update scripts/install-blueconic-sdk-ai-integration.sh only if generated adapter wording, platform support, or installer behavior changed.
4. Manually check at least one skill install, one generated adapter target, Codex reinstall idempotency, and --platform=all --target=all.

Source References

• BlueConic Android SDK documentation: https://support.blueconic.com/en/articles/248014-blueconic-sdk-for-android
• BlueConic Android SDK release notes: https://support.blueconic.com/en/articles/248069-blueconic-sdk-for-android-release-notes
• BlueConic iOS SDK documentation: https://support.blueconic.com/en/articles/248015-blueconic-sdk-for-ios
• BlueConic React Native SDK documentation: https://support.blueconic.com/en/articles/248017-blueconic-sdk-for-react-native
• BlueConic Flutter SDK documentation: https://support.blueconic.com/en/articles/421790-blueconic-sdk-for-flutter
• BlueConic Web SDK documentation: https://support.blueconic.com/en/articles/625934-blueconic-sdk-for-web
• Cursor rules: https://docs.cursor.com/context/rules
• Codex AGENTS.md: https://developers.openai.com/codex/guides/agents-md