What changed
Xcode 27.2 beta adds a new JSON-based project format with the .xcproj extension. Apple describes it as more readable, more merge-friendly and easier for coding agents to edit than the existing project representation. Developers can enable the format from the File Inspector, and Apple says .xcproj projects created by Xcode 27.2 can also be opened by earlier Xcode 27 releases.
The change lands alongside Swift 6.4 and the 27.2 platform SDKs. Xcode 27.2 itself requires macOS Tahoe 26.6 or later, so the new format is part of the current beta toolchain rather than a standalone file-format release.
Apple published the tooling, not only the syntax
Apple has also published xcode-project-format, an Apache-2.0 Swift package for reading, writing and manipulating project.xcproj files. It exposes the project schema as typed XCSchema models and includes an xcprojformatter command-line tool, giving project generators, linters, verifiers and validators a first-party model instead of requiring each tool to reverse-engineer Xcode project internals.
The library requires Swift 6.1 or later and macOS 14 or later for its command-line tooling, while Apple says the library itself can build on non-Darwin platforms. That makes the format usable by build infrastructure and developer tooling outside Xcode itself.
Why it matters
Xcode project files have long been a source of merge conflicts and special-case tooling. A supported JSON representation reduces that friction and gives coding agents a machine-editable structure whose schema and serialization behaviour are maintained by Apple. The benefit is less about JSON as a notation and more about having an official, typed contract around project manipulation.
For agentic development, that could remove a fragile layer where models currently edit opaque project structures or rely on Xcode-specific automation. For ordinary teams, the same structure should make code review and conflict resolution easier when project membership, build settings or targets change.
Limits and open questions
The format is arriving in an Xcode 27.2 beta, so teams should still treat migration as a toolchain change that needs testing. Apple says .xcproj projects open in earlier Xcode 27 versions, but it has not promised compatibility with older major Xcode releases or described a permanent migration guarantee.
Community reports of dramatically smaller project files are useful early observations, but they are not part of Apple’s documented guarantee. The material confirmed change is narrower: a first-party JSON project format, an official Swift schema library and stated compatibility across Xcode 27 point releases.