A minimal Hotwire Native iOS app: a native shell that shows your Rails app's pages, with Joe Masilotti's Bridge Components already installed. It's the starting point for First Draft's Hotwire Native lessons, and for your own apps.
- Click Use this template → Create a new repository. If you already made one from this
template, give the new one a different name (e.g.
xcode-bridge-components-sandbox). - Clone your new repository to your Mac, e.g.
gh repo clone <your-username>/<your-repo>. - Open
XcodeTemplate.xcodeprojin Xcode, choose an iPhone simulator at the top of the window, and click Run (▶).
The app loads http://localhost:3000, so start your Rails app first. In a Codespace, forward the
port to your Mac with gh codespace ports forward 3000:3000. The simulator shares your Mac's
network, so localhost is your Mac.
App/Delegates/SceneDelegate.swift: thebaseURLand theNavigatorthat loads it.App/Delegates/AppDelegate.swift: registers the Bridge Components and a few Hotwire settings (ourWebViewController, a minimal back button, debug logging).App/Controllers/WebViewController.swift: the screen that shows each web page. It adds a Cancel button to screens that open as modals.App/Resources/Info.plist: allows plainhttptolocalhost(NSAllowsLocalNetworking), and the camera, microphone and photo library usage descriptions that iOS requires before a page's file input can offer the camera (without them, the app is terminated).- Swift packages:
hotwire-native-iosandbridge-components, each set to "Up to Next Minor Version", because minor releases can include breaking changes.
Rename the app and give it your own bundle identifier: in Xcode, select the project, then the
XcodeTemplate target. Change Bundle Identifier on the Signing & Capabilities tab (e.g.
com.yourname.yourapp), and Display Name on the General tab, under Identity. The identifier is
permanent once it has been used with the App Store, so choose it with care. Then point baseURL
at your production URL.
- "Error loading page: Could not connect to the server": the Rails app isn't reachable at
http://localhost:3000on your Mac. Checkbin/devis running and, for a Codespace, that thegh codespace ports forwardcommand is still running. - Moved
Info.plist? Update Build Settings → "Info.plist File", or the build fails.
All files are covered by the MIT license, see LICENSE.txt.