{"id":2473,"url":"https://github.com/joomcode/BottomSheet","last_synced_at":"2025-08-06T14:32:55.472Z","repository":{"id":40605080,"uuid":"431783317","full_name":"joomcode/BottomSheet","owner":"joomcode","description":"Bottom Sheet for iOS","archived":false,"fork":false,"pushed_at":"2024-01-10T14:32:20.000Z","size":134,"stargazers_count":276,"open_issues_count":6,"forks_count":39,"subscribers_count":5,"default_branch":"main","last_synced_at":"2024-05-29T12:29:07.537Z","etag":null,"topics":["bottomsheet","ios","swift","swift-package-manager"],"latest_commit_sha":null,"homepage":"https://medium.com/joomtech/bottom-sheet-shall-we-drop-the-formalities-400515255829","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/joomcode.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2021-11-25T09:19:51.000Z","updated_at":"2024-05-27T03:36:19.000Z","dependencies_parsed_at":"2024-01-10T16:12:48.036Z","dependency_job_id":null,"html_url":"https://github.com/joomcode/BottomSheet","commit_stats":{"total_commits":48,"total_committers":5,"mean_commits":9.6,"dds":0.5,"last_synced_commit":"b847e09e40a833593b29475f2f1c94e8260befe2"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joomcode%2FBottomSheet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joomcode%2FBottomSheet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joomcode%2FBottomSheet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joomcode%2FBottomSheet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joomcode","download_url":"https://codeload.github.com/joomcode/BottomSheet/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228598959,"owners_count":17943265,"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":["bottomsheet","ios","swift","swift-package-manager"],"created_at":"2024-01-05T20:16:14.613Z","updated_at":"2024-12-09T15:30:47.587Z","avatar_url":"https://github.com/joomcode.png","language":"Swift","funding_links":[],"categories":["UI","Libs","Swift"],"sub_categories":["Alert \u0026 Action Sheet","UI"],"readme":"# Bottom Sheet\n\nBottom Sheet component is designed to handle any content, including a scrolling one.\n- ✅ use any content size, and it will adapt\n- ✅ use scrollable content: `UICollectionView`, `UITableView` or `UIScrollView` \n- ✅ dismiss interactively by swipe-down or just tapping on an empty space\n- ✅ build flows inside using `BottomSheetNavigationController`\n    - ✅ supports all system transitions: push and (interactive) pop\n    - ✅ transition animated between different content sizes\n- ✅ Customize appearance:\n    - pull bar visibility\n    - corner radius\n    - shadow background color\n\n## How it looks like\n\n| Adapts to content size | Interactive dismissal |\n| - | - |\n| ![adapt-to-content-size](https://user-images.githubusercontent.com/52037202/164746215-64b61eb3-5813-483f-b639-d730e1cbec8c.gif) | ![interactive-dismissal](https://user-images.githubusercontent.com/52037202/164746241-2fa6ec19-eaae-4fcc-9036-9119df68da54.gif) |\n\n### NavigationController inside Bottom Sheet\n\n| Push and pop transitions | Interactive pop transition |\n| - | - |\n| ![system-push-pop](https://user-images.githubusercontent.com/52037202/164747115-cddbe4fb-403f-4333-994b-64545a7f9a28.gif) | ![interactive-pop](https://user-images.githubusercontent.com/52037202/164746311-74f0c872-3255-4ae5-b895-8c96d7cffb2c.gif) |\n\n## Installation\n\n### Swift Package Manager\n\nTo integrate Bottom Sheet into your Xcode project using Swift Package Manager, add it to the dependencies value of your `Package.swift`:\n\n```swift\ndependencies: [\n    .package(url: \"https://github.com/joomcode/BottomSheet\", from: \"2.0.0\")\n]\n```\n\n### CocoaPods\n\n[CocoaPods](http://cocoapods.org) is a dependency manager for Cocoa projects. You can install it with the following command:\n\n```bash\n$ bundle install\n```\n\nTo integrate BottomSheet into your Xcode project using CocoaPods, specify it in your `Podfile`:\n\n```ruby\nsource 'https://github.com/CocoaPods/Specs.git'\nuse_frameworks!\n\ntarget '\u003cYour Target Name\u003e' do\n    pod 'BottomSheet', :git =\u003e 'https://github.com/joomcode/BottomSheet'\nend\n```\n\n## Getting started\n\nThis repo contains [demo](https://github.com/joomcode/BottomSheet/tree/main/BottomSheetDemo), which can be a great start for understanding Bottom Sheet usage, but here are simple steps to follow:\n1. Create `UIViewController` to present and set content's size by [preferredContentSize](https://developer.apple.com/documentation/uikit/uiviewcontroller/1621476-preferredcontentsize) property\n2. (optional) Conform to [ScrollableBottomSheetPresentedController](https://github.com/joomcode/BottomSheet/blob/81b0e2a7d405311b8456649452a8c49098490033/Sources/BottomSheet/Core/Presentation/BottomSheetPresentationController.swift#L12-L14) if your view controller is list-based\n3. Present by using [presentBottomSheet(viewController:configuration:)](https://github.com/joomcode/BottomSheet/blob/1870921364ed2cd68d51d7e7837e16e692278ff5/Sources/BottomSheet/Core/Extensions/UIViewController%2BConvenience.swift#L79)\n\nIf you want to build flows, use `BottomSheetNavigationController`\n```Swift\npresentBottomSheetInsideNavigationController(\n    viewController: viewControllerToPresent,\n    configuration: .default\n)\n```\n\nYou can customize appearance passing configuration parameter\n```Swift\npresentBottomSheet(\n    viewController: viewControllerToPresent,\n    configuration: BottomSheetConfiguration(\n        cornerRadius: 10,\n        pullBarConfiguration: .visible(.init(height: 20)),\n        shadowConfiguration: .init(backgroundColor: UIColor.black.withAlphaComponent(0.6))\n    ),\n    canBeDismissed: {\n        // return `true` or `false` based on your business logic\n        true\n    },\n    dismissCompletion: {\n        // handle bottom sheet dismissal completion\n    }\n)\n```\n\n## Resources\n\nRead the [article on Medium](https://medium.com/me/stats/post/400515255829) for betting understanding of how it works under the hood\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoomcode%2FBottomSheet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoomcode%2FBottomSheet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoomcode%2FBottomSheet/lists"}