Workspace Layout

Top-Level Directories

Apps/ — user-facing app targets
Packages/ — shared Swift packages
XPC/ — XPC service targets
Helpers/ — privileged helper targets
MenuBar/ — deferred menu-bar target area
Testing/ — shared testing support and future test targets
Docs/ — product, design, engineering, and compliance documents

Planned Module Layout

App Shell

Apps/AtlasApp/
Apps/Package.swift

Shared Packages

Packages/Package.swift
Packages/AtlasDesignSystem/
Packages/AtlasDomain/
Packages/AtlasApplication/
Packages/AtlasProtocol/
Packages/AtlasInfrastructure/
Packages/AtlasCoreAdapters/
Packages/AtlasFeaturesOverview/
Packages/AtlasFeaturesSmartClean/
Packages/AtlasFeaturesApps/
Packages/AtlasFeaturesStorage/
Packages/AtlasFeaturesHistory/
Packages/AtlasFeaturesPermissions/
Packages/AtlasFeaturesSettings/

Services

XPC/Package.swift
Helpers/Package.swift
XPC/AtlasWorkerXPC/
Helpers/AtlasPrivilegedHelper/

Deferred Targets

MenuBar/AtlasMenuBar/

Test Support

Testing/Package.swift
Testing/AtlasTestingSupport/

Current Scaffold Conventions

Apps/Package.swift hosts the main AtlasApp executable target.
Packages/Package.swift hosts shared library products with sources under Packages/*/Sources/*.
XPC/Package.swift and Helpers/Package.swift host the worker and helper executable stubs.
Root project.yml also generates an AtlasWorkerXPC macOS xpc-service target for the app bundle.
Testing/Package.swift hosts shared fixtures and future contract-test helpers.
MenuBar/ remains README-only until deferred P1 scope is explicitly reopened.
Root project.yml generates Atlas.xcodeproj through xcodegen for the native app shell.

Rule

Create implementation files inside these directories rather than introducing new top-level structures unless an ADR records the change. Keep project.yml as the source of truth for regenerating Atlas.xcodeproj.

2.0 KiB Raw Blame History