Create complete iOS app template for cell tower alignment with GPS and motion sensors

[Copilot]

This PR implements a complete iOS application template that helps users align their devices to point directly at target GPS locations. The app calculates both azimuth (compass direction) and elevation (tilt angle) needed for precise alignment.

Key Features Implemented

📍 GPS Integration

• Real-time location tracking using CoreLocation
• Automatic current position detection with proper error handling
• Location permissions management with user-friendly messaging

🗺️ Interactive Map Interface

• MapKit integration for visual target selection
• Tap-to-select functionality on map
• Manual coordinate entry with validation
• Altitude input support for elevation calculations

🧭 Motion Sensor Integration

• CoreMotion framework integration for device orientation
• Real-time compass heading updates
• Pitch and roll angle monitoring
• Motion sensor availability detection

🔢 Mathematical Calculations

• Precise azimuth calculation using great circle formulas
• Elevation angle computation based on altitude differences
• Distance calculations between GPS coordinates
• Cardinal direction conversion (N, NE, E, SE, etc.)

🎨 Modern SwiftUI Interface

• Clean, intuitive tab-based navigation
• Real-time data display with color-coded sections
• Responsive design for iPhone and iPad
• Comprehensive settings page with app information

Technical Architecture

The app follows MVVM (Model-View-ViewModel) architecture with proper separation of concerns:

AlignMyCellTower/
├── Models/LocationModel.swift          # GPS coordinate data structure
├── ViewModels/
│   ├── LocationManager.swift          # CoreLocation management
│   └── MotionManager.swift            # CoreMotion sensor handling
├── Views/
│   ├── HomeView.swift                 # Main alignment interface
│   ├── MapView.swift                  # Interactive map selection
│   └── SettingsView.swift             # Configuration and info
└── Utilities/AlignmentCalculator.swift # Mathematical operations

Mathematical Accuracy

The alignment calculations have been verified with real-world coordinates:

// San Francisco to Los Angeles calculation
let azimuth = AlignmentCalculator.calculateAzimuth(from: sf, to: la)
// Result: 136.5° (Southeast) - matches expected bearing

Requirements & Permissions

• iOS 16.0+ with SwiftUI support
• Location Services permission for GPS functionality
• Motion & Fitness permission for device orientation
• Compatible with iPhone and iPad devices

Documentation

Comprehensive README includes:

• Build and setup instructions
• Usage guidelines and feature explanations
• Technical implementation details
• Future enhancement roadmap

This template provides a solid foundation for building advanced features like augmented reality overlays, saved locations, and real-time guidance systems.

This pull request was created as a result of the following prompt from Copilot chat.

The purpose of this application is to help users align a device to point directly at a target GPS location. The app should calculate both the direction (azimuth) and tilt (elevation) needed to align the device based on the current location and orientation of the user. Here's what the starting template should include:

1. Project Setup:

   • Create an Xcode project using Swift and SwiftUI.
   • Add a basic folder structure for Models, Views, and ViewModels.

2. Features in the Template:

   • A basic home screen with two main input options: current GPS location (read-only) and target GPS location (user input).
   • Use CoreLocation to fetch the user's current location.
   • A MapKit view to allow users to select a target location on a map.

3. Compass and Tilt Integration:

   • Integrate CoreMotion to access gyroscope and accelerometer data.
   • Add a placeholder UI to display azimuth and elevation angles (these can just be labels for now).

4. Mathematical Calculations:

   • Add a utility function to calculate azimuth and tilt angles between two GPS coordinates.
   • Keep the calculations simple in this version; we can refine later.

5. UI/UX Design:

   • Use SwiftUI components to make the user interface clean and modern.
   • Include a navigation bar and a basic settings page.

6. Documentation:

   • Add comments and a README file describing the app's purpose and how to run the project.

This template will serve as a foundation for adding more advanced features like real-time feedback, augmented reality overlays, and saved target locations.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[Copilot]

Copilot wasn't able to review any files in this pull request.

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[loudbinary]

Lgtm