working ios game

ios/README.md

@@ -0,0 +1,24 @@
+# Shikaku iOS
+
+This directory contains a native SwiftUI version of the Shikaku puzzle game.
+
+## Open In Xcode
+
+Open `Shikaku.xcodeproj`, choose the `Shikaku` scheme, and run it on an iPhone simulator or your own device.
+
+For sideloading to a personal iPhone, select the `Shikaku` target in Xcode and set your personal Apple developer team under **Signing & Capabilities**. The bundle identifier is currently `com.briannelson.Shikaku`; change it if Xcode says that identifier is already taken for your team.
+
+## Project Shape
+
+- `Shikaku/Core` holds the ported model, generator, and validation rules.
+- `Shikaku/Views` holds SwiftUI drawing and visual styling.
+- `ShikakuTests` covers generation, validation, and player rectangle replacement behavior.
+
+The app target is intentionally small and uses generated Info.plist settings so there is less project metadata to maintain while you are learning Swift and Xcode.
+
+## Current Controls
+
+- Pick grid sizes from `5x5` through `25x25`.
+- Use Draw mode to drag rectangles and Erase mode to remove rectangles by touching them.
+- Zoom with the magnifying-glass buttons, the `100%` reset button, or pinch-to-zoom in the board area.
+- Use Seed to view the current puzzle seed or start a puzzle from a specific seed.