<img src="https://tqtuan1201.github.io/images/TTBaseUIKit-Info-BG-1x.png" alt="TTBaseUIKit Banner" width="100%"/> <h1 align="center">TTBaseUIKit</h1> Build iOS Apps Faster — 100+ Production-Ready Base Views for UIKit & SwiftUI <a href="https://github.com/tqtuan1201/TTBaseUIKit/releases"><img src="https://img.shields.io/badge/version-2.3.0-blue.svg" alt="Version"></a> <a href="https://swift.org"><img src="https://img.shields.io/badge/Swift-5.0+-orange.svg" alt="Swift"></a> <a href="https://developer.apple.com/ios/"><img src="https://img.shields.io/badge/iOS-14%2B-green.svg" alt="iOS"></a> <a href="https://github.com/tqtuan1201/TTBaseUIKit/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-lightgrey.svg" alt="License"></a> <a href="https://cocoapods.org/pods/TTBaseUIKit"><img src="https://img.shields.io/badge/CocoaPods-compatible-red.svg" alt="CocoaPods"></a> <a href="https://swift.org/package-manager"><img src="https://img.shields.io/badge/SPM-compatible-brightgreen.svg" alt="SPM"></a> <a href="https://tqtuan1201.github.io/public/docs/ttbaseuikit/">📖 Documentation</a> • <a href="https://tqtuan1201.github.io/public/docs/ttbaseuikit/getting-started.html">🚀 Getting Started</a> • <a href="https://tqtuan1201.github.io/public/docs/ttbaseuikit/ttbdebugplus.html">🛠 TTBDebugPlus</a> • <a href="https://tqtuan1201.github.io/public/docs/ttbaseuikit/showcase.html">📱 Showcase</a> • <a href="https://tqtuan1201.github.io/public/docs/ttbaseuikit/blog.html">📝 Blog</a>

Overview

TTBaseUIKit is an enterprise-grade iOS framework that eliminates boilerplate and accelerates development by providing 100+ production-ready base views for both UIKit (programmatic) and SwiftUI (declarative). Ship production UI in hours, not days.

Key Numbers

| Metric | Count | |--------|-------| | UIKit Components | 72+ | | SwiftUI Views | 51+ | | AI Agent Skills | 17 | | Production Apps Shipped | 36+ | | Users Reached | 5M+ |

Features

🧱 UIKit Foundation

Production-ready programmatic views with zero Storyboard/XIB dependency:

TTBaseUIViewController, TTBaseUITableViewController, TTBaseUICollectionViewController
TTBaseUIView, TTBaseUILabel, TTBaseUIButton, TTBaseUITextField, TTBaseUITextView
TTBaseUIImageView, TTBaseUIStackView, TTBaseUIScrollView
ViewCodable protocol — structured lifecycle: setupData → makeUI → makeConstraints → bindViewModel
Popup, Notification, Skeleton Loading, Segmented Control, PIN Input, and more
Programmatic Auto Layout helpers — chainable, clean constraint syntax

🎨 SwiftUI Modernity (v2.3.0+)

Full SwiftUI support targeting iOS 14+:

BaseSUIView, BaseSUIText, BaseSUIButton, BaseSUIImage
BaseSUIList, BaseSUIGroup, BaseSUITabView, BaseSUINavLink
BaseSUISlider, BaseSUIToggle, BaseSUITextField, BaseSUIProgress
View modifiers: ttFont(), ttShadow(), ttPadding()
Built-in Shimmer / Skeleton loading animations

🛠 Built-in UI Debug Kit (v2.2.1+)

Activate with a single line — no additional dependencies:

Triple-tap Layout Inspector — visualize constraints and view hierarchy
API Response Log Viewer — inspect request/response data in-app
Screen Capture — annotate screenshots and share with team
Developer Settings Panel — toggle environments, feature flags

LogViewHelper.share.config(
    withDes: "Debug Panel",
    isStartAppToShow: false,
    passCode: ""
).onShow()
// Long-press any screen to open | Triple-tap to inspect layout

🖥 TTBDebugPlus — macOS Companion Debugger

A native macOS app for debugging iOS apps in real-time — live console, network inspector, remote screenshots, and more. Built with SwiftUI.

Requires TTBaseUIKit v2.3.0+. The DebugBridge SDK is bundled automatically.

| Feature | Highlights | |---------|-----------| | 📋 Live Console | Log level filtering, full-text search, JSON inspector, auto-scroll LIVE mode | | 🌐 Network Inspector | JSON Tree Viewer, waterfall timing, cURL & Postman export, API analytics | | 📱 Device Control | Remote screenshot, dark mode toggle, app lifecycle (launch/kill/reset) | | 📊 Performance | CPU, memory, FPS charts, bandwidth monitoring, slow request detection | | 💬 Feedback & Export | Bug reports with annotated screenshots, Postman Collection v2.1, session files |

Architecture: iOS ↔ Bonjour (mDNS) ↔ WebSocket ↔ macOS — zero config, auto-discovery.

Quick Start:

// AppDelegate.swift
#if DEBUG
TTDebugBridge.shared.start()       // Auto-discover macOS app via Bonjour
LogInterceptor.shared.install()    // Auto-forward console logs
#endif

<a href="https://tqtuan1201.github.io/public/docs/ttbaseuikit/apps/TTBDebugPlus-Installer.dmg"><img src="https://img.shields.io/badge/⬇_Download-macOS_(.dmg)-0A84FF?style=for-the-badge&logo=apple&logoColor=white" alt="Download"/></a> 5.8 MB • macOS 14+ • Universal (Apple Silicon + Intel)

📖 Full documentation & SDK integration guide → | 💻 Source Code →

🤖 AI Agent Ready

Pre-configured for modern AI coding assistants:

GitHub Copilot — custom instructions & workspace prompts
Claude Code — CLAUDE.md with project context
Xcode Agent Skills — 17 custom agent skills
Google Gemini — GEMINI.md configuration
OpenAI Codex — codex.md setup

📖 Explore AI Agent Skills →

🎨 Configurable Design System

Control every aspect of your app's appearance globally:

let view = ViewConfig()
view.viewBgNavColor = .systemBlue
view.buttonBgDef    = .systemBlue
view.viewBgColor    = .white

let size = SizeConfig()
size.H_BUTTON = 44.0
size.H_SEG    = 50.0

let font = FontConfig()
font.HEADER_H       = 16
font.TITLE_H        = 14
font.SUB_TITLE_H    = 12

TTBaseUIKitConfig.withDefaultConfig(
    withFontConfig: font,
    frameSize: size,
    view: view
)?.start(withViewLog: true)

| Config | Purpose | Reference | |--------|---------|-----------| | ViewConfig | Colors for buttons, labels, backgrounds, navigation | Global theme | | SizeConfig | Heights, corner radius, icon sizes, spacing | Layout system | | FontConfig | Typography scale: header, title, subtitle, body | Type system |

Installation

Swift Package Manager (Recommended)

Via Xcode:

File → Add Package Dependencies...
Enter URL: https://github.com/tqtuan1201/TTBaseUIKit.git
Select "Up to Next Major" from 2.3.0

Via Package.swift:

dependencies: [
    .package(url: "https://github.com/tqtuan1201/TTBaseUIKit.git", from: "2.3.0")
]

CocoaPods

pod 'TTBaseUIKit'

Carthage

github "tqtuan1201/TTBaseUIKit"

Manual

Clone or download the repository
Add TTBaseUIKit.xcodeproj to your project
Add TTBaseUIKit.framework as an embedded binary (General tab) and target dependency (Build Phases tab)

Quick Start

import UIKit
import TTBaseUIKit

@main
class AppDelegate: UIResponder, UIApplicationDelegate {

    var window: UIWindow?

    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {

        // 1. Configure design system
        let view = ViewConfig()
        let size = SizeConfig()
        let font = FontConfig()
        
        TTBaseUIKitConfig.withDefaultConfig(
            withFontConfig: font,
            frameSize: size,
            view: view
        )?.start(withViewLog: true)

        // 2. (Optional) Enable debug bridge for TTBDebugPlus macOS
        #if DEBUG
        TTDebugBridge.shared.start()
        LogInterceptor.shared.install()
        #endif

        // 3. Set root view controller
        window = UIWindow(frame: UIScreen.main.bounds)
        window?.rootViewController = UINavigationController(
            rootViewController: HomeViewController()
        )
        window?.makeKeyAndVisible()
        
        return true
    }
}

Usage Examples

UIKit — Custom ViewController

import TTBaseUIKit

class HomeViewController: TTBaseUIViewController<TTBaseUIView> {

    let titleLabel = TTBaseUILabel()
    let actionButton = TTBaseUIButton()

    override func viewDidLoad() {
        super.viewDidLoad()
    }
}

extension HomeViewController: TTViewCodable {

    func setupStyles() {
        titleLabel.setText(text: "Welcome")
        actionButton.setText(text: "Get Started")
    }

    func setupCustomView() {
        view.addSubview(titleLabel)
        view.addSubview(actionButton)
    }

    func setupConstraints() {
        titleLabel.setTopAnchor(constant: 20)
        titleLabel.setCenterXAnchor(constant: 0)
        actionButton.setTopAnchor(titleLabel, constant: 16)
        actionButton.setCenterXAnchor(constant: 0)
    }
}

TTBaseUIKit

Install / Use

README