Una mesa compartida para diseñar una pantalla SwiftUI.
Un sketch local, una sesión con límites claros y una preview que humanos y agentes pueden revisar juntos.
Empieza · Studio · Qué dibuja · Desarrollo
OpenSwift convierte una parte reconocible de SwiftUI —stacks, texto, botones y algunos modificadores— en un bosquejo visual dentro de un marco de iPhone. No compila ni ejecuta Swift. Sirve para hablar de una pantalla y probar cambios de layout sin abrir Xcode.
La pieza central es la sesión .ui-session: fija una vista, guarda la intención, registra previews con hashes SHA-256 y, mientras la sesión está activa, limita los guardados de Studio al archivo target y a los archivos allowed. Así la persona y el agente pueden iterar sobre el mismo objetivo y ver qué cambió.
Necesitas Python 3.10 o posterior. El CLI usa la biblioteca estándar de Python.
git clone https://github.com/DannyBaanks/OpenSwift.git
cd OpenSwift
# Abre una sesión para el ejemplo incluido
PYTHONPATH="$PWD" python3 -m openswift focus examples/hello.swift \
--intent "darle más aire al panel"
# Genera la preview y consulta la sesión
PYTHONPATH="$PWD" python3 -m openswift render --device iphone-16-pro
PYTHONPATH="$PWD" python3 -m openswift statusCada render guarda otra iteración en .ui-session/iterations/. El PNG sale del mismo SVG que dibuja el Studio (con Chrome/Chromium, cairosvg, rsvg-convert o inkscape si hay alguno instalado; si no, un pintor mínimo integrado, y status lo avisa), así que nunca se desfasa del dibujo.
Puedes pedir varios frames de una vez; cada uno se acomoda a su propia pantalla:
PYTHONPATH="$PWD" python3 -m openswift render --device iphone-12,iphone-16-pro,ipad-air-11
PYTHONPATH="$PWD" python3 -m openswift render --device phones --appearance bothEl primero es la iteración (001.png); los demás quedan como 001-<dispositivo>-<look>.png, junto a una hoja comparativa 001-sheet.png. En el Studio web, el selector View muestra lo mismo en pantalla. La preview actual queda en .ui-session/preview.png y su SVG en .ui-session/preview.svg.
Para cerrar la sesión, elimina .ui-session/target.json cuando ya no necesites el límite de escritura. Los archivos de evidencia de la sesión se conservan.
La app de escritorio usa Tauri 2, Bun, Rust y Python 3. Desde la raíz del clon:
cd app
bun install
bun run tauri devAbre una carpeta de proyecto, elige un archivo .swift y pulsa Run. Save escribe los cambios en el archivo abierto; Ctrl+S guarda y Ctrl+Enter vuelve a dibujar. La app no ejecuta breakpoints ni compila Swift.
Para compilar los paquetes disponibles en tu plataforma:
bun run tauri buildEn Linux se generan los paquetes disponibles, incluido .deb, .rpm y AppImage. En Windows, Tauri integra icon.ico en el ejecutable y usa los paquetes nativos disponibles. La compilación requiere las dependencias nativas de desarrollo de Tauri. Consulta la guía de Tauri para los requisitos de tu sistema.
Descarga los instaladores de escritorio desde Releases. El release v0.5 incluye un instalador NSIS .exe para Windows, un .AppImage para Linux y sus checksums SHA-256.
Desde la raíz de OpenSwift, apunta PYTHONPATH al clon y pasa la carpeta del proyecto que quieras abrir:
OPENSWIFT_DIR="$PWD"
PYTHONPATH="$OPENSWIFT_DIR" python3 -m openswift studio \
"/ruta/a/tu/proyecto" --port 8765Abre http://127.0.0.1:8765. El Studio web incluye selector de dispositivo, modo Live (redibuja al escribir), tema claro/oscuro, aviso de cambios sin guardar y un panel Session con el objetivo activo. En examples/ hay pantallas de muestra (login, settings, dashboard). El servidor sólo acepta los hosts locales esperados, bloquea orígenes externos y comprueba que las rutas permanezcan dentro del proyecto. Si hay una .ui-session/target.json, también aplica su lista de escritura permitida.
# Dibujar un SVG sin crear sesión
PYTHONPATH="$PWD" python3 -m openswift draw examples/hello.swift \
--device iphone-15 --output /tmp/hello.svg
# Revisar el árbol como JSON
PYTHONPATH="$PWD" python3 -m openswift sketch examples/hello.swift \
--device iphone-12
# Modo claro y carcasa distinta, o sólo la pantalla sin marco
PYTHONPATH="$PWD" python3 -m openswift draw examples/dashboard.swift \
--device iphone-16-pro --appearance light --frame natural --output /tmp/dash.svg
# iPad en horizontal, y la sesión también acepta --appearance/--frame/--orientation
PYTHONPATH="$PWD" python3 -m openswift draw examples/gallery.swift \
--device ipad-pro-11 --orientation landscape --output /tmp/gallery.svg
PYTHONPATH="$PWD" python3 -m openswift render --device iphone-16 --appearance light --orientation landscape
# Ver las opciones disponibles
PYTHONPATH="$PWD" python3 -m openswift --helpDispositivos incluidos: iphone-11, iphone-12, iphone-13, iphone-14, iphone-14-plus, iphone-14-pro, iphone-15, iphone-15-plus, iphone-15-pro, iphone-16, iphone-16-plus, iphone-16-pro e iphone-16-pro-max, más ipad-10, ipad-air-11, ipad-pro-11 e ipad-pro-13. Con --orientation landscape cualquiera se dibuja de lado.
| SwiftUI | Resultado aproximado |
|---|---|
VStack, HStack, ZStack |
Layout básico y espaciado |
Text, Button |
Texto, tamaño, peso y color básico |
Spacer, Divider |
Separación y divisor |
TextField, SecureField, Label, Image |
Caja etiquetada |
Form, Section, List, ScrollView |
Contenedores verticales |
NavigationStack, Group, GroupBox |
Contenedores del sketch |
Toggle, TextField, SecureField, Label, Image |
Interruptor iOS, campos redondeados, icono marcador |
Padding, fondo, degradados (LinearGradient), cornerRadius, clipShape, shadow, opacity, frame(width:height:maxWidth:) |
Modificadores compatibles del preview |
.font(.title…), .fontWeight, colores del sistema (.blue, .gray, .secondary…), Color(hex:), .buttonStyle |
Tipografía y color estilo iOS |
ForEach (rangos, arrays literales; si no, 3 copias) y vistas propias del mismo archivo (Tile()) |
Se expanden con su body |
Image(systemName:) / Label(systemImage:) |
~20 SF Symbols redibujados (heart, star, bell, house, person, gearshape…); el resto, un icono marcador |
.sheet, bindings, animaciones |
No se ejecutan; pueden aparecer como cajas o avisos |
La salida ayuda a conversar sobre composición y proporciones. No representa fielmente el comportamiento, tipografía ni layout final de SwiftUI en iOS.
Una sesión guarda:
.ui-session/
├── target.json # objetivo, permitidos, proveedor e iteración
├── intent.md # objetivo expresado en palabras
├── source.swift # copia de referencia
├── preview.svg # último sketch vectorial
├── preview.png # último sketch rasterizado
├── preview.sha256 # hash de la preview PNG
└── iterations/ # previews anteriores y sus hashes
Studio bloquea las escrituras fuera de target y allowed mientras exista target.json. El límite se aplica al guardar desde Studio; no es un sandbox del sistema operativo ni restringe herramientas externas que editen archivos directamente.
| Provider | Estado |
|---|---|
approximate-web |
Activo; dibuja SVG y PNG localmente |
miniswift |
Nombre reservado; todavía no está conectado |
xcode-preview |
Nombre reservado; todavía no está conectado |
PYTHONPATH="$PWD" python3 -m unittest discover -s testsEl editor puede usar el lexer msf para colorear Swift. Es opcional: para compilarlo se requiere Git y un compilador C:
./tools/build-lex.shEl código de msf no está incluido en el repositorio. Está fijado a un commit y su licencia/procedencia se documenta en NOTICE.md.
El icono maestro está en app/src-tauri/icons/openswift-icon.svg. Para regenerar los iconos multiplataforma después de editarlo:
cd app
bun run tauri icon ./src-tauri/icons/openswift-icon.svg --output ./src-tauri/iconsHecho para que humanos y agentes puedan mirar la misma pantalla y hablar de cambios concretos.
