{"id":13496165,"url":"https://github.com/pedrommcarrasco/Hover","last_synced_at":"2025-03-28T18:31:48.945Z","repository":{"id":47840370,"uuid":"196469150","full_name":"pedrommcarrasco/Hover","owner":"pedrommcarrasco","description":"🎈 The smartest floating button","archived":false,"fork":false,"pushed_at":"2022-12-28T13:03:10.000Z","size":12368,"stargazers_count":120,"open_issues_count":3,"forks_count":24,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-10-02T02:01:20.537Z","etag":null,"topics":["carthage","cocoapods","fab","floating-action-button","floating-button","floatingactionbutton","ios","swift","ui","ui-components"],"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/pedrommcarrasco.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":"pedrommcarrasco","custom":["https://www.buymeacoffee.com/pedrommcarrasco","https://www.paypal.me/pedrommcarrasco"]}},"created_at":"2019-07-11T21:48:20.000Z","updated_at":"2024-09-18T19:36:10.000Z","dependencies_parsed_at":"2022-08-20T01:52:42.685Z","dependency_job_id":null,"html_url":"https://github.com/pedrommcarrasco/Hover","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pedrommcarrasco%2FHover","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pedrommcarrasco%2FHover/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pedrommcarrasco%2FHover/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pedrommcarrasco%2FHover/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pedrommcarrasco","download_url":"https://codeload.github.com/pedrommcarrasco/Hover/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222403038,"owners_count":16978780,"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":["carthage","cocoapods","fab","floating-action-button","floating-button","floatingactionbutton","ios","swift","ui","ui-components"],"created_at":"2024-07-31T19:01:43.256Z","updated_at":"2024-10-31T11:30:59.319Z","avatar_url":"https://github.com/pedrommcarrasco.png","language":"Swift","funding_links":["https://github.com/sponsors/pedrommcarrasco","https://www.buymeacoffee.com/pedrommcarrasco","https://www.paypal.me/pedrommcarrasco"],"categories":["Swift"],"sub_categories":[],"readme":"![](https://github.com/pedrommcarrasco/Hover/blob/master/Design/logo.png?raw=true)\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/pedrommcarrasco/Hover/blob/master/Design/demo.gif?raw=true\" alt=\"Presentation\" width=\"100%\"/\u003e\n\u003c/p\u003e\n\n# 🎈 What's Hover?\n\n\u003e **Hover** *(/ˈhɒv.ər/)*, *verb*\n\u003e\n\u003e \"to stay in one place in the air\"\n\nHover is a draggable **floating action button** (FAB) inspired by Apple's session [**Designing Fluid Interfaces**](https://developer.apple.com/wwdc18/803) \u0026 Nathan Gitter's [fluid-interfaces](https://github.com/nathangitter/fluid-interfaces). Hover will always stick to the nearest corner to avoid blocking content and allows the user to send it to any other corner with a single swipe.\n\n[![CocoaPods](https://img.shields.io/cocoapods/v/Hover.svg)](https://cocoapods.org/pods/Hover)\n[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)\n[![apm](https://img.shields.io/apm/l/vim-mode.svg)](https://github.com/pedrommcarrasco/Hover/blob/master/LICENSE)\n\n# 📦 Installation\n\n## CocoaPods\nAdd the following line to your `podfile`:\n\n```swift\npod 'Hover'\n```\nAnd then run the following command in terminal:\n\n```swift\npod install\n```\n\n## Carthage\nAdd the following line to your `cartfile`:\n\n```swift\ngithub \"pedrommcarrasco/Hover\"\n```\n\nAnd then run the following command in terminal:\n\n```swift\ncarthage update\n```\n\n## Swift Package Manager\n\nTo include Hover into a Swift Package Manager package, add it to the `dependencies` attribute defined in your `Package.swift` file. For example:\n```\n    dependencies: [\n        .package(url: \"https://github.com/pedrommcarrasco/Hover.git\", from: \u003cversion\u003e),\n    ]\n```\n\n# ⌨️ Usage Example\nAfter installing **Hover**, you should start by importing the framework:\n\n```swift\nimport Hover\n```\n\nOnce imported, you can start using **Hover** like follows:\n\n```swift\n// Create Hover's Configuration (all parameters have defaults)\nlet configuration = HoverConfiguration(image: UIImage(named: \"add\"), color: .gradient(top: .blue, bottom: .cyan))\n\n// Create the items to display\nlet items = [\n    HoverItem(title: \"Drop it Anywhere\", image: UIImage(named: \"anywhere\")) { print(\"Tapped 'Drop it anywhere'\") },\n    HoverItem(title: \"Gesture Driven\", image: UIImage(named: \"gesture\")) { print(\"Tapped 'Gesture driven'\") },\n    HoverItem(title: \"Give it a Star\", image: UIImage(named: \"star\")) { print(\"Tapped 'Give it a star'\") }\n]\n\n// Create an HoverView with the previous configuration \u0026 items\nlet hoverView = HoverView(with: configuration, items: items)\n\n// Add to the top of the view hierarchy\nview.addSubview(hoverView)\nhoverView.translatesAutoresizingMaskIntoConstraints = false\n\n// Apply Constraints\n// Never constrain to the safe area as Hover takes care of that\nNSLayoutConstraint.activate(\n    [\n        hoverView.topAnchor.constraint(equalTo: view.topAnchor),\n        hoverView.bottomAnchor.constraint(equalTo: view.bottomAnchor),\n        hoverView.leadingAnchor.constraint(equalTo: view.leadingAnchor),\n        hoverView.trailingAnchor.constraint(equalTo: view.trailingAnchor)\n    ]\n)\n```\n\nFor more details about all the parameters that you can configure, take a look into [`HoverConfiguration.swift`](https://github.com/pedrommcarrasco/Hover/blob/master/Hover/Model/HoverConfiguration.swift).\n\n# 📲 Sample Project\nThere's a sample project in this repository with some samples of Hover called [Example](https://github.com/pedrommcarrasco/Hover/tree/master/Example).\n\n# ❤️ Support Hover \n\nHello there 👋\n\nI’m Pedro, a Portuguese iOS Engineer since February 2017. I’m an avid OSS enthusiast and contributor - help by sharing, learn by what’s shared.\n\nI've built and open-sourced multiple frameworks and applications, including **[Brooklyn](https://github.com/pedrommcarrasco/Brooklyn)** and **[CocoaHub](https://cocoahub.app)**.\n\nI'm also a conference and meetup organizer, being part of **[SwiftAveiro](https://swiftaveiro.xyz)** and **[CocoaHeads Porto](https://www.meetup.com/CocoaHeads-Porto/)**.\n\nIf you enjoy my work and would like to help me continue it, please consider:\n* https://github.com/users/pedrommcarrasco/sponsorship\n* https://www.buymeacoffee.com/pedrommcarrasco\n* https://www.paypal.me/pedrommcarrasco\n\n# 🙌 Contributing\nFeel free to contribute to this project by [reporting bugs](https://github.com/pedrommcarrasco/Hover/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc) or open [pull requests](https://github.com/pedrommcarrasco/Hover/pulls?q=is%3Apr+is%3Aopen+sort%3Aupdated-desc).\n\nHover was created for personal use but dynamic enough to be an open-source framework. As such, while functional, it may lack some additional customization. If there's something missing that you need, feel free to ask me here or on [Twitter](https://twitter.com/pedrommcarrasco).\n\n# ⛔ License\nHover's available under the MIT license. See the [LICENSE](https://github.com/pedrommcarrasco/Hover/blob/master/LICENSE) file for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpedrommcarrasco%2FHover","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpedrommcarrasco%2FHover","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpedrommcarrasco%2FHover/lists"}