This Package is also available on Gitee. If you find SPM from GitHub is slow, try Gitee.

SwiftBrick is an easy-to-use, feature-rich UI basic framework designed to rapidly build app UI. It includes color assets (all dark mode compatible), base view controllers, reusable cells, UIKit extensions, and utility tools.

• Common ViewController base classes: TableViewController, CollectionViewController, WebViewController, ViewController, SwiftUIVC
• BaseVC protocol: handles navigation bar left/right buttons with closure support
• Smooth navigation bar show/hide transitions between VCs

• Cell base classes & protocols for TableView, CollectionView
• Header/Footer registration for easy reuse
• Reusable protocol eliminates boilerplate registration code

• InsetLabel: UILabel with configurable text insets
• UILineView: Draw solid/dashed lines (horizontal/vertical)

1. Add pod 'SwiftBrick' to Podfile
2. Run pod install or pod update
3. Import import SwiftBrick

Select File > Swift Packages > Add Package Dependency in Xcode, then enter:

https://github.com/jackiehu/SwiftBrick

Drag the SwiftBrick folder from Sources into your project.

import SwiftBrick

// Access screen metrics
let width = Define.screenWidth
let height = Define.screenHeight
let fitW = Define.fitWidth    // e.g., 30 * fitW for adaptive width

// Device detection
if Device.isiPhoneX { /* has notch */ }
if Device.isiPad { /* is iPad */ }

// Haptic feedback
TapBuzz.light()
TapBuzz.success()

// Color helpers
let color = UIColor(r: 255, g: 128, b: 0)
let hexColor = UIColor(hex: 0xFF8000)
let hexStrColor = UIColor("#FF8000")

// Gradient background
view.ss.setBackColor([.red, .blue])

// Auto Layout
view.ss.makeConstraints { maker in
    maker.topAnchor(equalTo: view.ss.safeTopAnchor).offset(20)
    maker.leadingAnchor(equalTo: view.ss.safeLeadingAnchor).offset(16)
    maker.trailingAnchor(equalTo: view.ss.safeTrailingAnchor).offset(-16)
    maker.heightAnchor(44)
}

// Button with closure
button.addTouchUpInSideBtnAction { sender in
    print("tapped")
}

// Navigation bar global setup
UINavigationBar.setBackgroundColor(.white)
UINavigationBar.setTitleColor(.black)
UINavigationBar.setShadowColor(.clear)

// UserDefaults with property wrapper
@UserDefault("username", defaultValue: "guest")
static var username: String?

SwiftBrick includes a comprehensive SKILLS.md file designed for AI assistants. This file provides:

• Complete API reference with bilingual descriptions
• Usage patterns and code examples for every feature
• Architecture overview
• Common implementation patterns

When working with AI coding assistants (like Cursor, GitHub Copilot, or Claude), reference the SKILLS.md file to get accurate SwiftBrick code suggestions:

1. Include the file in your project context

Add SKILLS.md to your AI tool's context or reference it in prompts:

Reference: @SKILLS.md

2. Ask for specific features

Using SwiftBrick, create a TableViewController with custom cells and gradient background.
See SKILLS.md for API reference.

3. Get correct constraint syntax

How do I add Auto Layout constraints with SwiftBrick? Check SKILLS.md Layout section.

4. Verify API usage

What's the correct way to register and dequeue cells in SwiftBrick?
Refer to SKILLS.md Base Cells section.

@SKILLS.md 

Create a HomeVC that:
1. Extends TableViewController with grouped style
2. Has a gradient background (blue to purple)
3. Registers a custom cell
4. Adds a right nav bar button with SF Symbol icon
5. Shows haptic feedback on cell selection