Latest 1.26.0
License Apache License, Version 2.0
Platforms ios 9.3, osx 10.11, watchos 2.2, tvos 9.2, requires ARC
Dependencies CryptoSwift, SwiftyJSON, Alamofire


iOS Client for Para

CocoaPods Compatible
Carthage Compatible
Join the chat at

What is this?

Para was designed as a simple and modular backend framework for object persistence and retrieval.
It helps you build applications faster by taking care of the backend. It works on three levels –
objects are stored in a NoSQL data store or any old relational database, then automatically indexed
by a search engine and finally, cached.

This is the Swift client for Para for iOS, tvOS, macOS and watchOS.

Quick start


For the latest release in CocoaPods add the following to your Podfile:


pod 'ParaClient'

And install it with:

$ pod install

Swift Package Manager

Add ParaClient as a dependency to your Package.swift. For example:

let package = Package(
    name: "YourPackageName",
    dependencies: [
        .Package(url: "", majorVersion: 1)


Initialize the client in your code like so:

import ParaClient
// avoid using the secret key on mobile devices
let client = ParaClient(accessKey: "ACCESS_KEY", secretKey:"")
client.signIn("facebook", providerToken: "fb_access_token", callback: { user in
    if user != nil {
        // success! user is authenticated, JWT token is saved on the device
        // you can now call the API methods

It’s a bad idea to hardcode your Para secret key in your code because it will run in an insecure client-side environment. Instead use the signIn() method to get an access token (JWT) with limited client permissions. Think of it like this: API key+secret = full API access, paraClient.signIn() = limited API access for clients with JWT tokens.
You can have a special user object created just for your iOS app and assign it special permissions so that your app can access a part of the Para API before authenticating another real user. Read the documentation for more information about client permissions.
For granting resource permissions to your client users go to where you can edit your app object and allow your users the call specific API methods.


  • iOS 9.2+ / macOS 10.10+ / tvOS 9.2+ / watchOS 2.2+
  • Xcode 7.3+, Swift 2.2+, CocoaPods 1.0+


Special thanks to Christopher Sexton for porting the
AWS Signature 4 algorithm to Swift.
His code was used in this project and is also licensed under Apache 2.0.


Read the Docs


  1. Fork this repository and clone the fork to your machine
  2. Create a branch (git checkout -b my-new-feature)
  3. Implement a new feature or fix a bug and add some tests
  4. Commit your changes (git commit -am 'Added a new feature')
  5. Push the branch to your fork on GitHub (git push origin my-new-feature)
  6. Create new Pull Request from your fork

For more information see


Apache 2.0

Latest podspec

    "name": "ParaClient",
    "version": "1.26.0",
    "summary": "Para Client for iOS",
    "description": "Para is a simple, modular backend framework for object persistence and retrieval. It helps you build applications faster by taking care of the backend. This is the Swift client for Para.",
    "homepage": "",
    "documentation_url": "",
    "license": {
        "type": "Apache License, Version 2.0",
        "file": "LICENSE"
    "authors": {
        "Alex Bogdanovski": "[email protected]"
    "social_media_url": "",
    "cocoapods_version": ">= 1.0",
    "platforms": {
        "ios": "9.3",
        "osx": "10.11",
        "watchos": "2.2",
        "tvos": "9.2"
    "pod_target_xcconfig": {
        "SWIFT_VERSION": "4.0"
    "source": {
        "git": "",
        "tag": "1.26.0"
    "source_files": [
    "requires_arc": true,
    "dependencies": {
        "CryptoSwift": [],
        "SwiftyJSON": [],
        "Alamofire": []

Pin It on Pinterest

Share This