RippleGames
Install and make Ripple yours, the physics game in SwiftUI + Metal. Version 1.1.0.
A wave puzzle drawn in ink on washi: drop stones, and their rings push gold leaf into a vermilion moon. This guide takes you from download to a running game under your own name. It covers version 1.1.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, Ripple/.
Make it yours
cd Ripple
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 Ripple 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: 60 levels
- Game Center: 2 leaderboards, 18 achievements
- Shop: Pearl packs, Lantern Pack, Hints
- Built on:
GameCore,Feel,GameServices,Shaders,GameUI - Presets:
lacquer,hanami,frost - Swift: 6,768 lines in 76 files
Controls
| Input | What it does |
|---|---|
| Touch the water | Shows a faint ring where the stone will land (turn it off in Settings) |
| Lift your finger | Drops the stone there. Rocks, pads and the bank refuse it |
| Restart (bottom right) | Starts the pool again with every stone back in hand |
| Pause | Resume, start again, spend a hint, or leave |
A stone can follow the last one after 0.15 s. A pool ends when every leaf has sat inside the moon for 0.6 s (cleared), or when you are out of stones and the water has gone still.
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 (two 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.
Structure
App/ @main, the root stage (Metal pond + phase layer), the tab hub, deep links
Features/Play The pool HUD (name, stones, moon rim and count, aim ring, hint marks) and pause
Features/Results Moons landing one by one, pearls, then Next, Again or Gardens
Features/Home Home over the pond that plays itself: continue, tonight's pool, the streak
Features/Gardens Four gardens of fifteen pools, moons per pool, what opens next
Features/Shop Leaves, stones and ponds tried on the live pond, hints, pearl packs, the pack
Features/Settings Sound, music, haptics, aim ring, motion, contrast, colour vision, restore
Modules/GameCore Fixed-step clock, seeded RNG, daily seed, saves, event ring, synth (no game types)
Modules/GameDesign GameTheme tokens, variants and the paper-plate component kit
Modules/RippleKit The simulation (pond, bodies, rules), the solver, the pool bank, the profile
Modules/RippleRender MTKView renderer: surface pass, pond world, post, touch input, quality tiers
Modules/Feel Sound bank (stones, chimes, night ambience, menu music), audio engine, haptics
Modules/GameServices Game Center, StoreKit 2, iCloud sync, reminders
Modules/Session GameSession (phases and low-frequency state) and the JuiceDirector
Widget/ Tonight's Pool widget. Shared/ holds what it shares with the app
Tools/PondLab Swift package that forges, solves and verifies pools from the command line
Design/StyleSpec.md The art direction: tone, shapes, palette, light, type, motion, sound
Tests/ Swift Testing (pond, rules, pool bank, meta) and a UI test of the first poolHow it runs
- The pond (
Pond.step) is a 72 × 144 height field stepped at a fixed 120 Hz in plain Swift, using only add, multiply, divide and square root, so a pool plays out the same on every device. That is what lets the solver's par and the daily leaderboard mean something. - Leaves and pads ride the energy flowing through the water (the slope times how fast the surface is moving), so a ring pushes them outward and two rings meeting can cancel.
- Each frame the height field is uploaded to a small texture; one compute pass smooths it, a second upsamples it four times and works out the slope and curvature, and the world pass draws ink wherever the water curves: crests in ink, troughs as a pale wash. Every ring shows across the whole pond, and the page is blank when the water is still.
- The sim emits
WorldEvents; theJuiceDirectorturns each into its feedback stack (splash, chime pitched by the leaf, haptic, HUD pop), scaled by how rare the event is. - The renderer is mounted once. Menus play over a pond that drops its own stones; pausing dims it but never tears it down.
- The look is a theme: change
GameTheme.ripple(colours, type, radii, motion) and the pond preset, and both the SwiftUI screens and the Metal uniforms follow.
Making pools
Pools live in Modules/RippleKit/Sources/Pools/ as JSON written by PondLab. Each one lists the
moon, rocks, reeds, leaves, pads, par and the solver's stones (used for hints). To make more:
cd Tools/PondLab
swift run -c release pondlab forge gardens 1 # generate and solve garden 1's fifteen pools
swift run -c release pondlab merge # write PoolBank+gardens.swift
swift run -c release pondlab forge daily # the ninety pools the daily rotation draws from
swift run -c release pondlab verify # replay every solution and check it clears at par
swift run -c release pondlab solve 42 # solve one pool and print its stonesPondLab compiles the same RippleKit sources the app uses, so it also runs swift test for the
simulation and meta on macOS or Linux.
Tuning and the difficulty curve are documented in BALANCE.md.
Licenses
Cormorant Garamond and Inter Tight 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.1.0
2026-11-08
- New look: Sumi. The pond is now washi paper and every ring is drawn in ink as it travels (crests in ink, troughs as a pale wash), so the rings show across the whole pond instead of only where they crossed the moon. The moon is a vermilion seal that presses home as the leaves rest in it.
- The renderer smooths the wave field before drawing it, which removes the faint grid and the squared-off look rings had. The simulation, pools and pars are unchanged.
- Ink-wash rocks, brushed reeds, sage lily pads, ink-bloom stones and ink-speck splashes; gold leaf keeps its foil and casts a soft shadow on the paper.
- Paper presets replace the night ponds: Washi, Hanami (blush paper, plum ink) and Indigo (cool paper, indigo ink). Saved choices carry over.
- Screens move to frosted paper plates with ink type and a vermilion primary button; earned moons are small vermilion seals. New app icon and widget to match.
- Cormorant Garamond and Inter Tight now register, so titles are the italic serif and labels Inter Tight (1.0.0 fell back to the system font). The HUD sets the par number in Inter Tight so it sits on the line.
- Fixes: the Stones label no longer wraps beside a two-line pool name, the home title and the shop tabs stay readable over rocks, and rings carry right across the pond before the page clears.
1.0.0
2026-11-05
- First release: a wave puzzle on a still night pond, with SwiftUI meta screens over a Metal pond.
- Tap to drop a stone; its rings bounce off rocks, pass through each other and push gold leaf into the moon's reflection, which bends as the rings cross it.
- Sixty solved pools in four gardens (open water, rocks, reeds that soak rings up, heavy lily pads), with par, three moons per pool and a garden intro card for each new idea.
- Tonight's Pool: one seeded pool a day for everyone, with a streak, a leaderboard and a Home Screen widget.
- Hints that restart the pool with the solver's stones marked in order.
- Shop with six leaves, four stones and three pond presets (Lacquer, Hanami, Frost), tried on the live pond; pearl packs and the Lantern Pack through StoreKit 2, with restore and a local StoreKit configuration.
- Game Center leaderboards and eighteen achievements, iCloud save sync, Game Mode, 120 Hz, thermal tiers, Reduce Motion, contrast and colour-vision options.
- PondLab: a command-line tool that forges, solves and verifies pools with the same simulation the game runs.
- Every sound synthesised on the device; the pond, the leaves and the light drawn in shaders.









