Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
A collection of iOS classes for making life easier
Objective-C C Python
Branch: master
Pull request Compare This branch is 2 commits ahead, 460 commits behind soffes:master.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
Documentation
Other Sources
Resources/SSToolkit.bundle
SSCatalog
SSToolkit.xcodeproj
SSToolkit
.gitignore
LICENSE
Readme.markdown

Readme.markdown

SSToolkit

SSToolkit makes life easier. It is made up of various view controllers, views, and categories that I use in all of my apps. Feel free to fork the repo and make it better.

If you're using this in your project, I'd love to hear about it! Send me an email and let me know which pieces you're using and such.

Classes

Views

  • SSCollectionView - simple collection view modeled after UITableView and NSCollectionView
  • SSGradientView - easily create gradients with optional borders and insets
  • SSHUDView - simple heads-up display
  • SSLabel - ever wanted to align your text to the top or the bottom
  • SSLineView - easily create lines with an inset
  • SSLoadingView - flexible loading view
  • SSPieProgressView - pie chart style progress bar similar to the one in Xcode's status bar
  • SSTextField - simply add edge insets
  • SSWebView - handy delegate additions and control over shadows and scroll
  • SSBadgeTableViewCell - badge accessory view for table cells, similar to Mail.app unread counts

Controls

View Controllers

Misc

Categories

Several categories are included and used throughout SSToolkit.

Adding SSToolkit to your project

  1. Run the following command to add the submodule. Be sure you have are you in the root of your git repository.

    $ git submodule add git://github.com/samsoffes/sstoolkit.git Frameworks/SSToolkit
    
  2. In Finder, navigate to the Frameworks/SSToolkit folder and drag the xcodeproj file into the Frameworks folder in your Xcode project.

  3. In Finder, drag SSToolkit.bundle located in Frameworks/SSToolkit/Resources into the Resources folder in your Xcode project.

  4. Select the SSToolkit Xcode project from the sidebar in Xcode. In the file browser on the right in Xcode, click the checkbox next to libSSToolkit.a. (If you don't see the file browser, hit Command-Shift-E to toggle it on.)

  5. Select your target from the sidebar and open Get Info (Command-I).

  6. Choose the General tab from the top.

  7. Under the Direct Dependencies area, click the plus button, select SSToolkit from the menu, and choose Add Target.

  8. Choose the build tab from the top of the window. Make sure the configuration dropdown at the top is set to All Configurations.

  9. Add Frameworks/SSToolkit to Header Search Path (do not click the Recursive checkbox).

  10. Add -all_load -ObjC to Other Linker Flags.

Usage

To use SSToolkit, simply add the following line to your source file.

#import <SSToolkit/SSToolkit.h>

You can add this to your prefix to make things easy if you want. You can also import individual files instead of the whole framework (for faster compile times) by doing something like:

#import <SSToolkit/SSLoadingView.h>

If you are going to use SSToolkit's categories, you will need to import then separately (since some people might not want to use them). You import then like this:

#import <SSToolkit/SSCategories.h>

Demo

SSCatalog is included with SSToolkit. There is an iPhone application target and an universal iPad/iPhone application target to demonstrate the various features of SSToolkit.

Links

Other Libraries

Here are some related libraries. Some of these used to be part of SSToolkit.

  • SSZipArchive - Cocoa library for easily unzipping files.
  • SSKeychain - Cocoa library for making working with the keychain less sucky.
  • SSOAuthKit - iOS library for working with OAuth 1.0 provider with easy view controllers for getting a Twitter access token.
  • SSTableViewCell - iOS UITableViewCell based on ABTableViewCell.
  • SSMessagesViewController - iOS Messages.app style table view controller.

Thanks

Huge thanks to our contributors, Jake Marsh, and Mike Rundle.

Something went wrong with that request. Please try again.