{"id":46260115,"url":"https://github.com/nexlabstudio/clippr-android","last_synced_at":"2026-03-04T01:27:44.672Z","repository":{"id":334528973,"uuid":"1141702415","full_name":"nexlabstudio/clippr-android","owner":"nexlabstudio","description":"Android Plugin for Clippr, an app solution for creating and handling links across multiple platforms.","archived":false,"fork":false,"pushed_at":"2026-01-26T00:19:16.000Z","size":62,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"dev","last_synced_at":"2026-01-26T01:16:44.720Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://useclippr.xyz","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nexlabstudio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-25T09:17:49.000Z","updated_at":"2026-01-26T00:17:46.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/nexlabstudio/clippr-android","commit_stats":null,"previous_names":["nexlabstudio/clippr-android"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/nexlabstudio/clippr-android","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nexlabstudio%2Fclippr-android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nexlabstudio%2Fclippr-android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nexlabstudio%2Fclippr-android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nexlabstudio%2Fclippr-android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nexlabstudio","download_url":"https://codeload.github.com/nexlabstudio/clippr-android/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nexlabstudio%2Fclippr-android/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30068343,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-04T01:03:42.280Z","status":"ssl_error","status_checked_at":"2026-03-04T01:03:23.410Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-03-04T01:27:41.105Z","updated_at":"2026-03-04T01:27:44.650Z","avatar_url":"https://github.com/nexlabstudio.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Clippr Android SDK\n\nDeep linking and mobile attribution SDK for Android.\n\n## Installation\n\n### Maven Central\n\nAdd the dependency to your app's `build.gradle.kts`:\n\n```kotlin\ndependencies {\n    implementation(\"xyz.useclippr:clippr:0.0.4\")\n}\n```\n\nOr with Groovy `build.gradle`:\n\n```groovy\ndependencies {\n    implementation 'xyz.useclippr:clippr:0.0.4'\n}\n```\n\n### JitPack\n\nAdd JitPack repository to your `settings.gradle.kts`:\n\n```kotlin\ndependencyResolutionManagement {\n    repositories {\n        google()\n        mavenCentral()\n        maven { url = uri(\"https://jitpack.io\") }\n    }\n}\n```\n\nThen add the dependency:\n\n```kotlin\ndependencies {\n    implementation(\"com.github.nexlabstudio:clippr-android:0.0.4\")\n}\n```\n\n## Quick Start\n\n### 1. Initialize the SDK\n\n```kotlin\nimport xyz.useclippr.sdk.Clippr\n\nclass MyApplication : Application() {\n    override fun onCreate() {\n        super.onCreate()\n        \n        Clippr.initialize(\n            context = this,\n            apiKey = \"your_api_key_here\",\n            debug = BuildConfig.DEBUG\n        )\n    }\n}\n```\n\n### 2. Handle Deep Links\n\n```kotlin\nimport xyz.useclippr.sdk.Clippr\nimport xyz.useclippr.sdk.models.ClipprLink\n\nclass MainActivity : AppCompatActivity() {\n    \n    override fun onCreate(savedInstanceState: Bundle?) {\n        super.onCreate(savedInstanceState)\n        \n        // Handle App Link that opened this activity\n        Clippr.handle(intent)\n        \n        // Get the initial link (direct or deferred)\n        lifecycleScope.launch {\n            val link = Clippr.getInitialLink()\n            if (link != null) {\n                handleDeepLink(link)\n            }\n        }\n        \n        // Listen for links while app is running\n        Clippr.onLink = { link -\u003e\n            handleDeepLink(link)\n        }\n    }\n    \n    override fun onNewIntent(intent: Intent?) {\n        super.onNewIntent(intent)\n        // Handle links when activity is already open\n        Clippr.handle(intent)\n    }\n    \n    private fun handleDeepLink(link: ClipprLink) {\n        Log.d(\"Clippr\", \"Deep link path: ${link.path}\")\n        Log.d(\"Clippr\", \"Metadata: ${link.metadata}\")\n        Log.d(\"Clippr\", \"Campaign: ${link.attribution?.campaign}\")\n        \n        // Navigate based on path\n        when {\n            link.path.startsWith(\"/product/\") -\u003e {\n                val productId = link.path.substringAfterLast(\"/\")\n                // Navigate to product\n            }\n        }\n    }\n}\n```\n\n### 3. Configure App Links\n\nAdd the intent filter to your `AndroidManifest.xml`:\n\n```xml\n\u003cactivity android:name=\".MainActivity\"\u003e\n    \u003cintent-filter android:autoVerify=\"true\"\u003e\n        \u003caction android:name=\"android.intent.action.VIEW\" /\u003e\n        \u003ccategory android:name=\"android.intent.category.DEFAULT\" /\u003e\n        \u003ccategory android:name=\"android.intent.category.BROWSABLE\" /\u003e\n        \n        \u003cdata\n            android:scheme=\"https\"\n            android:host=\"yourapp.clppr.xyz\" /\u003e\n    \u003c/intent-filter\u003e\n\u003c/activity\u003e\n```\n\nYour Asset Links file is automatically hosted by Clippr at:\n`https://yourapp.clppr.xyz/.well-known/assetlinks.json`\n\n### 4. Track Events (Optional)\n\n```kotlin\n// Track a simple event\nlifecycleScope.launch {\n    Clippr.track(\"signup_completed\")\n}\n\n// Track with parameters\nlifecycleScope.launch {\n    Clippr.track(\"add_to_cart\", mapOf(\n        \"product_id\" to \"12345\",\n        \"price\" to 29.99\n    ))\n}\n\n// Track revenue\nlifecycleScope.launch {\n    Clippr.trackRevenue(\n        eventName = \"purchase\",\n        revenue = 99.99,\n        currency = \"USD\",\n        params = mapOf(\"product_id\" to \"12345\")\n    )\n}\n\n// Using callback (Java-friendly)\nClippr.track(\"button_clicked\", null) { error -\u003e\n    if (error != null) {\n        Log.e(\"Clippr\", \"Failed to track\", error)\n    }\n}\n```\n\n### 5. Create Short Links (Optional)\n\n```kotlin\nimport xyz.useclippr.sdk.models.LinkParameters\nimport xyz.useclippr.sdk.models.SocialMetaTags\n\n// Create a simple short link\nlifecycleScope.launch {\n    val shortLink = Clippr.createLink(\n        LinkParameters(path = \"/product/123\")\n    )\n    Log.d(\"Clippr\", \"Short link: ${shortLink.url}\")\n}\n\n// Create a link with attribution and social tags\nlifecycleScope.launch {\n    val shortLink = Clippr.createLink(\n        LinkParameters(\n            path = \"/product/123\",\n            metadata = mapOf(\"discount\" to \"20%\"),\n            campaign = \"summer_sale\",\n            source = \"facebook\",\n            medium = \"social\",\n            alias = \"summer-deal\",  // Custom short code\n            socialTags = SocialMetaTags(\n                title = \"Check out this deal!\",\n                description = \"Get 20% off on selected items\",\n                imageUrl = \"https://example.com/promo.jpg\"\n            )\n        )\n    )\n\n    // Share the link\n    val shareIntent = Intent(Intent.ACTION_SEND).apply {\n        type = \"text/plain\"\n        putExtra(Intent.EXTRA_TEXT, shortLink.url)\n    }\n    startActivity(Intent.createChooser(shareIntent, \"Share via\"))\n}\n\n// Using callback (Java-friendly)\nClippr.createLink(LinkParameters(\"/referral/user123\")) { shortLink, error -\u003e\n    if (error != null) {\n        Log.e(\"Clippr\", \"Failed to create link\", error)\n    } else {\n        Log.d(\"Clippr\", \"Created: ${shortLink?.url}\")\n    }\n}\n```\n\n## Java Usage\n\n```java\nimport xyz.useclippr.sdk.Clippr;\nimport xyz.useclippr.sdk.models.ClipprLink;\n\npublic class MainActivity extends AppCompatActivity {\n    \n    @Override\n    protected void onCreate(Bundle savedInstanceState) {\n        super.onCreate(savedInstanceState);\n        \n        // Handle App Link\n        Clippr.handle(getIntent());\n        \n        // Get initial link\n        Clippr.getInitialLink(link -\u003e {\n            if (link != null) {\n                handleDeepLink(link);\n            }\n        });\n        \n        // Listen for links\n        Clippr.setOnLink(link -\u003e {\n            handleDeepLink(link);\n        });\n    }\n    \n    private void handleDeepLink(ClipprLink link) {\n        Log.d(\"Clippr\", \"Path: \" + link.getPath());\n    }\n}\n```\n\n## API Reference\n\n### Clippr\n\n| Method | Description |\n|--------|-------------|\n| `initialize(context, apiKey, debug)` | Initialize the SDK |\n| `getInitialLink()` | Get the link that opened the app |\n| `onLink` | Callback for links received while app is running |\n| `handle(intent)` | Handle incoming App Links |\n| `track(eventName, params)` | Track a custom event |\n| `trackRevenue(eventName, revenue, currency, params)` | Track a revenue event |\n| `createLink(parameters)` | Create a short link for sharing |\n\n### ClipprLink\n\n| Property | Type | Description |\n|----------|------|-------------|\n| `path` | `String` | The deep link path (e.g., \"/product/123\") |\n| `metadata` | `Map\u003cString, Any?\u003e?` | Custom metadata attached to the link |\n| `attribution` | `Attribution?` | Campaign attribution data |\n| `matchType` | `MatchType` | How the link was matched |\n| `confidence` | `Double?` | Match confidence (0.0 - 1.0) |\n\n### MatchType\n\n| Value | Description |\n|-------|-------------|\n| `DIRECT` | User clicked link with app installed |\n| `DETERMINISTIC` | Matched via Install Referrer (100% accurate) |\n| `PROBABILISTIC` | Matched via device fingerprinting |\n| `NONE` | No match found |\n\n### LinkParameters\n\n| Property | Type | Description |\n|----------|------|-------------|\n| `path` | `String` | Deep link path (e.g., \"/product/123\") |\n| `metadata` | `Map\u003cString, Any?\u003e?` | Custom metadata to attach |\n| `campaign` | `String?` | Campaign name for attribution |\n| `source` | `String?` | Traffic source (e.g., \"facebook\") |\n| `medium` | `String?` | Marketing medium (e.g., \"social\") |\n| `alias` | `String?` | Custom short code |\n| `socialTags` | `SocialMetaTags?` | Social preview tags |\n\n### SocialMetaTags\n\n| Property | Type | Description |\n|----------|------|-------------|\n| `title` | `String?` | Title for social previews |\n| `description` | `String?` | Description for social previews |\n| `imageUrl` | `String?` | Image URL for social previews |\n\n### ShortLink\n\n| Property | Type | Description |\n|----------|------|-------------|\n| `url` | `String` | The full short URL |\n| `shortCode` | `String` | The short code or alias |\n| `path` | `String` | The original deep link path |\n\n## Debug Mode\n\nEnable debug logging during development:\n\n```kotlin\nClippr.initialize(\n    context = this,\n    apiKey = \"your_api_key\",\n    debug = true\n)\n```\n\n## Requirements\n\n- Android API 21+ (Android 5.0)\n- Kotlin 1.9+ or Java 8+\n\n## License\n\nMIT License. See LICENSE for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnexlabstudio%2Fclippr-android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnexlabstudio%2Fclippr-android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnexlabstudio%2Fclippr-android/lists"}