https://github.com/mugbug/bricksandtiles

🧱 A composable solution for building reusable lists in Swift/UIKit. As easy as playing with Legos.
https://github.com/mugbug/bricksandtiles

factory hacktoberfest reusable swift uicollectionview uikit uitableview

Last synced: about 1 year ago
JSON representation

🧱 A composable solution for building reusable lists in Swift/UIKit. As easy as playing with Legos.

• Host: GitHub
• URL: https://github.com/mugbug/bricksandtiles
• Owner: mugbug
• License: mit
• Created: 2019-05-26T23:22:02.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2020-10-31T17:56:32.000Z (over 5 years ago)
• Last Synced: 2025-04-30T22:15:47.277Z (about 1 year ago)
• Topics: factory, hacktoberfest, reusable, swift, uicollectionview, uikit, uitableview
• Language: Swift
• Homepage:
• Size: 27.9 MB
• Stars: 32
• Watchers: 2
• Forks: 8
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          
![stability-wip](https://img.shields.io/badge/stability-work_in_progress-lightgrey.svg) ![platforms](https://img.shields.io/badge/platforms-iOS-333333.svg) [![Swift Package Manager compatible](https://img.shields.io/badge/Swift%20Package%20Manager-compatible-brightgreen.svg)](https://github.com/apple/swift-package-manager)

# BricksAndTiles

🧱 A composable solution for building reusable lists in Swift/UIKit. As easy as playing with Legos.

  - [Features](#features)

    - [UITableView](#uitableview)

    - [UICollectionView](#uicollectionview)

    - [UITableView + UICollectionView](#uitableview--uicollectionview)

  - [Installation](#installation)

      - [Swift Package Manager](#swift-package-manager)

      - [CocoaPods](#cocoapods)

  - [Dependencies](#dependencies)

  - [Contributing](#contributing)

  - [Authors](#authors)

## Features

### UITableView

- [x] Static cells

- [x] Draggable cells

![](demoAssets/draggable.gif)

- [x] Cells with actions on slide

![](demoAssets/slide_actions.gif)

- [x] Single selection

![](demoAssets/selectable.gif)

### UICollectionView

- [x] Static collection cells

![](demoAssets/collection.gif)

- [x] Grid collection cells

![](demoAssets/grid.gif)

### UITableView + UICollectionView

- [x] Horizontal list cells

![](demoAssets/horizontal_sliders.gif)

## Installation

_BricksAndTiles_ currently supports these installation options:

#### Swift Package Manager

The [Swift Package Manager](https://swift.org/package-manager/) is a tool for automating the distribution of Swift code and is integrated into the swift compiler.

Once you have your Swift package set up, adding BricksAndTiles as a dependency is as easy as adding it to the dependencies value of your `Package.swift`.

```swift

dependencies: [

    .package(

        url: "https://github.com/mugbug/BricksAndTiles.git", 

        from: "0.0.3"

    ),

]

```

If you're using SPM through Xcode:

1. Go to `File > Swift Packages > Add Package Dependency` 

2. Enter https://github.com/mugbug/BricksAndTiles

3. Choose a rule and submit.

#### CocoaPods

[CocoaPods](https://cocoapods.org) is a dependency manager for Cocoa projects. For usage and installation instructions, visit their website. To integrate BricksAndTiles into your Xcode project using CocoaPods, specify it in your Podfile:

```ruby

pod 'BricksAndTiles', '0.0.3'

```

BricksAndTiles is also available as subspecs:

- For only UITableView features:

```ruby

pod 'BricksAndTiles/TableView', '0.0.3'

```

- For only UICollectionView features:

```ruby

pod 'BricksAndTiles/CollectionView', '0.0.3'

```

## Dependencies

This package depends on [PaintAndBrush](https://github.com/mugbug/PaintAndBrush), which is a super lightweight package with helper extensions for building UIKit views in code.

## Contributing

Any kind of contributions would be highly appreciated! To start contributing, read the [Contributing Guideline](https://github.com/mugbug/BricksAndTiles/blob/master/CONTRIBUTING.md) for info on how to report issues, submit ideas and submit pull requests!

## Authors

- [@mugbug](https://github.com/mugbug)

- [@emmendesf](https://github.com/emmendesf)