ShipSwift

Biblioteca de componentes SwiftUI nativa para IA: código listo para producción que los LLM pueden usar para crear aplicaciones reales.

Inicio rápido · Componentes · Estructura de directorios · Recetas · Contribución

¿Qué es ShipSwift?

Un comando le da a tu IA todo lo que necesita: componentes SwiftUI listos para producción, recetas full-stack y el contexto para crear aplicaciones reales sin adivinar. Consulta más recetas MCP.

Descarga la aplicación de demostración para previsualizar cada componente en tu dispositivo.

Related MCP server: xcforge

Inicio rápido

Opción 1: Servidor de Habilidades + Recetas (Recomendado)

Paso 1 — Instala las habilidades de ShipSwift:

npx skills add signerlabs/shipswift-skills

Paso 2 — Conecta el servidor de recetas para que tu IA pueda obtener recetas:

# Claude Code
claude mcp add --transport http shipswift https://api.shipswift.app/mcp

# Gemini CLI
gemini mcp add --transport http shipswift https://api.shipswift.app/mcp

Para Cursor, VS Code Copilot, Windsurf y otras herramientas, consulta el repositorio de habilidades para la configuración de MCP.

Paso 3 — Pregúntale a tu IA:

• "Añade una animación de carga tipo shimmer"

• "Crea un flujo de autenticación con Cognito"

• "Muéstrame todos los componentes de gráficos"

Opción 2: Habilidades locales (No requiere MCP)

Instala habilidades que lean archivos fuente directamente desde este repositorio: funciona sin conexión, no se necesita servidor:

npx skills add signerlabs/ShipSwift

Tu IA puede entonces navegar por el catálogo de componentes y leer el código fuente localmente. Prueba:

• "Explora las recetas de ShipSwift"

• "Añade una animación shimmer"

• "Crea una función de chat"

Consejo: Si también conectas el servidor MCP (Opción 1), tu IA obtiene acceso a recetas Pro adicionales (guías de backend, plantillas de cumplimiento, documentos sobre errores comunes).

Opción 3: Copia de archivos

1. Clona este repositorio

2. Copia los archivos que necesites de ShipSwift/SWPackage/ a tu proyecto de Xcode

3. Cada componente en SWAnimation/, SWChart/ y SWComponent/ es autónomo: solo copia el archivo y SWUtil/ si es necesario

Ejecutar la aplicación de demostración

git clone https://github.com/signerlabs/ShipSwift.git
cd ShipSwift
open ShipSwift.xcodeproj

Selecciona un simulador o dispositivo, luego presiona Cmd+R para compilar y ejecutar.

Componentes

SWAnimation — Componentes de animación

BeforeAfterSlider · TypewriterText · ShakingIcon · Shimmer · GlowSweep · LightSweep · ScanningOverlay · AnimatedMeshGradient · OrbitingLogos

SWChart — Componentes de gráficos

LineChart · BarChart · AreaChart · DonutChart · RingChart · RadarChart · ScatterChart · ActivityHeatmap

SWComponent — Componentes de interfaz de usuario

Visualización: FloatingLabels · ScrollingFAQ · RotatingQuote · BulletPointText · GradientDivider · Label · MarkdownText · OnboardingView · OrderView · RootTabView · VideoPlayer Retroalimentación: Alert · Loading · ThinkingIndicator Entrada: TabButton · Stepper · AddSheet · SearchBar

SWModule — Frameworks de múltiples archivos

• SWAuth — Autenticación de usuario (Amplify/Cognito, inicio de sesión social, correo/contraseña, inicio de sesión telefónico con selector de código de país)

• SWCamera — Captura de cámara con visor, zoom, selector de fotos y detección facial con seguimiento de puntos de referencia de Vision

• SWPaywall — Muro de pago de suscripción usando StoreKit 2 — Cliente iOS incluido gratis. Receta full-stack (backend + cumplimiento + errores comunes) → Pro

• SWChat — Vista de chat todo en uno con lista de mensajes, entrada de texto y reconocimiento de voz opcional (VolcEngine ASR)

• SWSetting — Plantilla de página de configuración con cambio de idioma, compartir, enlaces legales, aplicaciones recomendadas

• SWSubjectLifting — Eliminación de fondo usando VisionKit ImageAnalysis

• SWTikTokTracking — Integración de la API de eventos de TikTok para seguimiento de atribución — Cliente iOS incluido gratis. Receta full-stack (backend + cumplimiento + errores comunes) → Pro

SWUtil — Utilidades compartidas

DebugLog · Extensiones de String/Date/View · LocationManager

Estructura de directorios

ShipSwift/
├── SWPackage/
│   ├── SWAnimation/          # Animation components
│   ├── SWChart/              # Chart components
│   ├── SWComponent/          # UI components
│   │   ├── Display/          #   Display components
│   │   ├── Feedback/         #   Feedback components
│   │   └── Input/            #   Input components
│   ├── SWModule/             # Multi-file frameworks
│   │   ├── SWAuth/           #   Authentication
│   │   ├── SWCamera/         #   Camera + face detection
│   │   ├── SWPaywall/        #   Subscription paywall
│   │   ├── SWChat/           #   Chat + voice input
│   │   ├── SWSetting/        #   Settings page
│   │   ├── SWSubjectLifting/ #   Background removal
│   │   └── SWTikTokTracking/ #   TikTok attribution
│   └── SWUtil/               # Shared utilities
├── View/                     # Showcase app views
├── Service/                  # App services
└── Component/                # Shared app components

Convención de nombres

Todos los tipos usan el prefijo SW (p. ej., SWAlertManager, SWStoreManager). Los modificadores de vista usan el prefijo en minúsculas .sw (p. ej., .swAlert(), .swPageLoading(), .swPrimary).

Reglas de dependencia

SWUtil        ← no dependencies on other SWPackage directories
SWAnimation   ← may depend on SWUtil only
SWChart       ← may depend on SWUtil only
SWComponent   ← may depend on SWUtil only
SWModule      ← may depend on SWUtil and SWComponent

Recetas

ShipSwift proporciona recetas gratuitas y pro a través de Habilidades: cada receta incluye código fuente completo de SwiftUI, pasos de implementación y mejores prácticas. Tu asistente de IA puede recuperar cualquier receta bajo demanda.

• Recetas Pro: incluye backend completo, plantillas de cumplimiento y guías de errores comunes. Próximamente: Notificaciones push, Panel de análisis.

Hay tres herramientas disponibles: listRecipes, getRecipe, searchRecipes.

Más información en shipswift.app · Repositorio de habilidades: signerlabs/shipswift-skills

Gratis vs Pro

Todo el código del cliente iOS es de código abierto bajo la licencia MIT. Las recetas Pro añaden todo lo necesario para pasar del prototipo a la producción.

Próximamente más recetas Pro: Notificaciones push, Panel de análisis.

Consulta los precios para más detalles.

Stack tecnológico

• SwiftUI + Swift

• StoreKit 2

• Amplify SDK (Cognito)

• AVFoundation + Vision

• SpriteKit

• VolcEngine ASR

Contribución

¡Las contribuciones son bienvenidas! Por favor, sigue estos pasos:

1. Haz un fork del repositorio

2. Crea una rama de funciones (git checkout -b feature/amazing-feature)

3. Confirma tus cambios (git commit -m 'Add amazing feature')

4. Envía a la rama (git push origin feature/amazing-feature)

5. Abre una Pull Request

Estilo de código

• Todos los comentarios y documentación en inglés

• Todos los tipos usan el prefijo SW

• Cada archivo en SWAnimation/, SWChart/ y SWComponent/ debe ser autónomo

• Sigue los patrones de código y convenciones de nombres existentes

Licencia

Este proyecto está bajo la Licencia MIT: consulta el archivo LICENSE para más detalles.

Historial de estrellas

Hecho con ❤️ por SignerLabs