https://github.com/mongodb/template-app-swiftui-todo
Atlas Template Starter App - Use Device Sync from a SwiftUI client application. This repo is generated from source code in https://github.com/mongodb-university/realm-template-apps
https://github.com/mongodb/template-app-swiftui-todo
Last synced: 3 months ago
JSON representation
Atlas Template Starter App - Use Device Sync from a SwiftUI client application. This repo is generated from source code in https://github.com/mongodb-university/realm-template-apps
- Host: GitHub
- URL: https://github.com/mongodb/template-app-swiftui-todo
- Owner: mongodb
- Created: 2022-11-08T03:09:08.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-10T15:15:06.000Z (8 months ago)
- Last Synced: 2025-01-29T09:43:35.337Z (3 months ago)
- Language: Swift
- Homepage: https://github.com/mongodb-university/realm-template-apps
- Size: 30.3 KB
- Stars: 16
- Watchers: 9
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# SwiftUI Template App
A todo list application built with the [Realm Swift SDK](https://www.mongodb.com/docs/realm/sdk/swift/) and [Atlas Device Sync](https://www.mongodb.com/docs/atlas/app-services/sync/).
You can follow along with the [SwiftUI Tutorial](https://www.mongodb.com/docs/atlas/app-services/tutorial/swiftui/) to see how to build, modify, and
run this template app.
This project uses Swift Package Manager (SPM) to load dependencies.
> [!WARNING]
> As of September 2024, Atlas Device SDKs are deprecated. Atlas Device SDKs
> will reach end-of-life and will no longer be maintained by MongoDB on
> September 30, 2025.
>
> The template app in this repository should only be used as a reference for
> the on-device database and not to create a new app based on Device Sync.
> Refer to the [deprecation page](https://www.mongodb.com/docs/atlas/device-sdks/>deprecation/) for details.
## Configuration
For this template app to work, you must ensure that `App/atlasConfig.plist` exists and contains the following properties:
- **appId:** your Atlas App Services App ID.
- **baseUrl:** the App Services backend URL. This should be https://services.cloud.mongodb.com in most cases.
### Using the Atlas App Services UI
The easiest way to use this template app is to log on to [Atlas App Services](https://services.cloud.mongodb.com) and click the **Create App From Template** button. Choose
**Real Time Sync**, and then follow the prompts. While the backend app is being
created, you can download this SwiftUI template app pre-configured for your new
app.
### Cloning from GitHub
If you have cloned this repository from the GitHub
[mongodb/template-app-swiftui-todo](https://github.com/mongodb/template-app-swiftui-todo.git)
repository, you must create a separate App Services App with Device Sync
enabled to use this client. You can find information about how to do this
in the Atlas App Services documentation page:
[Template Apps -> Create a Template App](https://www.mongodb.com/docs/atlas/app-services/reference/template-apps/)
Once you have created the App Services App, replace any value in this client's
`appId` field with your App Services App ID. For help finding this ID, refer
to: [Find Your Project or App Id](https://www.mongodb.com/docs/atlas/app-services/reference/find-your-project-or-app-id/)
### Download the Client as a Zip File
If you have downloaded this client as a .zip file from the Atlas App Services
UI, it does not contain the App Services App ID. You must replace any value
in this client's `appId` field in `App/atlasConfig.plist` with your App Services
App ID. For help finding this ID, refer to:
[Find Your Project or App Id](https://www.mongodb.com/docs/atlas/app-services/reference/find-your-project-or-app-id/)
If you did not replace the App ID, you may see an `Error: unsupported URL` message.
## Run the app
- Open App.xcodeproj in Xcode.
- Wait for SPM to download dependencies.
- Press "Run".
## Issues
Please report issues with the template at https://github.com/mongodb-university/realm-template-apps/issues/new