Tool to create PySwiftKit based Apps

First, create a new project which will generate a pyproject.toml file:

#psproject init HelloWorld
uv init --package HelloWorld --python 3.13.8

Navigate to the new project directory:

cd HelloWorld

Or open it in VS Code:

code HelloWorld

uv add kivy

uv add psproject --dev

psproject is part of the app development and should only be added in dev mode, which uv automatic enables by default. pips added in dev group, won't be included in the macos/ios site-packages

uv run psproject init

The generated pyproject.toml will contain default configuration. To create a Kivy-based app, add Kivy to the project dependencies and configure the PSProject backends:

[project]
authors = [ { email = "foo@baz.com", name = "somebody" } ]
dependencies = [
    "kivy"
]
description = "Add your description here"
name = "helloworld"
readme = "README.md"
requires-python = ">=3.13.8"
version = "0.1.0"

[tool.psproject]
app_name = "HelloWorld"
backends = [
    "kivyschool.kivylauncher"
]
cythonized = false
pip_install_app = true

Generate the Xcode project:

uv run psproject create xcode

To update the Xcode project's site-packages:

uv run psproject update site-packages

• PySwiftKit Wiki
• Setup Guide
• Kivy Project Documentation
• PyProject Configuration
• Kivy on iOS Guide

MIT License - See LICENSE file for details