Welcome to the documentation for AmbientStatus, a powerful iOS framework for creating custom status indicators and activity spinners. With AmbientStatus, you can easily add visually appealing and customizable status indicators to your app, improving the overall user experience.


To install AmbientStatus in your iOS project, you can use CocoaPods. Simply add the following line to your Podfile:

pod 'AmbientStatus'

Then run the ‘pod install’ command in your project directory to install AmbientStatus to your project.


1. Importing the Framework

In your Swift file, you need to import the AmbientStatus framework using the following line:

import AmbientStatus

2. Creating a Status Indicator

To create a status indicator, you’ll need to create an instance of the AmbientStatusView class:

let statusView = AmbientStatusView(frame: CGRect(x: 0, y: 0, width: 100, height: 100))

The above code creates a status indicator with a width and height of 100 points. You can adjust the size according to your requirements.

3. Customizing the Status Indicator

AmbientStatus provides several customization options to customize the appearance of the status indicator. Here are some examples:

// Change the background color of the status indicator
statusView.backgroundColor = .black

// Set a custom corner radius
statusView.layer.cornerRadius = 10

// Change the color of the activity spinner
statusView.activityIndicator.color = .white

// Customize the size of the activity spinner
statusView.activityIndicator.transform = CGAffineTransform(scaleX: 1.5, y: 1.5)

Feel free to explore more customization options available in the AmbientStatus framework.

4. Displaying the Status Indicator

Once you have created and customized the status indicator, you can display it on your view. Simply add the statusView as a subview to your desired view:


5. Removing the Status Indicator

To remove the status indicator from your view, simply call the following method:


Additional Features

1. Show and Hide Animation

AmbientStatus provides an easy-to-use animation feature to smoothly show and hide the status indicator. To show the status indicator animatedly, use the following method:


Similarly, to hide the status indicator with an animation, use:


2. Changing the Text

You can also add text to the status indicator to display additional information. To set the text, use the following property:

statusView.text = "Loading..."

3. Handling User Interaction

AmbientStatus provides a built-in mechanism to handle user interaction while the status indicator is displayed. You can disable user interaction by setting the following property:

statusView.allowUserInteraction = false

When set to false, user interaction with the underlying views will be disabled while the status indicator is displayed.


Congratulations! You have successfully learned how to integrate and use AmbientStatus in your iOS project. This versatile framework allows you to create visually appealing and customizable status indicators and activity spinners. Feel free to explore the AmbientStatus documentation further to discover more advanced features and customization options. Happy coding!