Invitebase | Install with AI

Paste one prompt into your coding agent and it wires up the SDK, keys, and your first campaign

The fastest way to integrate Invitebase is to not do it yourself. A public agent skill at github.com/invitebase/skills teaches any capable coding agent — Claude Code, Cursor, and similar tools — how to install the SDK, wire your keys, and stand up a first referral campaign in your codebase. You paste one prompt; the agent does the quickstart.

The prompt

Install Invitebase into my app using the skill at github.com/invitebase/skills

What the skill does

The agent reads the skill's instructions and works through the same steps as the manual platform guides, adapted to your project:

Detects your platform — Web/JS, iOS/Swift, or Android/Kotlin — from the project layout and branches to the matching install path.
Installs the SDK with your package manager (@invitebase/js via npm, InvitebaseSDK via SPM, com.invitebase:sdk via Gradle).
Wires configure(key) at your app's entry point, reading the publishable key from your environment config (pk_test_… for development, pk_live_… for production) rather than hardcoding it.
Adds identify(user) at your signup/login boundary and inbound-link handling where your platform needs it.
Creates your first referral campaign — or, where it cannot reach your dashboard, leaves the exact API call or dashboard steps to run.
Surfaces a referral link behind an "invite a friend" entry point in your app, using getReferralLink(campaignId).
Self-verifies — confirms the project compiles and runs with the SDK wired in.

The skill is idempotent: re-running the prompt against a project that already has Invitebase installed updates the wiring without duplicating configuration.

What the agent will ask you for

Your test API keys — from Developers → API keys at dashboard.invitebase.com. Give agents test keys (pk_test_…/sk_test_…) only; flip to live keys yourself when you ship.
Campaign details — what should count as a referral and what the reward is, if it creates the campaign for you.

Using it with your agent

Any agent that can fetch a URL and edit your project works. With Claude Code, paste the prompt into a session opened at your project root. With Cursor, paste it into Agent mode. The skill repo's README covers supported platforms and the versioning policy — the skill pins to stable SDK surfaces, so a future SDK release does not silently change what gets installed.

These docs are agent-readable too: every page is served as raw .md, and llms.txt indexes the SDK references and API for agents that want to go deeper than the skill.

An Invitebase MCP server — letting agents create campaigns and read referral state directly, beyond the paste-one-prompt flow — is planned but not yet available.

Verify the install

Trust but verify. After the agent reports success:

Check the key handling

The publishable key should come from your environment config, not a string literal in source. Search for pk_test in the diff — it should appear in .env-style files only.

Run the app and watch the dashboard

Launch the app. The Get started checklist at dashboard.invitebase.com auto-detects each milestone as the backend observes it: SDK initialized, first identify, first referral link, first tracked event. If the SDK ping never arrives, the wiring is not live.

Complete the loop

Finish with the last two steps of your platform's quickstart: simulate the referred signup and qualifying event, and confirm the referral reaches validated in the dashboard.

Troubleshooting

Symptom	What to do
The agent stalls or loops	Re-paste the prompt in a fresh session; agents recover cleanly because the skill is idempotent.
Project type not detected	Name it in the prompt: "…using the skill at github.com/invitebase/skills. This is an Expo app." React Native/Expo and Flutter projects should point the agent at the matching platform guide as supplementary context.
SDK installed but no ping in the dashboard	Confirm `configure` runs at startup and the key in your env is the `pk_test_…` from the right app.
The agent hardcoded a key	Ask it to move the key to your environment config — then roll the key in Developers → API keys if it was committed.

If the agent gets stuck, the manual platform guides cover the same ground step by step, and support@invitebase.com is happy to look at a transcript.

Install with AI

On this page