{"id":2538,"url":"https://github.com/PaoloCuscela/Cards","last_synced_at":"2025-08-06T16:31:44.332Z","repository":{"id":40362866,"uuid":"106450214","full_name":"PaoloCuscela/Cards","owner":"PaoloCuscela","description":"Awesome iOS 11 appstore cards in swift 5.","archived":false,"fork":false,"pushed_at":"2023-04-19T07:22:40.000Z","size":10354,"stargazers_count":4216,"open_issues_count":25,"forks_count":275,"subscribers_count":54,"default_branch":"master","last_synced_at":"2025-08-02T13:41:13.826Z","etag":null,"topics":["cards","ibdesignable","ios","ios11","storyboard","swift","swift4","swift5","ui","uikit"],"latest_commit_sha":null,"homepage":"","language":"Swift","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/PaoloCuscela.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}},"created_at":"2017-10-10T17:37:26.000Z","updated_at":"2025-07-28T13:05:47.000Z","dependencies_parsed_at":"2022-08-02T22:00:48.130Z","dependency_job_id":"8ad83387-92a9-4099-b2b6-4ff9e3514224","html_url":"https://github.com/PaoloCuscela/Cards","commit_stats":{"total_commits":56,"total_committers":11,"mean_commits":5.090909090909091,"dds":0.1785714285714286,"last_synced_commit":"cfaa2a92cb699f88348b58c04583709a7264ddc8"},"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"purl":"pkg:github/PaoloCuscela/Cards","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PaoloCuscela%2FCards","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PaoloCuscela%2FCards/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PaoloCuscela%2FCards/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PaoloCuscela%2FCards/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PaoloCuscela","download_url":"https://codeload.github.com/PaoloCuscela/Cards/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PaoloCuscela%2FCards/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269112538,"owners_count":24361994,"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","status":"online","status_checked_at":"2025-08-06T02:00:09.910Z","response_time":99,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["cards","ibdesignable","ios","ios11","storyboard","swift","swift4","swift5","ui","uikit"],"created_at":"2024-01-05T20:16:16.267Z","updated_at":"2025-08-06T16:31:43.512Z","avatar_url":"https://github.com/PaoloCuscela.png","language":"Swift","funding_links":[],"categories":["UI","Libs","Cards","Swift","UI Components","UI [🔝](#readme)","Content"],"sub_categories":["Cards","UI","Other free courses"],"readme":"\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/PaoloCuscela/Cards/stargazers\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/stars/PaoloCuscela/Cards.svg\"\n            alt=\"GitHub Stars\"\u003e\u003c/a\u003e\n    \u003ca href=\"http://cocoadocs.org/docsets/Cards/\"\u003e\n        \u003cimg src=\"https://img.shields.io/cocoapods/v/Cards.svg?style=flat\"\n            alt=\"Pod Version\"\u003e\u003c/a\u003e\n    \u003ca href=\"http://cocoadocs.org/docsets/Cards\"\u003e\n        \u003cimg src=\"https://img.shields.io/cocoapods/p/Cards.svg?style=flat\"\n            alt=\"Platform\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/PaoloCuscela/Cards/blob/master/LICENSE\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/license/PaoloCuscela/Cards.svg\"\n            alt=\"License\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n![Overview](https://raw.githubusercontent.com/PaoloCuscela/Cards/master/Images/Header.png)\n\n\u003cp align=\"center\"\u003e \u003cb\u003eCards brings to Xcode the card views seen in the new iOS XI Appstore. \u003c/b\u003e\u003c/p\u003e \n\n## Getting Started\n\n### Storyboard\n- Go to **main.storyboard** and add a **blank UIView**\n- Open the **Identity Inspector** and type '**CardHighlight**' the '**class**' field\n- Make sure you have '**Cards**' selected in '**Module**' field\n- Switch to the **Attributes Inspector** and **configure** it as you like. \n\n![CardViewStoryboard](https://raw.githubusercontent.com/PaoloCuscela/Cards/master/Images/CardViewStoryboard.png)\n\n* Drag a blank **UIViewController** and design its view as you like\n* Move to the **Identity inspector** \n* Type '**CardContent**' in the **StoryboardID** field.\n\n![DetailViewStoryboard](https://raw.githubusercontent.com/PaoloCuscela/Cards/master/Images/DetailViewStoryboard.png)\n\n### Code\n```swift\nimport Cards\n\n// Aspect Ratio of 5:6 is preferred\nlet card = CardHighlight(frame: CGRect(x: 10, y: 30, width: 200 , height: 240))\n\ncard.backgroundColor = UIColor(red: 0, green: 94/255, blue: 112/255, alpha: 1)\ncard.icon = UIImage(named: \"flappy\")\ncard.title = \"Welcome \\nto \\nCards !\"\ncard.itemTitle = \"Flappy Bird\"\ncard.itemSubtitle = \"Flap That !\"\ncard.textColor = UIColor.white\n    \ncard.hasParallax = true\n    \nlet cardContentVC = storyboard!.instantiateViewController(withIdentifier: \"CardContent\")\ncard.shouldPresent(cardContentVC, from: self, fullscreen: false)\n    \nview.addSubview(card)\n```\n\n![GetStarted](https://raw.githubusercontent.com/PaoloCuscela/Cards/master/Images/GetStarted.png)\n\n## Prerequisites\n\n- **Xcode 10.2** or newer\n- **Swift 5.0**\n\n## Installation\n\n### Cocoapods\n```ruby\nuse_frameworks!\npod 'Cards'\n```\n### Manual\n- **Download** the repo\n- ⌘C ⌘V the **'Cards' folder** in your project\n- In your **Project's Info** go to '**Build Phases**'\n- Open '**Compile Sources**' and **add all the files** in the folder\n\n## Overview\n\n\u003cp float=\"left\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/PaoloCuscela/Cards/master/Images/CardPlayer.gif\" width=\"290\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/PaoloCuscela/Cards/master/Images/CardGroupSliding.gif\" width=\"290\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/PaoloCuscela/Cards/master/Images/DetailView.gif\" width=\"290\"\u003e\n\u003c/p\u003e\n\n## Customization\n\n```swift\n//Shadow settings\nvar shadowBlur: CGFloat\nvar shadowOpacity: Float\nvar shadowColor: UIColor\nvar backgroundImage: UIImage?\nvar backgroundColor: UIColor\n\nvar textColor: UIColor \t//Color used for the labels\nvar insets: CGFloat \t//Spacing between content and card borders\nvar cardRadius: CGFloat //Corner radius of the card\nvar icons: [UIImage]? \t//DataSource for CardGroupSliding\nvar blurEffect: UIBlurEffectStyle //Blur effect of CardGroup\n```\n\n## Usage\n\n### CardPlayer\n```swift\nlet card = CardPlayer(frame: CGRect(x: 40, y: 50, width: 300 , height: 360))\ncard.textColor = UIColor.black\ncard.videoSource = URL(string: \"http://clips.vorwaerts-gmbh.de/big_buck_bunny.mp4\")\ncard.shouldDisplayPlayer(from: self)    //Required. \n        \ncard.playerCover = UIImage(named: \"mvBackground\")!  // Shows while the player is loading\ncard.playImage = UIImage(named: \"CardPlayerPlayIcon\")!  // Play button icon\n        \ncard.isAutoplayEnabled = true\ncard.shouldRestartVideoWhenPlaybackEnds = true\n        \ncard.title = \"Big Buck Bunny\"\ncard.subtitle = \"Inside the extraordinary world of Buck Bunny\"\ncard.category = \"today's movie\"\n        \nview.addSubview(card)\n```\n\n### CardGroupSliding\n```swift\n    let icons: [UIImage] = [    \n    \n        UIImage(named: \"grBackground\")!,\n        UIImage(named: \"background\")!,\n        UIImage(named: \"flappy\")!,\n        UIImage(named: \"flBackground\")!,\n        UIImage(named: \"icon\")!,\n        UIImage(named: \"mvBackground\")!\n    \n    ]   // Data source for CardGroupSliding\n    \n    let card = CardGroupSliding(frame: CGRect(x: 40, y: 50, width: 300 , height: 360))\n    card.textColor = UIColor.black\n    \n    card.icons = icons\n    card.iconsSize = 60\n    card.iconsRadius = 30\n    \n    card.title = \"from the editors\"\n    card.subtitle = \"Welcome to XI Cards !\"\n\n    view.addSubview(card)\n```\n\n## Documentation\n\nSee the **Wiki**, to learn in depth infos about Cards.  \n[GO!](https://github.com/PaoloCuscela/Cards/wiki) \n\n## Issues \u0026 Feature requests\n\nIf you encounter any problems or have any trouble using Cards, feel free to open an issue. I'll answer you as soon as I see it.\n\nNew features, or improvements to the framework are welcome (open an issue).\n\n## Thanksto\n\n- **Patrick Piemonte** - providing [Player](https://github.com/piemonte/Player) framework used in [CardPlayer.swift](https://raw.githubusercontent.com/PaoloCuscela/Cards/master/Cards/CardPlayer.swift)\n- **Mac Bellingrath** \n\n## License\n\nCards is released under the [MIT License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPaoloCuscela%2FCards","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FPaoloCuscela%2FCards","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPaoloCuscela%2FCards/lists"}