Getting Started

Getting Started

Prerequisites

• macOS with latest stable Xcode installed.
• Xcode Command Line Tools.
• XcodeGen:
  • brew install xcodegen

Clone and Build

1. Clone the repository.
2. Open terminal in repository root.
3. Generate project:
   • xcodegen generate
4. Open ColdVault.xcodeproj in Xcode.
5. Select ColdVault scheme.
6. Run on iOS Simulator or physical iPhone.

Build via Terminal

xcodebuild -project ColdVault.xcodeproj -scheme ColdVault -destination 'generic/platform=iOS Simulator' build

Quick Orientation

• ColdVault/App: app entry and app-level composition.
• ColdVault/Views: SwiftUI screens and reusable components.
• ColdVault/Services: core business/security and integration logic.
• ColdVault/Models: domain entities and app settings.
• ColdVault/Resources: localization and assets.

First Contribution in 10 Minutes

1. Pick an issue labeled good first issue (if available).
2. Create a branch from main.
3. Make focused changes.
4. Validate build locally.
5. Open PR using the repository template.