[FTF-283] Add getting started guide for APNs for swift. by maratal · Pull Request #3147 · ably/docs

maratal · 2026-01-22T17:01:50Z

Description

Checklist

Commits have been rebased.
Linting has been run against the changed file(s).
The PR adheres to the writing style guide and contribution guide.

coderabbitai · 2026-01-22T17:02:04Z

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

🔍 Trigger a full review

✨ Finishing touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Post copyable unit tests in a comment
Commit unit tests in branch FTF-283-apns-swift-guide

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

AndyTWF · 2026-01-28T10:22:27Z

src/pages/docs/push/getting-started/apns.mdx

+
+### Create a Swift project with Xcode <a id="prerequisites-create-project"/>
+
+Create a new iOS project with SwiftUI. For detailed instructions, refer to the [Apple Developer documentation](https://developer.apple.com/documentation/swiftui).


How much detail do we want here? I think we should probably assume that someone knows how to setup a Swift project, so we perhaps cut this down to just making sure you've got ably-cocoa installed? cc @m-hulbert

AndyTWF · 2026-01-28T10:26:31Z

src/pages/docs/push/getting-started/apns.mdx

+```swift
+// MARK: - UNUserNotificationCenterDelegate Methods
+
+/// Handle notification when app is in foreground


Should we be elaborating on handling background notifications?

AndyTWF · 2026-01-28T10:28:38Z

src/pages/docs/push/getting-started/apns.mdx

+```
+</Code>
+
+To receive messages on the channel as push notifications, you need to subscribe to the push notifications


I think it would be good to discuss explicitly here that there are two ways of doing push notifications - direct and channel-based. Perhaps covering (very briefly) when you'd use each, and highlighting that for direct you don't need explicit subscriptions?

AndyTWF · 2026-01-28T10:54:27Z

src/pages/docs/push/getting-started/apns.mdx

+```
+</Code>
+
+To test this code, you can send push notifications from the Ably dashboard or using the API (see the next step).


All of our other guides lean into the CLI here, so I think we put that first. Lets add CLI installation to the prerequisite of the guide?

AndyTWF · 2026-01-28T10:55:16Z

src/pages/docs/push/getting-started/apns.mdx

+```
+</Code>
+
+You can also send push notifications by publishing a message with a `push` message's `extras` field to a specific channel:


I think we perhaps need a specific call out in the guide about there being two ways to do push (see above comment)

AndyTWF · 2026-01-28T10:56:58Z

src/pages/docs/push/getting-started/apns.mdx

+`LocationPushService.swift` file in your extension target.
+Use `locationManager(_:didUpdateLocations)` delegate method to handle location updates as needed.
+
+## Step 6: Displaying the results <a id="step-6"/>


Should displaying it come earlier in the guide, so that people can see results as they go?

AndyTWF · 2026-01-28T10:57:30Z

src/pages/docs/push/getting-started/apns.mdx

+
+Continue to explore the documentation with Swift as the selected language:
+
+* Check our push example: [AblyPushExample](https://github.com/ably/ably-cocoa/tree/main/Examples/AblyPush)


Suggested change

* Check our push example: [AblyPushExample](https://github.com/ably/ably-cocoa/tree/main/Examples/AblyPush)

* Check our [push example](https://github.com/ably/ably-cocoa/tree/main/Examples/AblyPush)

GregHolmes

Other than Andy's comments, and my 1 below. I've also got this recommendation, that we update the Step headings to be inline with the other guides:

Step 1: Set up Ably
Step 2: Set up push notifications
Step 3: Receive push notifications
Step 4: Send push notifications
Step 5: Enable location pushes
Step 6: Display the results

GregHolmes · 2026-01-28T17:28:07Z

src/pages/docs/push/getting-started/apns.mdx

+
+## Step 6: Displaying the results <a id="step-6"/>
+
+Now, lets complete our `ContentView` to display all the results of everything we added above.


Suggested change

Now, lets complete our `ContentView` to display all the results of everything we added above.

Now, let's complete our `ContentView` to display all the results of everything we added above.

maratal · 2026-01-30T13:48:42Z

@AndyTWF @GregHolmes I've addressed your comments and added more info, please read commit messages for details. I guess Ably dashboard and CLI don't yet support location pushes, is it something manageable rather soon? Otherwise I need to remove the line saying that "Use Ably dashboard, Apple dashboard, or Ably CLI to send location push notifications to your device" (Apple dashboard supports location pushes).

maratal added the review-app Create a Heroku review app label Jan 22, 2026

ably-ci temporarily deployed to ably-docs-ftf-283-apns--sjxyp7 January 22, 2026 17:02 Inactive

maratal force-pushed the FTF-283-apns-swift-guide branch from 7c4bab8 to 9f94a7f Compare January 26, 2026 01:27

ably-ci temporarily deployed to ably-docs-ftf-283-apns--sjxyp7 January 26, 2026 01:27 Inactive

maratal force-pushed the FTF-283-apns-swift-guide branch from 9f94a7f to 3feba8d Compare January 27, 2026 00:58

ably-ci temporarily deployed to ably-docs-ftf-283-apns--sjxyp7 January 27, 2026 00:58 Inactive

maratal force-pushed the FTF-283-apns-swift-guide branch from 3feba8d to b482d42 Compare January 27, 2026 01:45

ably-ci temporarily deployed to ably-docs-ftf-283-apns--sjxyp7 January 27, 2026 01:45 Inactive

maratal force-pushed the FTF-283-apns-swift-guide branch from b482d42 to 898bda5 Compare January 27, 2026 14:00

ably-ci temporarily deployed to ably-docs-ftf-283-apns--sjxyp7 January 27, 2026 14:00 Inactive

maratal added 2 commits January 27, 2026 15:07

Add getting started guide for APNs (with location pushes) for swift.

33318a3

Removed unnecessary push location content.

dcd68ab

maratal force-pushed the FTF-283-apns-swift-guide branch from 898bda5 to dcd68ab Compare January 27, 2026 14:11

ably-ci temporarily deployed to ably-docs-ftf-283-apns--sjxyp7 January 27, 2026 14:11 Inactive

maratal marked this pull request as ready for review January 27, 2026 14:11

maratal requested review from GregHolmes and m-hulbert January 27, 2026 14:13

maratal changed the title ~~Add getting started guide for APNs for swift.~~ [FTF-283] Add getting started guide for APNs for swift. Jan 27, 2026

maratal requested a review from AndyTWF January 27, 2026 14:38

AndyTWF reviewed Jan 28, 2026

View reviewed changes

GregHolmes requested changes Jan 28, 2026

View reviewed changes

Address PR feedback.

bbd625c

ably-ci temporarily deployed to ably-docs-ftf-283-apns--sjxyp7 January 30, 2026 01:12 Inactive

Proof-reading by claude.

b75fcc4

ably-ci temporarily deployed to ably-docs-ftf-283-apns--sjxyp7 January 30, 2026 13:46 Inactive

ably-ci temporarily deployed to ably-docs-ftf-283-apns--sjxyp7 January 30, 2026 13:56 Inactive

maratal force-pushed the FTF-283-apns-swift-guide branch from 87cc344 to 224ebd8 Compare January 30, 2026 14:43

ably-ci temporarily deployed to ably-docs-ftf-283-apns--sjxyp7 January 30, 2026 14:43 Inactive

Add UI pic, link to Apple dashboard and curl command.

1037cdb

maratal force-pushed the FTF-283-apns-swift-guide branch from 224ebd8 to 1037cdb Compare January 30, 2026 14:48

ably-ci temporarily deployed to ably-docs-ftf-283-apns--sjxyp7 January 30, 2026 14:48 Inactive

maratal requested review from AndyTWF and GregHolmes February 6, 2026 13:38

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[FTF-283] Add getting started guide for APNs for swift.#3147

[FTF-283] Add getting started guide for APNs for swift.#3147
maratal wants to merge 5 commits intomainfrom
FTF-283-apns-swift-guide

maratal commented Jan 22, 2026 •

edited

Loading

Uh oh!

coderabbitai bot commented Jan 22, 2026 •

edited

Loading

Review skipped

Uh oh!

AndyTWF Jan 28, 2026

Uh oh!

AndyTWF Jan 28, 2026

Uh oh!

AndyTWF Jan 28, 2026

Uh oh!

AndyTWF Jan 28, 2026

Uh oh!

AndyTWF Jan 28, 2026

Uh oh!

AndyTWF Jan 28, 2026

Uh oh!

AndyTWF Jan 28, 2026

Uh oh!

GregHolmes left a comment

Uh oh!

GregHolmes Jan 28, 2026

Uh oh!

maratal commented Jan 30, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Milestone

Development

Uh oh!

4 participants


		### Create a Swift project with Xcode <a id="prerequisites-create-project"/>

		Create a new iOS project with SwiftUI. For detailed instructions, refer to the [Apple Developer documentation](https://developer.apple.com/documentation/swiftui).


		Continue to explore the documentation with Swift as the selected language:

		* Check our push example: [AblyPushExample](https://github.com/ably/ably-cocoa/tree/main/Examples/AblyPush)

	* Check our push example: [AblyPushExample](https://github.com/ably/ably-cocoa/tree/main/Examples/AblyPush)
	* Check our [push example](https://github.com/ably/ably-cocoa/tree/main/Examples/AblyPush)


		## Step 6: Displaying the results <a id="step-6"/>

		Now, lets complete our `ContentView` to display all the results of everything we added above.

	Now, lets complete our `ContentView` to display all the results of everything we added above.
	Now, let's complete our `ContentView` to display all the results of everything we added above.

Conversation

maratal commented Jan 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Checklist

Uh oh!

coderabbitai bot commented Jan 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review skipped

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

GregHolmes left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

maratal commented Jan 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Milestone

Development

Uh oh!

4 participants

maratal commented Jan 22, 2026 •

edited

Loading

coderabbitai bot commented Jan 22, 2026 •

edited

Loading

maratal commented Jan 30, 2026 •

edited

Loading