isowords

# isowords

[![CI](https://github.com/pointfreeco/isowords/actions/workflows/ci.yml/badge.svg)](https://github.com/pointfreeco/isowords/actions/workflows/ci.yml)

This repo contains the full source code for [isowords](https://www.isowords.xyz), an iOS word search game played on a vanishing cube. Connect touching letters to form words, the longer the better, and the third time a letter is used its cube is removed, revealing more letters inside!

Available on the [App Store](https://www.isowords.xyz/app-store) now!

[![Download isowords on the App Store](https://dbsqho33cgp4y.cloudfront.net/github/app-store-badge.png)](https://www.isowords.xyz/app-store)

[![isowords screenshots](https://dbsqho33cgp4y.cloudfront.net/github/isowords-screenshots.jpg)](https://www.isowords.xyz/app-store)

---

* [About](#about)
* [Getting Started](#getting-started)
* [Learn More](#learn-more)
* [Related Projects](#related-projects)
* [License](#license)

# About

[isowords](https://www.isowords.xyz) is a large, complex application built entirely in Swift. The iOS client's logic is built in the [Composable Architecture](https://github.com/pointfreeco/swift-composable-architecture) and the UI is built mostly in SwiftUI with a little bit in SceneKit. The server is also built in Swift using our experimental web server libraries.

We published a [4-part series of videos](https://www.pointfree.co/collections/tours/isowords) covering these topics and more on [Point-Free](https://www.pointfree.co), a video series exploring functional programming and the Swift language, hosted by [Brandon Williams](https://twitter.com/mbrandonw) and [Stephen Celis](https://twitter.com/stephencelis).

<a href="https://www.pointfree.co/collections/tours/isowords">
  <img alt="video poster image" src="https://d3rccdn33rt8ze.cloudfront.net/episodes/0169.jpeg" width="600">
</a>

<br><br>

Some things you might find interesting:

### The Composable Architecture

The whole application is powered by the [Composable Architecture](https://github.com/pointfreeco/swift-composable-architecture), a library we built from scratch on [Point-Free](https://www.pointfree.co/collections/composable-architecture) that provides tools for building applications with a focus on composability, modularity, and testability. This means:

* The entire app's state is held in a single source of truth, called a `Store`.
* The entire app's behavior is implemented by a single unit, called a `Reducer`, which is composed out of many other reducers.
* All effectful operations are made explicit as values returned from reducers.
* Dependencies are made explicit as simple data types wrapping their live implementations, along with various mock instances.

There are a ton of benefits to designing applications in this manner:

* Large, complex features can be broken down into smaller child domains, and those domains can communicate via simple state mutations. Typically this is done in SwiftUI by accessing singletons inside `ObservableObje