{"id":13880383,"url":"https://github.com/mattt/rack-smart-app-banner","last_synced_at":"2025-07-16T16:31:39.600Z","repository":{"id":4757534,"uuid":"5907685","full_name":"mattt/rack-smart-app-banner","owner":"mattt","description":"Rack middleware to automatically include code for Smart App Banners on iOS","archived":true,"fork":false,"pushed_at":"2019-07-08T00:05:03.000Z","size":11,"stargazers_count":85,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-06-09T06:17:57.181Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Ruby","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/mattt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-09-21T21:33:32.000Z","updated_at":"2023-01-28T17:53:38.000Z","dependencies_parsed_at":"2022-08-26T01:10:56.528Z","dependency_job_id":null,"html_url":"https://github.com/mattt/rack-smart-app-banner","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/mattt/rack-smart-app-banner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattt%2Frack-smart-app-banner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattt%2Frack-smart-app-banner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattt%2Frack-smart-app-banner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattt%2Frack-smart-app-banner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mattt","download_url":"https://codeload.github.com/mattt/rack-smart-app-banner/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattt%2Frack-smart-app-banner/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265524639,"owners_count":23782016,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":"2024-08-06T08:02:59.815Z","updated_at":"2025-07-16T16:31:39.022Z","avatar_url":"https://github.com/mattt.png","language":"Ruby","funding_links":[],"categories":["Ruby"],"sub_categories":[],"readme":"# rack-smart-app-banner\n\n**Rack middleware to automatically include code for Smart App Banners on iOS**\n\n\u003e This project is no longer maintained.\n\n---\n\n\u003e Make it easy for users to discover and download your app from a website on iOS.\n\u003e With Safari’s Smart App Banner\n\u003e you can display a banner that provides a direct link to your app on the App Store,\n\u003e or opens the app if the user already has it installed.\n\u003e Smart App Banners integrate seamlessly,\n\u003e have the same look and feel users know from the App Store,\n\u003e and are easy to implement.\n\u003e \u003ccite\u003e\u003ca href=\"https://developer.apple.com/safari/resources/\"\u003eResources - Safari - Apple Developer\u003c/a\u003e\u003c/cite\u003e\n\n## Requirements\n\n- Ruby 1.9 or higher\n\n## Installation\n\n### Gemfile\n\n```ruby\ngem 'rack-smart-app-banner', require: 'rack/smart-app-banner'\n```\n\n## Usage\n\n```ruby\nuse Rack::SmartAppBanner, app_id: \"123456789\",\n                          affiliate_partner_id: 42,\n                          affiliate_site_id: \"abcdef123456\",\n                          app_argument: lambda { |request| request.path }\n```\n\nInclude this in the `config.ru` file of your Rack application,\nto inject a corresponding `\u003cmeta\u003e` tag into the `\u003chead\u003e` of each HTML document.\n\n```html\n\u003cmeta\n  name=\"apple-itunes-app\"\n  content=\"app-id=123456789, affiliate-data=partnerId=42\u0026siteID=abcdef123456 app-argument=http://listings/123\"\n/\u003e\n```\n\n### Parameters\n\n- `app_id`: _Required_.\n  Your app's unique identifier.\n  To find your app ID from the [iTunes Link Maker](http://itunes.apple.com/linkmaker/),\n  type the name of your app in the Search field,\n  and select the appropriate country and media type.\n  In the results, find your app and select iPhone App Link in the column on the right.\n  Your app ID is the nine-digit number in between `id` and `?mt`.\n- `affiliate_partner_id` \u0026 `affiliate_site_id`: _Optional_.\n  Your iTunes affiliate details, if you are an iTunes affiliate.\n  If you aren't, you can find out more about becoming an iTunes affiliate at\n  http://www.apple.com/itunes/affiliates/.\n- `app_argument`: _Optional_.\n  A block that generates a URL that provides context to your native app.\n  If you include this and the user has your app installed,\n  they can jump from your website to the corresponding position in your iOS app.\n\n## Contact\n\n[Mattt](https://twitter.com/mattt)\n\n## License\n\nrack-smart-app-banner is available under the MIT license.\nSee the LICENSE file for more info.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattt%2Frack-smart-app-banner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmattt%2Frack-smart-app-banner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattt%2Frack-smart-app-banner/lists"}