Design personalized postcards in your iOS app — choose templates, add text, images, and export print-ready files. Built with CE.SDK by IMG.LY.
- Xcode
- Swift 6+
- iOS 16+ deployment target
git clone https://github.com/imgly/starterkit-postcard-editor-ios.git
cd starterkit-postcard-editor-iosopen StarterKit-PostcardEditor.xcodeprojXcode will resolve the Swift Package dependencies automatically. Select an iOS Simulator or device and press Run (Cmd+R).
Add your CE.SDK license key in StarterKit-PostcardEditor/Secrets.swift:
let secrets = Secrets(
// ...
licenseKey: "your-license-key"
)Without a license key, the editor runs in evaluation mode with a watermark.
The starter kit files in StarterKit/ demonstrate how to customize the editor:
- Configuration —
PostcardEditorConfiguration.swift - Callbacks —
callbacks/(onCreate, onChanged, onExport) - Components —
components/(navigation bar, dock, inspector bar, canvas menu)
starterkit-postcard-editor-ios/
├── StarterKit-PostcardEditor.xcodeproj/
├── StarterKit-PostcardEditor/
│ ├── StarterKit_PostcardEditorApp.swift # @main entry point
│ ├── ContentView.swift # Root view launching the starter kit
│ └── Secrets.swift # License key configuration
└── StarterKit/
├── PostcardEditorStarterKit.swift
├── PostcardEditorConfiguration.swift
├── callbacks/ # Lifecycle callbacks
└── components/ # UI component customization
- Templates — Pre-built postcard design templates
- Text Editing — Typography with fonts and styles
- Image Placement — Add and arrange photos
- Front & Back — Multi-page postcard editing
- Export — PNG, JPEG, PDF with quality controls
For complete integration guides and API reference, visit the CE.SDK iOS Documentation.
This project is licensed under the MIT License — see the LICENSE file for details.