Interspace iOS

Interspace is an open-source iOS application that provides a secure, privacy-first platform for managing digital identities, social profiles, and cryptocurrency wallets. Built with SwiftUI and modern iOS development practices.

✨ Features

• 🆔 Multi-Profile Management: Create and manage multiple digital identities
• 🔐 Privacy-First Design: Your data stays on your device
• 👛 Wallet Integration: Connect MetaMask, Coinbase Wallet, and more
• 🌐 Social Account Linking: Connect Twitter, Discord, Instagram, and other platforms
• 🔑 Secure Authentication: Support for email, Google Sign-In, Apple Sign-In, and Passkeys
• 🎨 Beautiful UI: Modern SwiftUI interface with smooth animations
• 🌓 Dark Mode Support: Fully adaptive to system appearance
• 🔒 End-to-End Security: Military-grade encryption and security practices

📋 Prerequisites

• macOS 13.0 or later
• Xcode 15.0 or later
• iOS 16.0+ deployment target
• CocoaPods 1.12.0+ (for dependency management)
• Active Apple Developer account (for device testing)

Required API Keys

To run the app, you'll need to obtain the following API keys:

1. Google OAuth: Google Cloud Console
2. Infura: Infura Dashboard
3. WalletConnect: WalletConnect Cloud

🚀 Quick Start

1. Clone the repository

   git clone https://github.com/yourusername/interspace-ios.git
   cd interspace-ios

2. Install dependencies

   pod install

3. Configure the project

   # Copy configuration templates
   cp Interspace/Supporting/BuildConfiguration.xcconfig.template Interspace/Supporting/BuildConfiguration.xcconfig
   cp Interspace/GoogleService-Info.plist.template Interspace/GoogleService-Info.plist
   cp .env.example .env
   cp .xcode.env.local.template .xcode.env.local

4. Add your API keys

   • Edit BuildConfiguration.xcconfig with your API keys
   • Update GoogleService-Info.plist with your Firebase configuration
   • Configure .env with your environment variables

5. Open the project

   open Interspace.xcworkspace

6. Select your development team

   • Open project settings in Xcode
   • Select your development team under "Signing & Capabilities"

7. Build and run

   • Select your target device or simulator
   • Press Cmd+R to build and run

📖 Documentation

• Architecture Overview - System design and architecture
• Development Guide - Detailed development setup
• API Documentation - Backend API integration
• Deployment Guide - Release and deployment process
• Security Policy - Security practices and vulnerability reporting

🏗️ Project Structure

interspace-ios/
├── Interspace/              # Main application code
│   ├── Models/             # Data models
│   ├── Views/              # SwiftUI views
│   ├── ViewModels/         # View models (MVVM)
│   ├── Services/           # Business logic and API services
│   ├── Extensions/         # Swift extensions
│   ├── Supporting/         # Supporting files (Info.plist, etc.)
│   └── Assets.xcassets/    # Images and colors
├── InterspaceTests/        # Unit tests
├── InterspaceUITests/      # UI tests
├── docs/                   # Documentation
├── scripts/                # Build and utility scripts
└── Pods/                   # CocoaPods dependencies (git-ignored)

🧪 Testing

Run the test suite:

# Unit tests
xcodebuild test -workspace Interspace.xcworkspace -scheme Interspace -destination 'platform=iOS Simulator,name=iPhone 15'

# UI tests
xcodebuild test -workspace Interspace.xcworkspace -scheme InterspaceUITests -destination 'platform=iOS Simulator,name=iPhone 15'

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Workflow

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Code Style

• Follow Swift API Design Guidelines
• Use SwiftLint for code consistency
• Write unit tests for new features
• Update documentation as needed

🔒 Security

Security is our top priority. Please review our Security Policy for:

• Vulnerability reporting procedures
• Security best practices
• Responsible disclosure policy

Never commit sensitive information like API keys or passwords to the repository.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• SwiftUI - Apple's modern UI framework
• WalletConnect - Open protocol for wallet connections
• Google Sign-In - Authentication services
• All our amazing contributors and the open-source community

📬 Contact

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Email: support@interspace.app

---

Made with ❤️ by the Interspace Team