NativeAppTemplate-Free-iOS is a modern, comprehensive, and production-ready native iOS app with user authentication and a full CRUD example.
This iOS app is a free version of NativeAppTemplate-iOS (Solo) and NativeAppTemplate-iOS (Team).
The Android version is available here: NativeAppTemplate-Free-Android.
Want this template adapted to your own domain? nativeapptemplate-agent is a Claude Code agent that turns a one-sentence spec (e.g. "a walk-in queue for a barbershop") into a coherent three-platform app — this SwiftUI iOS app, a matching Rails 8.1 API, and a Jetpack Compose Android app — renamed and adapted for you, with validation built in.
NativeAppTemplate-Free-iOS connects to a Rails 8.1 API backend that you run yourself. The backend is open source (MIT) — run it locally on your Wi-Fi or deploy your own, then point the app at it (see Running with the NativeAppTemplate-API on localhost).
Note: There is no shared hosted API. The app still ships with a built-in default of
https://api.nativeapptemplate.com, but that endpoint has been shut down — you must run your own API server and point the app at it.
NativeAppTemplate-Free-iOS uses modern iOS development tools and practices, including:
- 100% Swift
- 100% SwiftUI
- @Observable (iOS 17: streamlined Swift state management)
- SwiftLint
- Simple MVVM Layered Architecture
- Test (Swift Testing)
- Inspired by emitron-iOS
- Onboarding
- Sign Up / Sign In / Sign Out
- Email Confirmation
- Forgot Password
- CRUD Operations for Shops (Create/Read/Update/Delete)
- CRUD Operations for Shops' Nested Resource, Item Tags (Create/Read/Update/Delete)
- Force App Version Update
- Force Privacy Policy Version Update
- Force Terms of Use Version Update
- And more!
NFC tag writing and background tag reading were part of v1 and have been removed from the current version. The full NFC implementation remains available in the v1-with-nfc branch.
The full versions (NativeAppTemplate-iOS (Solo) and NativeAppTemplate-iOS (Team)) include additional advanced features:
- URL Path-Based Multitenancy (prepends
/:account_id/to URLs) - User Invitation to Organizations
- Role-Based Permissions and Access Control
- Organization Switching UI
- Push Notifications via APNs
- iPhone — iOS 26.2+, Portrait mode, Full screen
- iPad — iOS 26.2+, Portrait mode, Full screen
- Mac — Designed for iPad
To get started, clone this repository:
git clone https://github.com/nativeapptemplate/NativeAppTemplate-Free-iOS.gitTo run this app successfully, ensure you have:
- An iOS device or emulator with iOS version 26.2 or higher
Debug builds take the API endpoint from API.xcconfig. Put your own values in API.local.xcconfig next to it (gitignored, so your LAN IP stays out of git):
NATIVEAPPTEMPLATE_API_SCHEME = http
NATIVEAPPTEMPLATE_API_DOMAIN = <your-lan-ip>
NATIVEAPPTEMPLATE_API_PORT = 3000
Only the keys you set override API.xcconfig, whose committed values are examples (http://192.168.1.21:3000). They must match HOST / PORT in the API's .env.
Note: Never use
127.0.0.1,localhost, or0.0.0.0forNATIVEAPPTEMPLATE_API_DOMAIN— those resolve to the iOS Simulator/device itself, not your Mac. Use your Mac's LAN IP (e.g.,192.168.1.6) so the simulator or a physical device can reach the API server.
The values are built into the app's Info.plist, so a Debug build reaches the same API however it is launched: from Xcode, from the Home Screen, on a device after Xcode disconnects, and after iOS relaunches the app because its language was changed in Settings. Environment variables with the same names (NATIVEAPPTEMPLATE_API_*, e.g. set by simctl launch via SIMCTL_CHILD_*) still take precedence; see APIEndpoint in NativeAppTemplateEnvironment.swift.
Release builds always use the code default (https://api.nativeapptemplate.com, which has been shut down), so change APIEndpoint.production to your own API server before shipping a Release build.
SwiftLint runs as part of the build process in Xcode, and errors/warnings are surfaced in Xcode as well. Please ensure that you run SwiftLint before submitting a pull request.
To install SwiftLint using homebrew:
$ brew install swiftlintXcode will automatically run SwiftLint if it is installed.
Contributions are welcome! Please read CONTRIBUTING.md for guidelines on reporting issues, proposing changes, and submitting pull requests.
This project adheres to the Contributor Covenant Code of Conduct. By participating, you are expected to uphold this code.
If you discover a security vulnerability, please follow the disclosure process in SECURITY.md. Do not open public issues for security concerns.
This project is licensed under the MIT License — see LICENSE for details.