How pointfreeco/isowords works
Main components
• Shared Modules: These include common models and logic used by both client and server. For example, modules like ClientModels, SharedModels, and various “Helpers” (e.g. DateHelpers, TcaHelpers, etc.) that implement game logic, puzzles, and state management.
• External Services & Dependencies: Indicate external APIs and services leveraged by the app (for example, GameCenter, StoreKit, Push Notifications, and even third-party libraries like SnapshotTesting). Also add the automated App Store screenshots and preview generation (taken from tests).
Relationships and interactions
• Shared logic is used on both ends—for example, the same types defined in SharedModels and ClientModels are used in serialization/deserialization for API communication.
• Within the client, highlight the Composable Architecture: the Store, Reducers, and Effects. Show that different feature modules (game states, onboarding, leaderboards, etc.) communicate via state mutations and dependency injection.
• That many modules are independently testable as seen by the extensive Tests folder, including snapshots and integration tests that span both client and server.
Architectural patterns and design principles
• Composable Architecture (single source of truth; reducers composed from many child reducers).
• Hyper-modularization: Each feature is isolated in its own module (e.g., Sources/ActiveGamesFeature, Sources/GameOverFeature, Sources/VocabFeature, etc.). Emphasize that dependencies are explicit and module boundaries are maintained.
• Shared monorepo for client and server: Emphasize that there is a single code base “client/server monorepo” where common code is shared between both the front-end and back-end.
• Clear separation between UI (built in SwiftUI/SceneKit) and business logic.
Relevant technologies and frameworks
• Swift (the language in which everything is written).
• SwiftUI and SceneKit (UI components).
• The Composable Architecture (for structuring state and effects).
• Swift Package Manager (the Package.swift files at the top level and in modules tie everything together).
• Testing frameworks (SnapshotTesting, and various unit/integration tests).
• Server libraries provided by Point-Free for building the Swift-based server.