# LimeLink

> AI-agent-ready dynamic links for web, iOS, Android, React Native, and Flutter. Give an AI coding agent this file so it can discover the maintained guidance for direct, Universal/App, and deferred deep-link implementation, verification, and automation.

Website: https://limelink.org
Sitemap: https://limelink.org/sitemap.xml

## Start an AI-Agent Workflow

Give the agent only `https://limelink.org/llms.txt` as its LimeLink documentation entry point, name the target platform and desired route behavior, and require it to follow the linked current guide. This index contains the discovery paths needed to implement every currently supported LimeLink deep-link workflow without placing credentials in the prompt.

- [LLM Agent Integration](https://limelink.org/md/llm-agent.md) — safe prompt pattern for end-to-end implementation from this index
- [Introduction](https://limelink.org/md/introduction.md) — product model and Organization → Project resource hierarchy
- [V2 Guide](https://limelink.org/md/support/guide.md) — end-to-end console and resource workflow
- [Getting Started](https://limelink.org/md/getting-started.md) — create a Project, Application, and first free default-domain Link
- [Free Deferred Deep Linking](https://limelink.org/free-deferred-deep-linking) — iOS, Android, Flutter, and React Native setup and verification
- [Firebase Dynamic Links Alternative](https://limelink.org/firebase-dynamic-links-alternative) — migration sequence for app, store, deferred, and web routes
- [Service Pricing Comparison](https://limelink.org/deferred-deep-linking-service-comparison) — conversion, data-point, and Project pricing models
- [Pricing](https://limelink.org/pricing) — Free vs Pro boundary; Pro adds Custom Domains

## Understand Dynamic Links

- [What Is a Dynamic Link?](https://limelink.org/md/dynamic-link.md) — definitions, routing flow, examples, comparisons, plans, and FAQ
- [Create a Dynamic Link](https://limelink.org/md/create-link.md) — free dynamic link generator workflow, platform options, verification, and automation paths
- [Link Management](https://limelink.org/md/link-management.md) — list, readiness, copy, edit, delete, and cursor behavior
- [Link Detail and Stats](https://limelink.org/md/link-detail.md) — canonical Link fields, actions, and six-month daily metrics
- [Social Preview](https://limelink.org/md/preview-link.md) — preview title, description, image, and related option boundaries

LimeLink is a dynamic link routing service, not an SEO link-exchange network. Default-domain Link creation is available on Free. An active Pro Project is required to create Custom Domains and Custom Domain Links.

## Compare Predictable Pricing

Pricing checked 2026-09-04. See the [canonical service comparison](https://limelink.org/deferred-deep-linking-service-comparison).

| Item | Conversion-priced alternative | Data-point-priced alternative | LimeLink |
| --- | --- | --- | --- |
| Public entry | Free owned-media deep linking | 30-day trial, then USD 40/month | **Free** |
| Included usage | Free plan; paid continuation starts after a one-time 12,000-conversion allowance | 500,000 data points/month | No conversion, MAU, or data-point metering |
| Additional usage | USD 0.07/conversion on the paid tier | USD 0.0001/data point | None |
| Deferred deep links | Yes | Yes | Yes |
| Custom domain | No | Plan-dependent | Free: No; Pro: Yes |
| Example paid month | About USD 70 at 1,000 conversions | Starts at USD 40 | USD 10 per Project on Pro |
| **Example annual cost** | **About USD 840 after introductory benefits** | **Starts at USD 480 after the trial** | **USD 100 per Project on yearly Pro** |

Values exclude taxes and exchange-rate effects. LimeLink Free uses default-domain Links; Pro adds Custom Domains for USD 10 monthly or USD 100 yearly per Project. Yearly saves USD 20, equal to two monthly payments.

## Configure Projects and Applications

- [Project Management](https://limelink.org/md/project.md) — Project UUID, logo, default landing message, Appearance, billing, and access safety
- [Application Management](https://limelink.org/md/application.md) — one active iOS and one active Android Application per Project, platform fields, and Link usage
- [Appearance](https://limelink.org/md/appearance.md) — Project-owned `default_hookup_msg` and theme-only Skin save boundary

A Project UUID is a public client configuration identifier. An Organization API credential is a secret for trusted servers and must not appear in mobile/browser code, prompts, logs, or screenshots.

## Integrate an App SDK

- [SDK Integration](https://limelink.org/md/sdk-integration.md) — platform chooser, identity/security boundary, and cross-platform verification checklist
- [iOS SDK 1.0.1](https://limelink.org/md/ios-sdk.md) — SwiftPM/CocoaPods, Universal Links, unified results, deferred handling, and privacy
- [Android SDK 1.0.1](https://limelink.org/md/android-sdk.md) — Maven, App Links, Kotlin/Java facade, buffering, and deferred handling
- [React Native SDK 1.0.1](https://limelink.org/md/react-native-sdk.md) — Community CLI/Expo Development Build, native lifecycle ownership, and result contract
- [Flutter SDK 1.0.0](https://limelink.org/md/flutter-sdk.md) — package setup, events, platform configuration, result contract, and troubleshooting
- [Previous SDK Releases](https://limelink.org/md/release/index.md) — unsupported archives for maintenance only

React Native requires RN 0.81+/React 19.1+, New Architecture interoperability and Hermes; Expo Go, web, JSC and Legacy Architecture are unsupported. Flutter requires Flutter 3.44+/Dart 3.12+. Both wrappers use native Android/iOS SDK 1.0.1; Flutter's package version is 1.0.0.

Register a long-lived listener before initialization. RN iOS hosts forward native lifecycle URLs once; RN Android and Flutter use their native lifecycle integration. Do not feed JavaScript/Flutter initial-link events back into an already-owned native path. For manual deferred lookup, choose the returned Promise/Future/completion or listener as the sole navigation owner. Native buffering replays successes only; errors and deferred not-found are live-only. Follow the platform guide for exact setup.

Current SDK results expose nullable `deeplinkUrl`, `source`, nullable `originalUrl`, and `isDeferred`. An unresolved Universal/App Link is a successful result with null `deeplinkUrl` and exact inbound HTTPS `originalUrl`. Validate destinations against an app-owned scheme/host allowlist.

## Automate from a Trusted Server

- [Public API Integration](https://limelink.org/md/api-integration.md) — 30 `X-API-KEY` operations, scopes, safe cURL recipes, pagination, readiness, and errors
- [Swagger UI](https://api.limelink.org/api/docs) — authoritative interactive schema reference; request submission is disabled
- [OpenAPI JSON](https://api.limelink.org/api/v2/openapi.json) — authoritative machine-readable contract

The public API covers API credential inspection, Projects, Project Skin, Applications, Custom Domains, Core Link, and Links. Stats, Deferred, Device, Universal Link, billing, and console-only routes are outside the Organization API-key contract unless OpenAPI explicitly lists them.

## Let an Agent Operate LimeLink

- [LLM Agent Integration](https://limelink.org/md/llm-agent.md) — turn this index into a safe implementation plan without sharing secrets
- [MCP Server 0.1.0](https://limelink.org/md/mcp-server.md) — connect an agent to credential-free docs and six stdio tools for profile and Project discovery, Custom Domain discovery, Link creation, and Link resolution
- [Terraform Provider 0.3.1](https://limelink.org/md/terraform.md) — manages Projects, Applications, and Custom Domains; Link is a read-only UUID data source
- [Advanced Integrations](https://limelink.org/md/advanced.md) — decision matrix for Console, SDK, API, MCP, and Terraform

With `@limelink/mcp`, an agent can select configured profiles, discover Projects and Custom Domains, create a Link, and retrieve or resolve it by suffix or URL. The package uses `LIMELINK_PROFILES_FILE` and exposes exactly `list-profiles`, `list-projects`, `list-custom-domains`, `create-link`, `get-link-by-suffix`, and `get-link-by-url`.

## Safety and Verification

Use placeholder UUIDs and URLs in generated examples. Confirm package versions, current guide contracts, scopes, platform associations, destination allowlists, error handling, and generated changes before production. Never give an LLM an API key, access token, one-time secret, production tenant payload, payment data, or private user data.