List of example applications built using Suas
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
AsyncActionExample
CounterExample
SuasExamples.xcodeproj
SuasExamples.xcworkspace
TodoAppExample
TodoAppWithSettingsExample
misc
.gitignore
CONTRIBUTING.md
LICENSE
Podfile
Readme.md

Readme.md

License Join the chat at https://gitter.im/SuasArch/Lobby

Analytics

Suas iOS Example Apps

This repository contains a list of applications built using Suas.

What is Suas

Suas is a unidirectional data flow architecture implementation for iOS/macOS/tvOS/watchOS and Android heavily inspired by Redux. It provides an easy-to-use library that helps to create applications that are consistent, deterministic, and scalable.

Suas focuses on providing good developer experience and tooling such as customizable logging and state changes monitoring.

Join our gitter chat channel for any questions. Or check Suas documentatation website.

Requirements

Installation

Get the required dependencies using CocoaPods using:

pod install

Examples In This Repo

This repo contains an Xcode project with 4 sample apps

Counter App Example

Example application with a label that displays the counter values and two buttons to increment and decrement the counter.

This example shows the simplest possible Suas application.

Todo App Example

Example application that shows adding todo items and editing them; like removing and reordering items.

This example shows multiple actions. And show how to consume the state in a table view.

Search Cities Example

Example application that searches for a list of cities from the network.

This example shows:

Todo app with settings example

Example application that contains two screens; todo screen that shows a list of todos, and settings screen that shows the application settings.

This example shows:

  • How to model an app with multiple states .
  • How to create a store with multiple reducers.
  • How to listen to changes in multiple states.
  • How to use the StateSelector.

Using Suas monitor

Some of the sample apps also use Suas Monitor middleware to send the state and actions to Suas Monitor Desktop.

Head to Suas Monitor Desktop GitHub page for installation instruction.

After installing Suas Monitor app you can start visualizing your application state.

Check Suas Monitor and the MonitorMiddleware documentation page for more in-depth information.

Where to go next

To get more information about Suas:

Contributing

We love any sort of contribution. From changing the internals of how Suas works, changing Suas methods and public API, changing readmes and documentation topics.

Feel free to suggest changes on the GitHub repos or directly in Saus gitter channel.

For reference check our contributing guidelines.

Contact us

Join our gitter channel to talk to other Suas developers.

For any question, suggestion, or just to say hi, you can find the core team on twitter:

Suas future

To help craft Suas future releases, join us on gitter channel.

Copyright and license

Copyright 2017 Zendesk, Inc.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.