Add Spatial Continuity Prototype

.github/assets/SC_Prototype.png.license

@@ -0,0 +1,5 @@
+This source file is part of the Spatial Continuity project
+
+SPDX-FileCopyrightText: 2025 Stanford University and the project authors (see CONTRIBUTORS.md)
+
+SPDX-License-Identifier: MIT

.github/assets/tum-logo-dark-mode.png.license

@@ -0,0 +1,5 @@
+This source file is part of the Spatial Continuity project
+
+SPDX-FileCopyrightText: Technical University of Munich 
+
+SPDX-License-Identifier: MIT

.github/assets/tum-logo-light-mode.png.license

@@ -0,0 +1,5 @@
+This source file is part of the Spatial Continuity project
+
+SPDX-FileCopyrightText: Technical University of Munich 
+
+SPDX-License-Identifier: MIT

.github/workflows/beta-deployment.yml

@@ -1,7 +1,7 @@
 #
-# This source file is part of the StanfordBDHG Template Application project
+# This source file is part of the Spatial Continuity project
 #
-# SPDX-FileCopyrightText: 2023 Stanford University
+# SPDX-FileCopyrightText: 2025 Stanford University and the project authors (see CONTRIBUTORS.md)
 #
 # SPDX-License-Identifier: MIT
 #
@@ -23,16 +23,3 @@ jobs:
       actions: read
       security-events: write
     secrets: inherit
-  iosapptestflightdeployment:
-    name: iOS App TestFlight Deployment
-    needs: buildandtest
-    uses: StanfordBDHG/.github/.github/workflows/xcodebuild-or-fastlane.yml@v2
-    concurrency:
-      group: appstoreconnect
-    permissions:
-      contents: read
-    with:
-      setupsigning: true
-      fastlanelane: beta
-      environment: beta
-    secrets: inherit

.github/workflows/build-and-test.yml

@@ -1,7 +1,7 @@
 #
-# This source file is part of the StanfordBDHG Template Application project
+# This source file is part of the Spatial Continuity project
 #
-# SPDX-FileCopyrightText: 2023 Stanford University
+# SPDX-FileCopyrightText: 2025 Stanford University and the project authors (see CONTRIBUTORS.md)
 #
 # SPDX-License-Identifier: MIT
 #
@@ -29,33 +29,57 @@ jobs:
     uses: StanfordBDHG/.github/.github/workflows/periphery.yml@v2
     permissions:
       contents: read
-  codeql:
-    name: CodeQL
+  # NOTE: CodeQL disabled until it supports the current Swift toolchain
+  # codeql_scc:
+  #   name: CodeQL Spatial Continuity Camera
+  #   uses: StanfordBDHG/.github/.github/workflows/xcodebuild-or-fastlane.yml@v2
+  #   with:
+  #     codeql: true
+  #     fastlanelane: ios codeql_scc
+  #   permissions:
+  #     security-events: write
+  #     actions: read
+  # codeql_sc:
+  #   name: CodeQL Spatial Continuity
+  #   uses: StanfordBDHG/.github/.github/workflows/xcodebuild-or-fastlane.yml@v2
+  #   with:
+  #     codeql: true
+  #     fastlanelane: visionos codeql_sc
+  #   permissions:
+  #     security-events: write
+  #     actions: read
+  buildandtest_scc:
+    name: Build Spatial Continuity Camera (for Testing)
     uses: StanfordBDHG/.github/.github/workflows/xcodebuild-or-fastlane.yml@v2
+    strategy:
+      fail-fast: false
+      matrix:
+        platform: [iphone]
     with:
-      codeql: true
-      fastlanelane: codeql
-    permissions:
-      security-events: write
-      actions: read
-  buildandtest:
-    name: Build and Test
+      # We use the self-hosted runners as the main GitHub Action runners do not have the necessary performance.
+      # Remove the `runsonlabels: '["macOS", "self-hosted"]'` lines if you do not administer your own GitHub Runners.
+      runsonlabels: '["macOS", "self-hosted"]'
+      fastlanelane: ios test_iphone # ${{ matrix.platform }}
+      artifactname: ${{ matrix.platform }}.xcresult
+  buildandtest_sc:
+    name: Build Spatial Continuity (for Testing)
     uses: StanfordBDHG/.github/.github/workflows/xcodebuild-or-fastlane.yml@v2
     strategy:
       fail-fast: false
       matrix:
-        platform: [iphone, ipad, apple_watch, apple_tv, vision_pro]
+        platform: [VisionPro]
     with:
       # We use the self-hosted runners as the main GitHub Action runners do not have the necessary performance.
       # Remove the `runsonlabels: '["macOS", "self-hosted"]'` lines if you do not administer your own GitHub Runners.
       runsonlabels: '["macOS", "self-hosted"]'
-      fastlanelane: test_${{ matrix.platform }}
+      fastlanelane: visionos test_vision_pro # ${{ matrix.platform }}
       artifactname: ${{ matrix.platform }}.xcresult
-  uploadcoveragereport:
-    name: Upload Coverage Report
-    needs: [buildandtest]
-    uses: StanfordBDHG/.github/.github/workflows/create-and-upload-coverage-report.yml@v2
-    with:
-      coveragereports: iphone.xcresult ipad.xcresult apple_watch.xcresult apple_tv.xcresult vision_pro.xcresult
-    secrets:
-      token: ${{ secrets.CODECOV_TOKEN }}
+  # NOTE: Disabled since no tests are being run ATM
+  # uploadcoveragereport:
+  #   name: Upload Coverage Report
+  #   needs: [buildandtest]
+  #   uses: StanfordBDHG/.github/.github/workflows/create-and-upload-coverage-report.yml@v2
+  #   with:
+  #     coveragereports: iphone.xcresult
+  #   secrets:
+  #     token: ${{ secrets.CODECOV_TOKEN }}

.gitignore

@@ -1,32 +1,17 @@
 #
-# This source file is part of the StanfordBDHG Template Application project
+# This source file is part of the Spatial Continuity project
 #
-# SPDX-FileCopyrightText: 2023 Stanford University
+# SPDX-FileCopyrightText: 2025 Stanford University and the project authors (see CONTRIBUTORS.md)
 #
 # SPDX-License-Identifier: MIT
 #
 
-# Swift Package Manager
-*.xcodeproj
-.swiftpm
-.derivedData
-.build
-!TemplateApplication.xcodeproj
-
-# IDE related folders
-.idea
-
-# Xcode
-xcuserdata/
-*.ipa
-*.dSYM
-*.dSYM.zip
-
-# Other files
 .DS_Store
-.env
+/.build
+/Packages
+xcuserdata/
+DerivedData/
+.swiftpm/configuration/registries.json
+.swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata
+.netrc
 
-# Tests
-report.junit
-report.html
-*.xcresult

.periphery.yml

@@ -1,16 +1,24 @@
 #
-# This source file is part of the StanfordBDHG Template Application project
+# This source file is part of the Spatial Continuity project
 #
-# SPDX-FileCopyrightText: 2023 Stanford University
+# SPDX-FileCopyrightText: 2025 Stanford University and the project authors (see CONTRIBUTORS.md)
 #
 # SPDX-License-Identifier: MIT
 #
 
-project: TemplateApplication.xcodeproj
+project: SpatialContinuity.xcodeproj
 schemes:
-- TemplateApplication
+- SpatialContinuityCamera
+- SpatialContinuity
 targets:
-- TemplateApplication
-- TemplateApplicationTests
-- TemplateApplicationUITests
-- TemplateWatchApplication
+- SpatialContinuityCamera
+- SpatialContinuity
+report_exclude:
+- SpatialContinuityShared/**/*.swift
+# HACK: Is this the correct way to exclude external libraries from being checked?
+- "**/*SpeziLLM*/**/*.swift"
+disable_unused_import_analysis: true
+relative_results: true
+build_arguments:
+- -skipPackagePluginValidation
+- -skipMacroValidation

.swiftformat

@@ -0,0 +1,35 @@
+#
+# This source file is part of the Spatial Continuity Project
+#
+# SPDX-FileCopyrightText: 2025 Stanford University and the project authors (see CONTRIBUTORS.md)
+#
+# SPDX-License-Identifier: MIT
+# 
+
+--acronyms "ID,URL,UUID,SCC"
+--allman false
+--binarygrouping 4,8
+--commas inline
+--decimalgrouping 3,6
+--header \nThis source file is part of the Spatial Continuity project\n\nSPDX-FileCopyrightText: 2025 Stanford University and the project authors (see CONTRIBUTORS.md)\n\nSPDX-License-Identifier: MIT\n
+--hexgrouping 4,8
+--hexliteralcase uppercase
+--indent 4
+--linebreaks lf
+--maxwidth 120
+--octalgrouping 4,8
+--semicolons "never"
+--swiftversion 6.0
+--trimwhitespace always
+--wrapparameters before-first
+--wrapcollections before-first
+--wrapconditions after-first
+
+# Rules
+--enable acronyms
+--enable blankLinesBetweenImports
+--enable isEmpty
+--enable wrapConditionalBodies
+--enable wrapMultilineConditionalAssignment
+--enable redundantProperty
+--disable wrapMultilineStatementBraces

.swiftformat.license

@@ -0,0 +1,5 @@
+This source file is part of the Spatial Continuity project
+
+SPDX-FileCopyrightText: 2025 Stanford University and the project authors (see CONTRIBUTORS.md)
+
+SPDX-License-Identifier: MIT

.swiftlint.yml

@@ -379,6 +379,7 @@ deployment_target: # Availability checks or attributes shouldn’t be using olde
 excluded: # paths to ignore during linting. Takes precedence over `included`.
   - .build
   - .swiftpm
+  - "SpatialContinuityShared/Sources/SpatialContinuityShared/LocalVideoStreaming/**/*.swift"
 
 closure_body_length: # Closure bodies should not span too many lines.
   - 35 # warning - default: 20

CITATION.cff

@@ -7,11 +7,51 @@
 #
 
 cff-version: 1.2.0
-message: "If you use this software, please cite it as below."
+message: "If you use this software or reference our publication, please cite it as below."
+title: "Spatial Continuity: Investigating Use Cases of Spatial Computing for Users with Low Vision"
 authors:
-- family-names: "Schmiedmayer"
-  given-names: "Paul"
-  orcid: "https://orcid.org/0000-0002-8607-9148"
-title: "TemplateApplication"
-doi: 10.5281/zenodo.7633671
-url: "https://github.com/StanfordBDHG/TemplateApplication"
+  - family-names: "Heidekrüger"
+    given-names: "Paul"
+    orcid: "https://orcid.org/0009-0000-8556-7353"
+    affiliation: "Technical University of Munich"
+  - family-names: "Brügge"
+    given-names: "Bernd"
+    orcid: "https://orcid.org/0000-0001-8331-0490"
+    affiliation: "Technical University of Munich"
+  - family-names: "Aalami"
+    given-names: "Oliver"
+    orcid: "https://orcid.org/0000-0002-7799-2429"
+    affiliation: "Stanford Mussallem Center for Biodesign, Stanford University"
+  - family-names: "Schmiedmayer"
+    given-names: "Paul"
+    orcid: "https://orcid.org/0000-0002-8607-9148"
+    affiliation: "Stanford Mussallem Center for Biodesign, Stanford University"
+doi: "10.1145/3663547.3759711"
+url: "https://doi.org/10.1145/3663547.3759711"
+preferred-citation:
+  type: conference-paper
+  title: "Spatial Continuity: Investigating Use Cases of Spatial Computing for Users with Low Vision"
+  authors:
+    - family-names: "Heidekrüger"
+      given-names: "Paul"
+      orcid: "https://orcid.org/0009-0000-8556-7353"
+    - family-names: "Brügge"
+      given-names: "Bernd"
+      orcid: "https://orcid.org/0000-0001-8331-0490"
+    - family-names: "Aalami"
+      given-names: "Oliver"
+      orcid: "https://orcid.org/0000-0002-7799-2429"
+    - family-names: "Schmiedmayer"
+      given-names: "Paul"
+      orcid: "https://orcid.org/0000-0002-8607-9148"
+  doi: "10.1145/3663547.3759711"
+  collection-title: "Proceedings of the 27th International ACM SIGACCESS Conference on Computers and Accessibility (ASSETS ’25)"
+  conference:
+    name: "The 27th International ACM SIGACCESS Conference on Computers and Accessibility (ASSETS ’25)"
+    location: "Denver, CO, USA"
+    date-start: 2025-10-26
+    date-end: 2025-10-29
+  publisher:
+    name: "ACM"
+    location: "New York, NY, USA"
+  year: 2025

CONTRIBUTORS.md

@@ -1,14 +1,17 @@
 <!--
 
-This source file is part of the StanfordBDHG Template Application project
+This source file is part of the Spatial Continuity project
 
-SPDX-FileCopyrightText: 2023 Stanford University
+SPDX-FileCopyrightText: 2025 Stanford University and the project authors (see CONTRIBUTORS.md)
 
 SPDX-License-Identifier: MIT
 
 -->
 
-Template Application Contributors
-=================================
+Spatial Continuity Contributors
+===============================
 
+* [Paul Heidekrüger](https://github.com/paulhdk)
+* [Bernd Brügge](https://ase.in.tum.de/BerndBruegge)
+* [Oliver Aalami](https://github.com/aalami5)
 * [Paul Schmiedmayer](https://github.com/PSchmiedmayer)

LICENSE.md

@@ -1,9 +1,21 @@
 MIT License
 
-Copyright (c) 2022 Stanford University
+Copyright (c) 2025 Stanford University and the project authors (see CONTRIBUTORS.md)
 
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.