FXMacroData for iPhone, iPad, Mac, Calendar, and Shortcuts
This page collects the web, API, and review-facing pieces needed by the native App Store app stream: calendar subscriptions, Safari install behavior, Universal Links, Smart App Banners, push delivery, and App Intents handoff notes.
Calendar first
Apple Calendar can subscribe to live FXMacroData release feeds now. USD is public; non-USD and all-currency feeds use an API key in the URL.
Native handoff ready
The website exposes an Apple App Site Association endpoint for Universal Links and shared web credentials once the Team ID and bundle IDs are configured.
Push bridge
Release alerts are delivered through Firebase Cloud Messaging tokens, which can represent browser web-push tokens or native iOS app tokens.
Apple Calendar subscriptions
Use the production calendar feed for iOS, iPadOS, macOS, Outlook, and other iCalendar clients. Add alarm_minutes to include a display reminder inside each event.
Public USD feed
webcal://fxmacrodata.com/release-calendar.ics?currency=USD&alarm_minutes=15
Use webcal:// when opening from Apple Calendar. Use https:// for download or server-side checks.
Paid currency feed
https://fxmacrodata.com/release-calendar.ics?currency=EUR&api_key=YOUR_API_KEY&alarm_minutes=30
Public examples use query-parameter authentication because calendar clients do not reliably send custom API-key headers.
Safari and Home Screen web app
FXMacroData already ships a web manifest, Apple touch icon, installable standalone display mode, and a service worker. Safari users can add the dashboard to the Home Screen while the App Store app is in progress.
Install target
Start from Market Summary or Release Calendar for repeat-use workflows.
Notifications
Browser push uses Firebase Web Push when the user grants permission. Native iOS push uses the same stored FCM token fanout path after APNs is configured in Firebase.
Smart App Banner
Set IOS_APP_STORE_ID after App Store Connect assigns the app ID.
Native app handoff checklist
The website serves Apple App Site Association metadata at /.well-known/apple-app-site-association and /apple-app-site-association. The endpoint is intentionally configurable by environment so dev, TestFlight, and production can claim different app IDs.
Website environment variables
APPLE_APP_SITE_ASSOCIATION_APP_IDS=TEAMID.com.fxmacrodata.app APPLE_WEB_CREDENTIAL_APP_IDS=TEAMID.com.fxmacrodata.app IOS_APP_STORE_ID=1234567890
Use comma-separated values when TestFlight, production, or App Clip bundle IDs need to be served from the same domain.
Native associated domains
applinks:fxmacrodata.com webcredentials:fxmacrodata.com
The default Universal Link paths cover dashboard, docs, articles, widgets, and app-gallery surfaces. Checkout, Stripe, API, auth, and account-management paths are excluded by default.
| App route | Recommended native destination |
|---|---|
/dashboard/release-calendar |
Calendar tab with current filter state. |
/dashboard/{BASE_QUOTE} |
Pair detail screen with macro indicators and latest release state. |
/api-data-docs/{currency}/{indicator} |
Endpoint reference or in-app data preview for the same series. |
/articles/{slug} |
Article reader with a fallback to Safari if native article rendering is not ready. |
Shortcuts, App Intents, widgets, and Siri
The native app should expose the highest-value read-only workflows as App Intents so users can automate market prep from Shortcuts and Siri without building a full scripting surface on day one.
First App Intents
- Get upcoming releases for a currency.
- Get the latest indicator reading for a currency and indicator.
- Open an FX pair dashboard.
- Subscribe to a calendar feed for a currency.
API calls for Shortcuts
GET https://fxmacrodata.com/api/announcements/usd/inflation GET https://fxmacrodata.com/api/calendar/usd
Protected Shortcuts should read the API key from the app's secure storage and append it as api_key only at request time.
App Store review and auth notes
Add Sign in with Apple if social login is available
The web app already supports Google sign-in. The native app should add Sign in with Apple through Firebase Auth before App Review if Google remains a primary account login option.
Keep paid digital access compliant
The website Universal Link defaults do not claim checkout or Stripe paths. Treat native subscription, existing web entitlements, and any external account-management link as an App Review decision before submission.
Prepare review credentials
Provide App Review with either a paid test account, demo mode, or reviewer API key so non-USD data, alerts, and calendar scopes can be exercised without billing friction.