ParlourGames
Install and make Parlour yours, the puzzle game in SwiftUI + Metal. Version 1.0.0.
Card patience on a linen table, in window light that follows the clock, with a daily deal a solver has already won. This guide takes you from download to a running game under your own name. It covers version 1.0.0. See the screens on its game page.
Requirements
- Xcode 26 and an iOS 17.0 or later deployment target
- Tuist 4 (
brew install tuist) - An Apple Developer team for devices, Game Center, iCloud and the widget. The simulator runs without one.
Install
Download
Included with Games. Not signed in? The button takes you to sign in or create an account, then starts the download when you're back. Unzip the archive; it contains one folder, Parlour/.
Make it yours
cd Parlour
scripts/setup.sh --name YourGame --bundle-id com.you.yourgameThe script renames the target, scheme and bundle ids, rewrites the StoreKit product ids and runs tuist generate. To keep the name Parlour for now, run tuist generate instead.
Run it
Open YourGame.xcworkspace, choose an iPhone simulator and run the YourGame scheme. The scheme uses Configuration/Products.storekit, so the shop works before App Store Connect is set up.
What's in the project
- Content: Endless, with a tuned curve
- Game Center: 3 leaderboards, 18 achievements
- Shop: Gilt purses, Collector's Cabinet (card backs and a cloth)
- Built on:
GameCore,Feel,Economy,GameServices,Shaders,Motion,GameUI - Presets:
linen,walnut,rosewater - Swift: 5,616 lines in 55 files
Rebrand options
| Option | What it sets |
|---|---|
--name | Target, scheme and product name |
--bundle-id | Bundle id. Modules, the widget, the App Group (group.<bundle-id>) and tests derive theirs from it |
--display-name | The name under the icon |
--team | Your team id. Required for devices, Game Center, iCloud and the widget's App Group |
--product-prefix | App Store Connect product ids. Defaults to the bundle id |
The values live in Tuist/ProjectDescriptionHelpers/AppConfig.swift. Game Center ids are listed in
Configuration/GameCenter.json (three leaderboards, eighteen achievements); create them under your
app in App Store Connect. Products are in Configuration/Products.storekit, which the scheme uses
for local purchases.
The games
- Parlour (turn one or turn three). Seven rows, the first card of each face up. Build down in alternate colours; move any face-up run; only a king starts an empty row. Tap the stock to turn cards onto the waste; when it runs out, tap again to turn the waste back. Suits go up from the ace on the four foundations.
- Conservatory. All 52 cards are dealt into eight rows of seven and six; the top four of each row are face up. Three cells on the window sill hold one card each, and any card may start an empty row. Runs move as far as free space allows (cells plus one, doubled for each empty row), so it's a game of planning rather than luck.
- Daily deal. Parlour turn one through the week and Conservatory on Sundays, the same deal for everyone (UTC days). Past days can be played from the calendar; only today's keeps the streak.
Structure
App/ @main, the one stage (table + phase layer + panels), deep links, the widget feed
Features/Title The title: wordmark, today's deal, free play, the menus drawer
Features/Play The header, the table, Undo · Hint · Deal, the pause menu
Features/Results The gilt seal, time, moves, payout, achievements, share
Features/Daily The calendar of daily deals and streaks
Features/Record Stats per game, achievements, leaderboards
Features/Cabinet Card backs and cloths for gilt, the Collector's Cabinet, gilt purses
Features/Settings Game rules, the room, sound, accessibility, reminder, restore
Features/Onboarding How to play, the reminders ask
Modules/GameCore Seeded RNG, daily seed, versioned saves, rate limiter, easing, synth (no game types)
Modules/ParlourKit Cards, rules for both games, the solver, deals, the game record, profile, economy
Modules/CardEngine The reusable card table: layout, dealing, drag and drop, tap to move, hints, the win fan
Modules/ParlourDesign Theme presets, card faces and backs, the table shader, the component kit, fonts
Modules/Feel Sound bank, audio engine, haptic patterns
Modules/GameServices Game Center, StoreKit 2, iCloud sync, reminders
Modules/Session GameSession: phases, panels, the clock, moves, hints, saving
Widget/ The daily deal widget. Shared/ holds what it shares with the app
Design/StyleSpec.md The art direction: light, cloth, cards, type, motion, sound
Tests/ Swift Testing (rules, solver, game, layout, sound) and UI testsHow it runs
- The rules are plain Swift (
Spread,Move,Game). A game is a deal plus the moves played on it, replayed to get the table, so undo is "drop the last move" and a save is a few hundred bytes. Solveris a depth-first search over the full table with forced safe moves, ordered candidates (best-first for Conservatory), and a transposition table that treats rows as interchangeable. It's capped by a node budget, which keeps it fast (about 0.1 s a deal) and deterministic, so the daily is the same on every phone. It runs off the main actor and is compiled-Oeven in Debug.CardTableViewkeys every card by id and lays them out withTableLayout, so a model change animates each card from where it was to where it now belongs and flips turn over in 3D. Drop targets come from the same geometry. Use it for any patience built onSpread.- The table is one
[[stitchable]]shader: the cloth (linen weave, oiled walnut, felted wool), the window panes leaning with the sun, leaf shadows from a plant on the sill, and a lamp pool after dark.TableLight.now()maps the time of day to the light; card shadows and the foil highlight follow it. - The look is a theme:
ParlourTheme.linen,.walnutand.rosewaterhold every colour, face and motion token; screens read@Environment(\.parlour).
Gilt, payouts and prices are documented in BALANCE.md.
Launch arguments
-SPNoAudio skips the audio engine, -SPSkipOnboarding skips the first-run cards. In Debug,
-SPScreen play|conservatory|daily|record|cabinet|settings|howto|results opens a screen after
launch and -SPHour 18.5 pins the window light to an hour, for screenshots.
Licenses
Libre Caslon Text and Figtree are under the SIL Open Font License 1.1 (Licenses/). Everything
else in the project is yours to ship with your game. See ASSET_MANIFEST.md.
Changelog
1.0.0
2026-11-05
- First release: card patience on a linen table in window light that follows the clock, with cream cotton cards and gold-foil courts.
- Two games on one card engine: Parlour (turn one or turn three) and Conservatory, Parlour's own patience with every card dealt and three cells on the window sill.
- A solver checks every daily deal before it's dealt, and every free deal unless you turn it off, so they can be won.
- Daily deal for everyone with a streak, a calendar of past days, Sunday Conservatory and a Home Screen widget.
- Drag a card or a run, or tap and it finds its place; undo, solver hints, auto-finish and an option to send safe cards home.
- A record book with stats for each game and eighteen achievements.
- The Cabinet: eight card backs and six cloths bought with gilt from wins, the Collector's Cabinet and gilt purses in StoreKit 2.
- Three rooms (Linen, Walnut, Rosewater), a left-handed table, Reduce Motion and Increase Contrast.
- Game Center leaderboards and achievements, iCloud save sync, Game Mode and 120 Hz.
- Every sound synthesised on the device: card stock on linen, a celesta that climbs as suits go home, a riffle for the deal and a waltz on the menus.









