SPB Git

Repository Public License

14 entries at the root
History

Latest commit docs: README, metrics, privacy, release notes v0.1.0, progress log 6efa340

NameLast commitUpdated
App release tooling, app icon, implementation plan
ArcadeCore integration: rounded SpriteKit labels, queued toasts, end-to-end UI tests
AudioHaptics foundation: project, design system, persistence, audio/haptics, game host and lobby
DesignSystem integration: rounded SpriteKit labels, queued toasts, end-to-end UI tests
docs docs: README, metrics, privacy, release notes v0.1.0, progress log
Games integration: rounded SpriteKit labels, queued toasts, end-to-end UI tests
Persistence foundation: project, design system, persistence, audio/haptics, game host and lobby
Scripts docs: README, metrics, privacy, release notes v0.1.0, progress log
Tests traffic mayhem: three junctions, deterministic sim, prediction, bot, HUD, results and tests
UITests integration: rounded SpriteKit labels, queued toasts, end-to-end UI tests
.gitignore release tooling, app icon, implementation plan
LICENSE screenshots: 32 real simulator captures; brand assets, rights notice
project.yml foundation: project, design system, persistence, audio/haptics, game host and lobby
README.md docs: README, metrics, privacy, release notes v0.1.0, progress log
README.md View source
ORIX Arcade logo



ORIX Arcade icon

# ORIX Arcade

Three original arcade games. One thumb. Fully offline.

Domino City · Dig to Core · Traffic Mayhem —
a native iPhone arcade with no account, no ads, no tracking and no network code.

Author: Simon-Pierre Boucher

iOS iPhone Version Status author

Swift SwiftUI SpriteKit Core Haptics AVFoundation Dependencies

Games Offline Privacy Levels Biomes Junctions Achievements

Build Unit tests UI tests Frame pacing

commits last commit activity language size

About the badges. The build and test badges are static: they state what was run by hand on 2026-11-21 (commands and results in docs/metrics). There is no CI pipeline, so nothing here updates by itself. The frame-pacing figure is a simulator measurement, not a device result. The last row is served live by the git forge.

# Contents

The games · Screenshots · Features · Architecture · Setup · Testing · Measured results · Privacy · Known limitations · Roadmap · Changelog

# The games

Game You do It has
🟧 Domino City Drag back to aim one impulse, release, and watch a miniature skyline topple in a chain reaction. 15 handcrafted levels, each with a stored reference solution; domino runs, crate towers, rolling balls, ramps, a plank bridge, bullseye switches and gates, tar pits, a trampoline, a crane wrecking ball; 2–3 impulses per level; 3-star goals; one-tap restart.
🟩 Dig to Core Hold and drag anywhere to steer a drill that digs down by itself. Collect ore, surface, upgrade, dive deeper — the core is at 1,000 m. Seeded chunk terrain with a guaranteed route; 5 biomes (Loam Gardens, Crystal Caverns, Bone Shale, Magma Veins, Core Mantle); hard rock, steel plates, lava, chaining gas pockets, fuel cells, repair kits, fossils, treasure vaults, 100 m milestones; fuel and hull; 12 upgrades (55 levels); 7 skins.
🟦 Traffic Mayhem Tap a waiting vehicle to send it through the junction; hold to preview its path in green or red. 3 junctions (Four Corners, Main Street, Twin Junction); cars, sports cars, buses, trucks, ambulances; six difficulty stages introduced one at a time; three hearts; streak multiplier up to ×5 and close-call bonus; Endless and 60-second Rush.

# Screenshots

All images are captures of the running app on the iPhone 17 Pro simulator (iOS 26.5), taken with xcrun simctl io … screenshot or by the UI tests while the games' built-in bots played. None is a mock-up. They were scaled to half size for the repository. Full set: docs/screenshots.

Lobby Awards Settings Pause
Lobby with progress Awards Settings Pause menu

Domino City

Level select Aiming (tutorial) Bridge Out Crane Day Results
Domino City level select Domino City aiming Domino City level 6 Domino City level 9 Domino City results

Dig to Core

Hangar Loam Gardens Bone Shale Magma Veins Upgrades Run summary
Dig to Core hangar Loam Gardens Bone Shale Magma Veins Upgrade shop Run summary

Traffic Mayhem

Junction select Four Corners Main Street Twin Junction Rush results
Junction select Four Corners Main Street Twin Junction Rush results

No demo clips are included yet.

# Features

  • Lobby — short skippable logo reveal, three animated game cards with personal best and progress, local dashboard (play time, sessions, awards), recent sessions, "jump back in" after an interrupted game, first-launch welcome, save-recovery notice.
  • Awards — records per game, 23 achievements, session history.
  • Settings — music and effects volumes, haptics, screen-shake strength, visual-effects quality (auto / full / light), reduce motion, high contrast, left-handed pause button, save export / import / reset with confirmation.
  • In every game — tutorial, pause menu with resume / restart / quick audio toggles / quit, automatic pause when the app leaves the foreground, results card with counted-up score, instant retry.
  • Sound and art — every sprite, sound effect and music loop is generated in code; the repository contains no bitmap art and no audio file. Audio uses the ambient session: it follows the silent switch and does not interrupt your own music.
  • Persistence — one versioned JSON save with rolling backup; an unreadable save is set aside, never deleted.

# Architecture

flowchart TD
    App["App<br/>entry, root navigation, lobby, awards, settings"] --> Core
    App --> DS["DesignSystem<br/>tokens, components, backgrounds, logo"]
    Core["ArcadeCore<br/>GameDescriptor, ArcadeServices, SeededRNG,<br/>ArcadeScene, GameChrome, ResultsCard"] --> AH["AudioHaptics<br/>Synth, AudioDirector, HapticsDirector"]
    Core --> P["Persistence<br/>SaveData, SaveCodec, SaveStore"]
    App --> G1["Games/DominoCity"]
    App --> G2["Games/DigToCore"]
    App --> G3["Games/TrafficMayhem"]
    G1 --> Core
    G2 --> Core
    G3 --> Core
    G1 --> DS
    G2 --> DS
    G3 --> DS

Each game follows the same split, which is what makes it testable:

flowchart LR
    Rules["Pure Swift rules<br/>(levels, generation, traffic sim, scoring)"] --> Scene["SpriteKit scene<br/>(ArcadeScene subclass)"]
    Scene --> Views["SwiftUI flow<br/>(menu → play → results)"]
    Views --> Save["Save model<br/>(Codable, tolerant decoding)"]
    Rules --> Tests["Unit tests"]
    Bot["Built-in bot<br/>(-ORIXAutoplay)"] --> Scene
Folder Lines of Swift Role
App/ 756 entry point, navigation, lobby, awards, settings
DesignSystem/ 647 tokens and reusable components
ArcadeCore/ 892 shared game contracts, base scene, in-game chrome
AudioHaptics/ 555 procedural synth, audio and haptics directors
Persistence/ 311 save model and store
Games/DominoCity/ 2,262 physics puzzle
Games/DigToCore/ 2,852 procedural digger
Games/TrafficMayhem/ 2,609 traffic simulation
Tests/, UITests/ 1,715 88 unit tests, 6 UI tests

Decisions and their reasons are in docs/IMPLEMENTATION_PLAN.md.

# Setup

Requirements: Xcode 27 (built with 27.2), XcodeGen, an iOS 18+ simulator or iPhone. No package to resolve, no key, no server.

bash
Scripts/build.sh generate      # writes ORIXArcade.xcodeproj from project.yml
open ORIXArcade.xcodeproj      # scheme ORIXArcade

Platform support: iPhone only, portrait only, iOS 18.0 or later, dark appearance only. English only.

Useful launch arguments (Debug and Release): -ORIXGame dominoCity|digToCore|trafficMayhem, -ORIXAutoplay YES, -ORIXSeed 42, -ORIXLevel N, -ORIXDive YES, -ORIXLayout N -ORIXMode endless|rush, -ORIXSaveName name, -ORIXReset YES, -ORIXSkipIntro YES, -ORIXMute YES, -ORIXPerfLog YES.

# Testing

bash
Scripts/build.sh build         # simulator build
Scripts/build.sh test          # unit tests (scoring, generation, traffic fairness, persistence, physics solutions)
Scripts/build.sh uitest        # UI tests (launch, each game: start, pause, resume, restart, quit, finish, relaunch)
Scripts/screenshots.sh         # real captures + frame-time logs
Scripts/secret-scan.sh         # refuses keys, profiles and tokens in tracked files
Scripts/release.sh archive|export|validate|upload

The scripts create a dedicated simulator named "ORIXArcade iPhone" (override with ORIX_SIM).

# Measured results

Simulator only — see docs/metrics/2026-11-21-simulator.md for the environment, the raw logs and everything that was not measured.

Metric Target Measured (simulator, 2026-11-21) On an iPhone
Frame pacing 60 fps 58.5–60.0 fps average, p95 16.67 ms in every scene not measured
Memory footprint — 38 MB lobby, 40–53 MB in game (peak 84 MB) not measured
Unit tests all pass 88 run, 0 failed, 1 skipped —
UI tests all pass 6 run, 0 failed —
Domino City solvability 15 / 15 15 / 15 cleared by the bot in the real app —
Cold launch, battery, thermals — not measured not measured

# Privacy

Nothing is collected. No account, no analytics, no ads, no network code, no permission prompt. Progress lives in one file in the app's container and leaves it only through Settings › Export save. Details: docs/PRIVACY.md.

# Known limitations

  • Never run on a physical iPhone. Touch feel, haptics, speaker output, 120 Hz and real frame rates are unverified. All gameplay verification was done by bots on the simulator; no human playtest has tuned the difficulty.
  • Domino City uses SpriteKit physics, which is reproducible in practice but not bit-exact; several levels were confirmed only at their reference shot. Any level can also be cleared with a direct lob onto the target, for fewer stars.
  • Traffic Mayhem: an idle player can lose all three hearts within seconds of each other; the top difficulty was tuned by estimate.
  • Dig to Core: once every upgrade is bought, credits have no further use.
  • The games themselves are not playable with VoiceOver (menus, results and settings are labelled). Small-screen layouts and Dynamic Type extremes were not checked.
  • English only. No iPad layout. No demo video.
  • Resuming restores the game you were in, not the exact moment of an interrupted run.

# Roadmap

  1. Device pass on an iPhone: feel, haptics, audio mix, frame rates, thermals; then difficulty tuning from real play.
  2. French localisation.
  3. Daily seeded challenges for Dig to Core and Traffic Mayhem.
  4. More Domino City blocks and a level-solution tolerance sweep at 120 Hz.
  5. Mid-run resume for Dig to Core.

# Changelog

  • 0.1.0 (1) — 2026-11-21 — first milestone: lobby, awards, settings, Domino City, Dig to Core, Traffic Mayhem. Release notes.

# Author

Simon-Pierre Boucher — spboucher.ai — contact@spboucher.ai

© 2026 Simon-Pierre Boucher. All rights reserved; see LICENSE.

Clone orix-arcade

Anonymous clone and fetch. Pushing requires the owner's personal access token.

Snapshot of main

Files main
Menu

Theme