EtherWorld iOS App

A native iOS app for reading crypto and blockchain content from EtherWorld.

App Details

• Name: EtherWorld
• Bundle ID: co.etherworld.app
• Version: 1.0 (Build 1)
• Platform: iOS 16.0+, iPadOS 16.0+

Features

Authentication

• ✅ Apple Sign In
• ✅ Google Sign In
• ✅ OTP via Email (6-digit verification code)
• ✅ Firebase Authentication
• ✅ Skip Login (Dev Mode - Remove before production)

Core Features

• ✅ Browse articles from Ghost CMS
• ✅ Search with language filtering
• ✅ Bookmark/Save articles for offline reading
• ✅ Mark articles as read
• ✅ Offline mode with local caching
• ✅ Background refresh
• ✅ Push notifications
• ✅ Multi-language support (EN, ES, FR, DE, etc.)
• ✅ Dark/Light/System theme
• ✅ iPad optimized with sidebar
• ✅ Author profiles
• ✅ Share articles

Privacy & Data

• ✅ Privacy Policy view
• ✅ Data export capability
• ✅ Session management
• ✅ Analytics (opt-in)
• ✅ Account deletion
• ✅ Supabase integration for preferences sync

Configuration

Required Files

1. Config.xcconfig - API keys and configuration
2. GoogleService-Info.plist - Firebase configuration
3. IOS-App-Info.plist - App configuration and permissions

API Keys (in Config.xcconfig)

• Ghost CMS API Key
• Ghost Base URL
• Supabase URL
• Supabase Anon Key
• Firebase (configured via GoogleService-Info.plist)

Privacy Permissions

The app requests the following permissions:

• NSUserTrackingUsageDescription: Anonymous analytics (opt-in)
• NSCameraUsageDescription: Photo upload capability
• NSPhotoLibraryUsageDescription: Image sharing
• NSFaceIDUsageDescription: Biometric authentication
• Background fetch: Article updates

App Store Submission Checklist

Technical Requirements

• Bundle ID configured: co.etherworld.app
• Version numbers set: 1.0 (Build 1)
• App icon configured (1024x1024)
• Launch screen with logo
• Privacy descriptions added
• App Transport Security configured
• Firebase Bundle ID updated
• Remove dev skip login button before production
• Test on physical device

Testing Requirements

• Test Apple Sign In
• Test Google Sign In
• Test Magic Link authentication
• Test offline mode (airplane mode)
• Test bookmarking and read status
• Test background refresh
• Test on iPad
• Test theme switching
• Test language switching
• Test push notifications

App Store Connect

• Create app listing
• Upload screenshots (6.7" iPhone, 12.9" iPad Pro)
• Add app description
• Add keywords
• Set support URL: https://etherworld.co
• Set privacy policy URL: https://etherworld.co/privacy
• Configure in-app purchases (if any)
• Submit for review

Screenshots Needed

1. Login screen with logo
2. Home feed with articles
3. Article detail view
4. Search results
5. Saved articles
6. Settings screen
7. iPad sidebar view

Architecture

Services

• ArticleService: Protocol for fetching articles
• GhostArticleService: Implementation for Ghost CMS
• MockArticleService: For testing/previews
• AuthenticationManager: Handles all auth flows
• AnalyticsManager: Firebase Analytics
• NotificationManager: Push notifications
• OfflineManager: Local caching and offline support
• BackgroundRefreshManager: Background updates
• SpotlightIndexer: iOS Spotlight integration

Views

• LoginView: Authentication screen
• HomeFeedView: Main article feed
• ArticleDetailView: Full article view
• DiscoverView: Search and explore
• SavedArticlesView: Bookmarked articles
• SettingsView: App settings
• ProfileSettingsView: User profile
• AuthorProfileView: Author details

Data Models

• Article: Main content model
• Author: Writer information
• User: Account data

Backend Services

Ghost CMS

• Content delivery
• Article management
• Tag/category filtering
• Multi-language support

Supabase

• Email logging (emails table)
• User preferences sync (user_preferences table)
• Backup/restore data

Firebase

• Authentication (Apple, Google, Email)
• Analytics
• Cloud Messaging (push notifications)
• Crashlytics (optional)

Build Instructions

1. Open IOS_App.xcodeproj in Xcode
2. Select your development team
3. Ensure all config files are present
4. Build and run on simulator or device

Archive for App Store

1. Select "Any iOS Device" as destination
2. Product → Archive
3. Validate the archive
4. Distribute to App Store Connect
5. Submit for review

Development Notes

• Keep the dev skip login button until ready for production
• Test all auth flows on physical device before submission
• Verify Firebase and Supabase are properly configured
• Check that all API keys are valid and not expired
• Ensure offline mode works correctly
• Test on both iPhone and iPad

Support

• Website: https://etherworld.co
• Twitter: https://twitter.com/AayushS20298601
• Privacy Policy: https://etherworld.co/privacy

License

Proprietary - All rights reserved