pointfreeco / isowords

Open source game built in SwiftUI and the Composable Architecture.

🎬 www.pointfree.co

This repo contains the full source code for the Point-Free website, a video series exploring advanced programming topics in Swift. The codebase is split into 3 pieces:

• PointFree: This is the core application, and is responsible for routing requests, loading data and rendering HTML and CSS.
• Styleguide: This library contains functions and data types for creating a consistent style across the entire website.
• Server: This is the actual executable server. It uses NIO to handle the low-level server responsibilities, and hands everything else over to the PointFree package.

Getting Started

Interested in a video tour of the code base?

The repo contains an extensive test suite and some playgrounds to explore. To get things running:

• Open up a terminal window and grab the code:

  git clone https://github.com/pointfreeco/pointfreeco.git
  cd pointfreeco

• Make sure cmark is installed. You can install it with Homebrew:

  brew install cmark # or your preferred installation method

• Make sure Postgres is installed and running. It's our database of choice. You can install it with Homebrew:

  brew install postgres # or your preferred installation method
  brew services start postgresql # or your preferred launch method
  make db

  (If you use Postgres.app, EnterpriseDB, or another installation method, please follow some additional instructions in the CPostgreSQL README.)

With the project open in Xcode, you can:

• Run the server locally
  • Select the Server target
  • Run: Command+R
  • Visit http://localhost:8080
• Explore our playgrounds
  • Select the PointFree target
  • Build: Command+B
  • Open a playground!

Some fun things to explore

There're a lot of fun things to explore in this repo. For example:

• We develop web pages in playgrounds for a continuous feedback loop. This is made possible by the fact that the entire server stack is composed of pure functions with side-effects pushed to the boundaries of the application. It allows us to load up any request in isolation, including POST requests, all without ever worrying about doing a side-effect.

• We use snapshot testing to capture full data structures in order to verify their correctness. Not only do we do this in the traditional way of taking screenshots of web pages at various break points (e.g. on iPhone and desktop), but we can also snapshot any entire request-to-response lifecycle (e.g. the POST to a signup page does the correct redirect).

▿ Step
  ResponseEnded

▿ Request
  POST http://localhost:8080/launch-signup

  [email protected]

▿ Response
  Status 302 FOUND
  Location: /?success=true

Xcode Color Theme

Like the color theme we use in our episodes? Run make colortheme to install locally!

Related projects

Point-Free uses a bunch of interesting open-source software:

• 🗺 swift-html: A Swift DSL for type-safe, extensible, and transformable HTML documents.
• 🕸 swift-web: A collection of types and functions for dealing with common web server concerns, such as HTML render, CSS preprocessing, middleware and more.
• 🎶 swift-prelude: Offers a standard library for experimental functional programming in Swift.
• 🏷 swift-tagged: Helps us create strong contracts with our data boundaries, like JSON from GitHub and Stripe, and our PostgreSQL data.
• 📸 swift-snapshot-testing: Powers our testing infrastructure by taking snapshots of various data structures to guarantee the correctness of their output. We use this on everything from middleware to ensure requests are correctly transformed into responses, and even entire web pages to make sure the site looks correct at a variety of sizes (e.g. on iPhone and desktop).

Explore more of our open-source on the Point-Free organization.

Learn More

Brandon gave a talk about most of the core ideas that went into this project at Swift Summit 2017.

Find this interesting?

Then check out Point-Free!

License

The content of this project itself is licensed under the CC BY-NC-SA 4.0 license, and the underlying source code used to format and display that content is licensed under the MIT license.

isowords's Issues

Text truncation issues for onboarding screens with Accessibility text sizes

Hi,

I realize this may have been improved with #8 , but just in case my issue is different I wanted to log it.

I have my phone set to the smallest of the "accessibility" dynamic type sizes, and there are a couple places in the onboarding flow where words are truncated.

I'm super happy overall to see a game like this support Dynamic Type, since games are often difficult to play for low-vision users.

There are other places where text layout isn't always optimal, but they don't affect playability the way truncation does.

Cube is incorrectly sized after rotation on iPad

Describe the bug
If you rotate the iPad while playing isowords, the cube will not be sized the same as if the game was launched in that orientation.

To reproduce

• Launch isowords in landscape on iPad or the simulator

• start a new game

• rotate to portrait

• Launch isowords in portrait on iPad on the simulator

• start a new game

• rotate to landscape

Expected behavior
The cube would be shown without clipping and at the same size as if the app was launched in the given orientation.

Screenshots/video

Environment

• iPad running iOS 14.7.1

Additional context
Similar issues exist if you switch the iPad from full screen into side-by-side multitasking, but there are additional issues with the multitasking UI not covered by this problem. I'll log a separate issue for these.

Gh

unexpected service error: “multiple configured targets of \’CubeCore\’ are being created for iOS Simulator”

--- Solved --- But feel free to comment...

In the spirit of issue #49 I'll ask this question here - but please let me know if you'd prefer I ask it elsewhere (Twitter, StackOverflow, forums.swift.org - where is best?)

I'm interested in using Previews to view some of the available screens. I’m running into an issue I’m sure you had to solve early on in your development:

“unexpected service error: build aborted due to an internal error: planning Failed(“multiple configured targets of \’CubeCore\’ are being created for iOS Simulator”)

I see multiple proposed solutions, from setting the DISABLE_DIAMOND_PROBLEM_DIAGNOSTIC build setting to YES in the app target to converting static libraries to dynamic. What worked best for you?

Various layout issues when iPad app is in compact width

Describe the bug
iPad multitasking is enabled in info.plist, but the app has various layout issues when running side by side in compact width.

This is true even with the cube worldScale fix from #126

To reproduce

• Launch the app on iPad and use multitasking to put the app into compact width.
• rotate the iPad etc etc

Expected behavior
Nothing is clipped and screen width is used effectively. It would probably be most effective if the iPad app in compact width used layout metrics similar to the phone app since compact width sizes are fairly similar.

Screenshots/video

some representative examples.

Environment

• iPad, iOS 14.7.1

I'm working on a PR to use the iPhone layout values when running on iPad in compact width.

Will the `OptionalPaths.swift` be moved to the `CasePaths` package?

Hey guys, awesome work you all doing here.

Just asking, there are any plans to move https://github.com/pointfreeco/isowords/blob/main/Sources/TcaHelpers/OptionalPaths.swift to the CasePaths package?

I need them in a project, for now I just copied the whole file, but would be nice if gets integrated into the CasePaths package.

Thanks and keep doing the great work.

Dr

Android?

Hi, will you make an android version of this?

`isowords` app target missing

Describe the bug

After following the readme instructions, there is no isowords.xcodeproj and the package itself also doesn't contain a isowords application target.

Open the Xcode project App/isowords.xcodeproj.

To run the client locally, select the isowords target in Xcode and run (⌘R).

To reproduce
follow the steps in the readme.

Expected behavior
Be able to build the isowords app standalone

Screenshots/video
If applicable, add screenshots/video to help explain the problem.

Environment

• Device: [e.g. iPhone 12 Pro]
• OS: [e.g. iOS 14]

Additional context
Add any more context about the problem here.

[Feature] - Time limit for multiplayer mode

As described in the title, I think it will be a good feature if we add a time limit for each turn in multiplayer mode. For example, there can be an adjustable time limit of say 1 minute before the person's turn is forfeited.

I will add more design details because I would actually like to work on this, once I get a better understanding of the codebase (just discovered this amazing project today).

isowords is running audio and using battery even when the isowords audio settings have turned audio off.

Describe the bug
Audio is turned off in isowords settings.
Battery in System Settings is showing significant percentage of battery drain and Audio as the load.

To reproduce
Turn audio off, run isowords for a couple of games, go to battery (an hour later) and look at the description.

Expected behavior
If Audio is turned off isowords should be spending zero cpu cycles playing audio. Quick look at the code makes it seem like there aren't any checks for sound off and it just plays the audio with zero volume. You'd hope iOS would be smart about that, but it seems it may not be.

Screenshots/video

Environment

• Device: iPhone 12 Pro
• OS: iOS 15.5
• isowords build 102 (fe7eb2c)

No file prompt when creating new files in the `isowords` local package

Describe the bug
When creating new swift file anywhere inside under the isowords local package, there's no file name prompt, and a new File.swift is instantly created instead. As opposed to creating new file outside the local pacakage, like inside the AppClip folder or Config folder. I've also noticed that I can't use any of my custom Xcode templates.

I've encountered this on my own projects as well and was wondering if you have a workaround for that, other than creating the file outside the local package and then dragging it inside.

To reproduce

1. open App/isowords.xcodeproj
2. Right click on the BottomMenu folder inside isowords -> Sources.
3. Click New File
4. Choose Swift File
5. Click Next

Expected behavior
I expect a file name prompt:

Screenshots/video

Environment

• Xcode Version 13.3.1 (13E500a)

make bootstrap-client does not fetch image assets

Describe the bug
After cloning the repository, running:
make bootstrap-client
and then opening the workspace file and attempting to run the main isowords target produces the following error:
The stickers icon set or app icon set named "AppIcon" did not have any applicable content.

To reproduce

• Clone the repository
• Run make bootstrap-client in terminal
• Open workspace
• Run isowords target
• Build fails

Expected behavior
The app runs in the iOS simulator

Screenshots/video

Environment

• 2016 MacBook Pro 15":
• OS: macOS 11.4

Mostly Empty Project

Cloning the repo is failing, and downloading the zip file results in the same mostly empty project folder.

% tree
.
└── App
    └── AppClip
        ├── AppClip.entitlements
        ├── AppClipApp.swift
        └── Assets.xcassets
            └── AppIcon.appiconset
                └── Contents.json

% git clone https://github.com/pointfreeco/isowords.git
Cloning into 'isowords'...
remote: Enumerating objects: 970, done.
remote: Counting objects: 100% (970/970), done.
remote: Compressing objects: 100% (755/755), done.
remote: Total 970 (delta 202), reused 921 (delta 171), pack-reused 0
Receiving objects: 100% (970/970), 2.04 MiB | 5.25 MiB/s, done.
Resolving deltas: 100% (202/202), done.
git-lfs filter-process: git-lfs: command not found
fatal: the remote end hung up unexpectedly
warning: Clone succeeded, but checkout failed.
You can inspect what was checked out with 'git status'
and retry with 'git restore --source=HEAD :/'

% git status
On branch main
Your branch is up to date with 'origin/main'.

Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
	deleted:    .gitattributes
	deleted:    .github/workflows/ci.yml
	deleted:    .github/workflows/format.yml
	deleted:    .gitignore
        ...

Can't set a custom icon on iPad

When you attempt to set a custom icon from Settings…Appearance on iPad, the first tap on a custom icon will select it, but nothing else will happen. If you tap again, you'll see a confirmation from the system, but the stock icon will be in the dialog box, and the actual icon on device will not be changed.

Exported.mov

When the app attempts to set the custom icon, it fails with an error, which is suppressed by a fire and forget effect

Error Domain=NSCocoaErrorDomain Code=4 "The file doesn’t exist." UserInfo={_LSLine=191, NSUnderlyingError=0x6000031a8210 {Error Domain=LSApplicationWorkspaceErrorDomain Code=-105 "iconName not found in CFBundleAlternateIcons entry" UserInfo={_LSLine=179, NSLocalizedDescription=iconName not found in CFBundleAlternateIcons entry, _LSFunction=-[LSAltIconManager _setAlternateIconName:forIdentifier:withIconsDictionary:error:]}}, _LSFunction=-[LSAltIconManager _setAlternateIconName:forIdentifier:withIconsDictionary:error:]}

I'll submit a PR to update info.plist to register the custom icons for iPad specifically.

Daily Challenge Unlimited button doesn't fade when ending a game immediately

I've started the Daily Unlimited challenge and then ended it without doing anything. Now the game doesn't let me play the challenge again which is fine, but the button isn't faded out.

Mimicking the modular structure of this app

Hi. Love the project and the way it is structured. I have tried to move one of my own apps over to a similar sort of scheme by following the setup of your package file

I am seeing a few flaky CI runs, sometimes testing passes and sometimes it fails.

the failure seems to be related to the resolution of XCTestDynamicOverlay

error: Missing package product 'XCTestDynamicOverlay' 

when I see this locally I can get rid of the issue by clearing my derived data which then prompts Xcode to do its thing and pull the dependencies again.

I know it may be difficult to diagnose without having a copy of my project, but I figure it was worth an ask. Maybe you guys have seen something similar? I am using an almost identical copy of your ci workflow and a paired down set of package dependencies. Hopefully I am missing something small.

Change my user name?

I tried asking via Twitter, but I think my privacy settings were messed up.
I was using the test version of isowords until you released it on the store, and then bought that version.
I notice a lot of people have normal user names, whereas mine is a randomly generated string. Can I change my user name?
If not, it's not a big deal... Alas, I'm afraid my days in the top ten are forever gone!

make bootstrap-client produces multiple fail messages

I'm new to git-lfs and the version bootstrap tried to use caused a segmentation fault. I removed it and reinstalled using brew.
Then I was asked to issue 'git lfs install' when I issued 'git-lfs' with no args. That worked fine.
At this point I am cd-ed into isowords, and issue 'make bootstrap-client':

⚠️ Checking for Git LFS...
✅ Git LFS is good to go!
touch Sources/AppAudioLibrary/Resources/empty.mp3
touch Sources/AppClipAudioLibrary/Resources/empty.mp3
/dev/stdin:173: INSERT failed: UNIQUE constraint failed: words.word
/dev/stdin:236: INSERT failed: UNIQUE constraint failed: words.word
--- for a total of 1468 similar lines

are these normal error messages that can be safely ignored?

Settings.Action.binding actions are not being handled as expected

Describe the bug
It seems like many of the viewStore actions sent within views of the Settings module (e.g. SoundsSettingsView) do not actually do anything within the Settings reducer as I'd expect. Instead, I see in the debug console a message like this:

2022-12-09 17:31:27.590658-0600 isowords[11473:1931144] [ComposableArchitecture] A binding action sent from a view store 
at "SettingsFeature/SoundsSettingsView.swift:22" was not handled. …

  Action:
    Settings.Action.binding(.set(_, 0.6017382))

To fix this, invoke "BindingReducer()" from your feature reducer's "body".

This is very strange because BindingReducer() is indeed within the Settings reducer body.

To reproduce
If I compile isowords in Xcode, run the app, click on the settings button, select the sound button and try and change the value of any of the sound sliders, the sliders actually do not change value.

Expected behavior
I'd expect that the Settings reducer would actually stop at any of the breakpoints I set within it.

Screenshots/video
https://user-images.githubusercontent.com/67525430/206812842-45fda284-78ec-4908-8177-1ab66a1a5015.mov

Environment

• Device: iPhone 14 Simulator
• OS: iOS 16.1
• Xcode: 14.1

Additional context
What is strange is that if I run "SettingsPreview", I do not see this problem.

`make bootstrap-client` fails (words/SQL issue?)

Upon running make bootstrap-client, the console throws the following output:

  ⚠️  Checking for Git LFS...
  ✅ Git LFS is good to go!
touch Sources/AppAudioLibrary/Resources/empty.mp3
touch Sources/AppClipAudioLibrary/Resources/empty.mp3
/dev/stdin:173: INSERT failed: UNIQUE constraint failed: words.word
/dev/stdin:236: INSERT failed: UNIQUE constraint failed: words.word
/dev/stdin:629: INSERT failed: UNIQUE constraint failed: words.word
#...etc...

I've tried prepending sudo as well just in case, but no dice.

(p.s., thanks so much for open-sourcing this! It's a great service to the community.)