LeadKit

LeadKit is the iOS framework with a bunch of tools for rapid app development.

This repository contains the following frameworks:

TISwiftUtils - a bunch of useful helpers for Swift development.
TIFoundationUtils - set of helpers for Foundation framework classes.
TIUIKitCore - core ui elements and protocols from LeadKit.
TISwiftUICore Core UI elements: protocols, views and helpers.
TIUIElements - bunch of of useful protocols and views.
OTPSwiftView - a fully customizable OTP view.
TITableKitUtils - set of helpers for TableKit classes.
TIKeychainUtils - set of helpers for Keychain classes.
TIPagination - realisation of paginating items from a data source.
TINetworking - Swagger-frendly networking layer helpers.
TIMoyaNetworking - Moya + Swagger network service.
TIAppleMapUtils - set of helpers for map objects clustering and interacting using Apple MapKit.
TIGoogleMapUtils - set of helpers for map objects clustering and interacting using Google Maps SDK.
TIYandexMapUtils - set of helpers for map objects clustering and interacting using Yandex Maps SDK.
TIAuth - login, registration, confirmation and other related actions

Playgrounds

Create new Playground

cd TIModuleName
nef plaground --name TIModuleName --cocoapods --custom-podfile PlaygroundPodfile

See example of PlaygroundPodfile in TIFoundationUtils

Rename/add pages to Playground

For every new feature in module create new Playground page with documentation in comments. See nef markdown documentation.

Create symlink to nef playground

cd TIModuleName
ln -s TIModuleName.app/Contents/MacOS/TIModuleName.playground TIModuleName.playground

Add nef files to TIModuleName.app/.gitignore

# gitignore nef files
**/build/
**/nef/
LICENSE

Add new playground to pre release script

project-scripts/gen_docs_from_playgrounds.sh:

PLAYGROUNDS="${SRCROOT}/TIFoundationUtils/TIFoundationUtils.app
${SRCROOT}/TIModuleName/TIModuleName.app"

Exclude .app bundles from package sources

SPM

.target(name: "TIModuleName", dependencies: ..., path: ..., exclude: ["TIModuleName.app"]),

Podspec

  sources = 'your_sources_expression'
  if File.basename(Dir.getwd) == s.name # installing using :path =>
    s.source_files = sources
    s.exclude_files = s.name + '.app'
  else
    s.source_files = s.name + '/' + sources
    s.exclude_files = s.name + '/*.app'
  end

Docs:

TIFoundationUtils
- AsyncOperation
Semantic Commit Messages - commit message codestyle.
Snippets - useful commands and scripts for development.

Contributing

Run following script in framework's folder:

./setup

If legacy Source folder needed, build dependencies for LeadKit.xcodeproj.
Make sure the commit message codestyle is followed. More about Semantic Commit Messages.

Installation

SPM

dependencies: [
    .package(url: "https://github.com/TouchInstinct/LeadKit.git", from: "x.y.z"),
],

Cocoapods

source 'https://github.com/TouchInstinct/Podspecs.git'

pod 'TISwiftUtils', 'x.y.z'
pod 'TIFoundationUtils', 'x.y.z'
# ...

Legacy

Code located in root Sources folder and LeadKit.podspec should be treated as legacy and shouldn't be used in newly created projects. Please use TI* modules via SPM or CocoaPods.