# Create Private Framework

> Claude Command to Create Private SDK XCFramework Use when this capability is needed.

- Skill: `tomevault-io/create-private-framework` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/create-private-framework`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/create-private-framework/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/create-private-framework

---


To create a new private SDK xcframework like BacklightServices, follow these steps:

## Command Summary

```bash
# 1. Create directory structure
mkdir -p <FrameworkName>/{2024/{Sources,tbds},latest}
cd <FrameworkName>

# 2. Create tbd subdirectories for each platform
mkdir -p 2024/tbds/{ios-arm64-arm64e,ios-arm64-x86_64-simulator,xros-arm64-x86_64-simulator}

# 3. Extract tbd files from simulators
# For iOS Simulator
cp -r "/Library/Developer/CoreSimulator/Volumes/iOS_22F77/Library/Developer/CoreSimulator/Profiles/Runtimes/iOS 18.5.simruntime/Contents/Resources/RuntimeRoot/System/Library/PrivateFrameworks/<FrameworkName>.framework" /tmp/<FrameworkName>_ios_simulator.framework
cd /tmp && xcrun tapi stubify ./<FrameworkName>_ios_simulator.framework
cp /tmp/<FrameworkName>_ios_simulator.framework/<FrameworkName>.tbd <path>/2024/tbds/ios-arm64-x86_64-simulator/

# For visionOS Simulator
cp -r "/Library/Developer/CoreSimulator/Volumes/xrOS_22O473/Library/Developer/CoreSimulator/Profiles/Runtimes/xrOS 2.5.simruntime/Contents/Resources/RuntimeRoot/System/Library/PrivateFrameworks/<FrameworkName>.framework" /tmp/<FrameworkName>_xros_simulator.framework
cd /tmp && xcrun tapi stubify ./<FrameworkName>_xros_simulator.framework
cp /tmp/<FrameworkName>_xros_simulator.framework/<FrameworkName>.tbd <path>/2024/tbds/xros-arm64-x86_64-simulator/

# 4. Get iOS device tbd from GitHub
curl -s "https://raw.githubusercontent.com/xybp888/iOS-SDKs/master/iPhoneOS18.5.sdk/System/Library/PrivateFrameworks/<FrameworkName>.framework/<FrameworkName>.tbd" > 2024/tbds/ios-arm64-arm64e/<FrameworkName>.tbd

# 5. Set up framework-specific files
# For Swift frameworks:
mkdir -p 2024/Sources/Modules/<FrameworkName>.swiftmodule
# Create template.swiftinterface with Swift module declarations

# For Objective-C frameworks:
mkdir -p 2024/Sources/{Headers,Modules}
# Extract headers using ipsw class-dump (creates individual header files in a subdirectory)
ipsw class-dump "/Library/Developer/CoreSimulator/Volumes/iOS_22F77/Library/Developer/CoreSimulator/Profiles/Runtimes/iOS 18.5.simruntime/Contents/Resources/RuntimeRoot/System/Library/PrivateFrameworks/<FrameworkName>.framework/<FrameworkName>" --headers --arch arm64 -o 2024/Sources/Headers
# This creates a <FrameworkName>/ subdirectory in Headers/ with all the header files
# Note: Headers are universal and can be used for all platforms (iOS, iOS Simulator, visionOS Simulator)
# Create module.modulemap in Modules/

# 6. Create Info.plist for xcframework

# 7. Create update.sh script

# 8. Run update.sh to generate xcframework
./update.sh

# 9. Create symlink to latest version
ln -s ./2024 latest
```

## Key Files Created

1. **Info.plist** - Defines the xcframework structure with library identifiers for each platform
2. **update.sh** - Script to regenerate the xcframework from tbd files
3. **README.md** - Documentation for the framework
4. **tbds/** - Directory containing .tbd stub files for each platform:
   - ios-arm64-arm64e (iPhone device)
   - ios-arm64-x86_64-simulator (iPhone Simulator)
   - xros-arm64-x86_64-simulator (visionOS Simulator)
5. **For Swift frameworks:**
   - `Sources/Modules/<FrameworkName>.swiftmodule/template.swiftinterface` - Template for Swift interface generation
6. **For Objective-C frameworks:**
   - `Sources/Headers/` - Directory containing framework header files
   - `Sources/Modules/module.modulemap` - Module map defining the framework's module structure

## Platform Support

The framework supports:
- iOS Device (arm64, arm64e)
- iOS Simulator (arm64, x86_64)
- visionOS Simulator (arm64, x86_64)

## Notes

- The `xcrun tapi stubify` command is used to generate .tbd files from framework binaries
- The 2024 version corresponds to iOS 18.5, macOS 15.5, and visionOS 2.5
- Always create a symlink named `latest` pointing to the current version directory
- **Swift frameworks** require a `template.swiftinterface` file for proper module interface generation (see AttributeGraph for example)
- **Objective-C frameworks** require a `module.modulemap` and header files in the Sources directory
- The `update.sh` script should handle copying these files into the generated xcframework structure

---

Create framework: $ARGUMENTS

---
> Source: [OpenSwiftUIProject/DarwinPrivateFrameworks](https://github.com/OpenSwiftUIProject/DarwinPrivateFrameworks) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-17 -->