chore(ci,docs): add CI, fix docs links, enforce SPM-only

.github/workflows/ci.yml

@@ -1,3 +1,61 @@
+name: ci
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+
+jobs:
+  build-test:
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Placeholder/link sanity check
+        run: |
+          brew install ripgrep || true
+          rg -n "(Placeholder|Boilerplate|url-to-screenshot|\[]\(&\)|MISSING:)" -g '!**/.git/**' || true
+          # Fail if any placeholder tokens found
+          if rg -n "(Placeholder|Boilerplate|url-to-screenshot|\[]\(&\)|MISSING:)" -g '!**/.git/**' > /dev/null; then
+            echo "Found placeholder tokens or broken link syntax. Please resolve." && exit 1
+          fi
+      - name: Select Xcode
+        uses: maxim-lobanov/setup-xcode@v1
+        with:
+          xcode-version: '15.4'
+      - name: Cache SPM
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.swiftpm
+            .build
+          key: ${{ runner.os }}-spm-${{ hashFiles('**/Package.resolved') }}
+      - name: SwiftLint
+        run: |
+          brew update
+          brew install swiftlint || true
+          swiftlint || true
+      - name: Build
+        run: swift build -v
+      - name: Test with coverage
+        run: swift test --parallel --enable-code-coverage
+      - name: Export coverage (lcov)
+        run: |
+          set -e
+          PROFILE=$(find .build -name default.profdata | head -n 1)
+          TESTBINARY=$(find .build -name "*Tests.xctest" -maxdepth 5 | head -n 1)
+          if [ -n "$PROFILE" ] && [ -n "$TESTBINARY" ]; then
+            xcrun llvm-cov export "$TESTBINARY" \
+              -format="lcov" \
+              -instr-profile "$PROFILE" \
+              > coverage.lcov
+          fi
+      - name: Upload coverage to Codecov
+        if: exists('coverage.lcov')
+        uses: codecov/codecov-action@v4
+        with:
+          files: coverage.lcov
+          fail_ci_if_error: false
 name: CI
 
 on:

CHANGELOG.md

@@ -77,60 +77,4 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Performance improvements
 - Extended documentation
 - Additional examples
-- Community contributions # VisionOS-UI-Framework - Update 1
-# VisionOS-UI-Framework - Update 2
-# VisionOS-UI-Framework - Update 3
-# VisionOS-UI-Framework - Update 4
-# VisionOS-UI-Framework - Update 5
-# VisionOS-UI-Framework - Update 6
-# VisionOS-UI-Framework - Update 7
-# VisionOS-UI-Framework - Update 8
-# VisionOS-UI-Framework - Update 9
-# VisionOS-UI-Framework - Update 10
-# VisionOS-UI-Framework - Update 11
-# VisionOS-UI-Framework - Update 12
-# VisionOS-UI-Framework - Update 13
-# VisionOS-UI-Framework - Update 14
-# VisionOS-UI-Framework - Update 15
-# VisionOS-UI-Framework - Update 16
-# VisionOS-UI-Framework - Update 17
-# VisionOS-UI-Framework - Update 18
-# VisionOS-UI-Framework - Update 19
-# VisionOS-UI-Framework - Update 20
-# VisionOS-UI-Framework - Update 21
-# VisionOS-UI-Framework - Update 22
-# VisionOS-UI-Framework - Update 23
-# VisionOS-UI-Framework - Update 24
-# VisionOS-UI-Framework - Update 25
-# VisionOS-UI-Framework - Update 26
-# VisionOS-UI-Framework - Update 27
-# VisionOS-UI-Framework - Update 28
-# VisionOS-UI-Framework - Update 29
-# VisionOS-UI-Framework - Update 30
-# VisionOS-UI-Framework - Update 31
-# VisionOS-UI-Framework - Update 32
-# VisionOS-UI-Framework - Update 33
-# VisionOS-UI-Framework - Update 34
-# VisionOS-UI-Framework - Update 35
-# VisionOS-UI-Framework - Update 36
-# VisionOS-UI-Framework - Update 37
-# VisionOS-UI-Framework - Update 38
-# VisionOS-UI-Framework - Update 39
-# VisionOS-UI-Framework - Update 40
-# VisionOS-UI-Framework - Update 41
-# VisionOS-UI-Framework - Update 42
-# VisionOS-UI-Framework - Update 43
-# VisionOS-UI-Framework - Update 44
-# VisionOS-UI-Framework - Update 45
-# VisionOS-UI-Framework - Update 46
-# VisionOS-UI-Framework - Update 47
-# VisionOS-UI-Framework - Update 48
-# VisionOS-UI-Framework - Update 49
-# VisionOS-UI-Framework - Update 50
-# VisionOS-UI-Framework - Update 51
-# VisionOS-UI-Framework - Update 52
-# VisionOS-UI-Framework - Update 53
-# VisionOS-UI-Framework - Update 54
-# VisionOS-UI-Framework - Update 55
-# VisionOS-UI-Framework - Update 56
-# VisionOS-UI-Framework - Update 57
+- Community contributions

CONTRIBUTING.md

@@ -11,7 +11,7 @@ We love your input! We want to make contributing to VisionOS-UI-Framework as eas
 ## We Develop with Github
 We use GitHub to host code, to track issues and feature requests, as well as accept pull requests.
 
-## We Use [Github Flow](https://guides.github.com/introduction/flow/index.html)
+## We Use [GitHub Flow](https://docs.github.com/en/get-started/using-github/github-flow)
 Pull requests are the best way to propose changes to the codebase. We actively welcome your pull requests:
 
 1. Fork the repo and create your branch from `main`.
@@ -54,7 +54,7 @@ test: add unit tests for spatial utilities
 ## Any contributions you make will be under the MIT Software License
 In short, when you submit code changes, your submissions are understood to be under the same [MIT License](https://choosealicense.com/licenses/mit/) that covers the project. Feel free to contact the maintainers if that's a concern.
 
-## Report bugs using Github's [issue tracker](https://github.com/muhittincamdali/VisionOS-UI-Framework/issues)
+## Report bugs using GitHub's [issue tracker](https://github.com/muhittincamdali/VisionOS-UI-Framework/issues)
 We use GitHub issues to track public bugs. Report a bug by [opening a new issue](https://github.com/muhittincamdali/VisionOS-UI-Framework/issues/new); it's that easy!
 
 ## Write bug reports with detail, background, and sample code

Documentation/README.md

@@ -1,30 +1,30 @@
 # Documentation Index
 
-- [](&)Documentation/3DInteractionsAPI.md
-- [](&)Documentation/3DInteractionsGuide.md
-- [](&)Documentation/AccessibilityAPI.md
-- [](&)Documentation/AccessibilityGuide.md
-- [](&)Documentation/API-Reference.md
-- [](&)Documentation/API.md
-- [](&)Documentation/Best-Practices.md
-- [](&)Documentation/ChangelogGuide.md
-- [](&)Documentation/ConfigurationAPI.md
-- [](&)Documentation/ConfigurationGuide.md
-- [](&)Documentation/ContributingGuide.md
-- [](&)Documentation/Getting-Started.md
-- [](&)Documentation/GettingStarted.md
-- [](&)Documentation/ImmersiveExperiencesAPI.md
-- [](&)Documentation/ImmersiveExperiencesGuide.md
-- [](&)Documentation/Installation.md
-- [](&)Documentation/LicenseGuide.md
-- [](&)Documentation/PerformanceAPI.md
-- [](&)Documentation/PerformanceGuide.md
-- [](&)Documentation/SpatialAudioAPI.md
-- [](&)Documentation/SpatialAudioGuide.md
-- [](&)Documentation/SpatialComputingBestPracticesGuide.md
-- [](&)Documentation/SpatialUIAPI.md
-- [](&)Documentation/SpatialUIGuide.md
-- [](&)Documentation/TestingGuide.md
-- [](&)Documentation/Troubleshooting.md
-- [](&)Documentation/TroubleshootingGuide.md
-- [](&)Documentation/VisionOSUIFrameworkManagerAPI.md
+- [3D Interactions API](./3DInteractionsAPI.md)
+- [3D Interactions Guide](./3DInteractionsGuide.md)
+- [Accessibility API](./AccessibilityAPI.md)
+- [Accessibility Guide](./AccessibilityGuide.md)
+- [API Reference](./API-Reference.md)
+- [General API](./API.md)
+- [Best Practices](./Best-Practices.md)
+- [Changelog Guide](./ChangelogGuide.md)
+- [Configuration API](./ConfigurationAPI.md)
+- [Configuration Guide](./ConfigurationGuide.md)
+- [Contributing Guide](./ContributingGuide.md)
+- [Getting Started](./Getting-Started.md)
+- [Getting Started (Alt)](./GettingStarted.md)
+- [Immersive Experiences API](./ImmersiveExperiencesAPI.md)
+- [Immersive Experiences Guide](./ImmersiveExperiencesGuide.md)
+- [Installation](./Installation.md)
+- [License Guide](./LicenseGuide.md)
+- [Performance API](./PerformanceAPI.md)
+- [Performance Guide](./PerformanceGuide.md)
+- [Spatial Audio API](./SpatialAudioAPI.md)
+- [Spatial Audio Guide](./SpatialAudioGuide.md)
+- [Spatial Computing Best Practices](./SpatialComputingBestPracticesGuide.md)
+- [Spatial UI API](./SpatialUIAPI.md)
+- [Spatial UI Guide](./SpatialUIGuide.md)
+- [Testing Guide](./TestingGuide.md)
+- [Troubleshooting](./Troubleshooting.md)
+- [Troubleshooting Guide](./TroubleshootingGuide.md)
+- [VisionOS UI Framework Manager API](./VisionOSUIFrameworkManagerAPI.md)

README.md

@@ -1,5 +1,5 @@
 # 🥽 VisionOS UI Framework
-[![CI](https://github.com/muhittincamdali/VisionOS-UI-Framework/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/muhittincamdali/VisionOS-UI-Framework/actions/workflows/ci.yml)
+[![CI](https://github.com/muhittincamdali/VisionOS-UI-Framework/actions/workflows/ci.yml/badge.svg)](https://github.com/muhittincamdali/VisionOS-UI-Framework/actions/workflows/ci.yml)
 
 
 
@@ -17,7 +17,7 @@
 ![Performance](https://img.shields.io/badge/Performance-Optimized-795548?style=for-the-badge)
 ![Architecture](https://img.shields.io/badge/Architecture-Clean-FF5722?style=for-the-badge)
 ![Swift Package Manager](https://img.shields.io/badge/SPM-Dependencies-FF6B35?style=for-the-badge)
-![CocoaPods](https://img.shields.io/badge/CocoaPods-Supported-E91E63?style=for-the-badge)
+<!-- CocoaPods is not supported. We use SPM-only across projects. -->
 
 **🏆 Professional VisionOS UI Framework**