À propos du projet
ShipSwift est une bibliothèque de composants SwiftUI open-source conçue pour être consommée par des assistants de codage IA. Elle regroupe du code UI prêt pour la production accompagné de recettes — étapes d'implémentation et recommandations — afin que les modèles de langage puissent générer des fonctionnalités réelles pour applications iOS au lieu de deviner les API.
Ce qu'elle contient :
- SWAnimation : environ 30 composants d'animation, incluant des effets SwiftUI (scintillement, texte machine à écrire, icône qui tremble, lueur/trajets lumineux, balayage, dégradé animé en maillage, curseur avant/après, logos en orbite), des pièces 3D rendues via Canvas (sphère de points, sphère de caractères) et des arrière-plans procéduraux Metal (champ d'étoiles, nuages fractals, fumée d'encre, chrome liquide, plasma, métaballes, trame, eau, Voronoi, bruit de Simplex et autres).
- SWChart : graphiques linéaire, en barres, en aires, en anneau, radar, à dispersion et heatmap d'activité.
- SWComponent : blocs de base d'affichage, retour et saisie tels que labels flottants, FAQ déroulante, citation rotative, texte Markdown, vue d'intégration, vue de commande, vue d'onglets racine, lecteur vidéo, alertes, états de chargement, indicateur de réflexion, boutons d'onglets, compteurs (steppers), formulaires ajout et barres de recherche.
- SWModule : frameworks multi-fichiers couvrant l'authentification (Amplify/Cognito, connexion sociale et téléphonique), capture caméra avec détection faciale Vision, écran de paiement abonnement StoreKit 2, vue de chat avec reconnaissance vocale optionnelle, modèle de page paramètres, suppression d'arrière-plan via VisionKit et suivi d'attribution TikTok Events API.
- SWUtil : utilitaires partagés tels que journalisation debug, extensions chaîne/date/vue et gestionnaire de localisation.
Comment l'utiliser :
Trois chemins d'intégration sont documentés. Le chemin recommandé installe des « skills » via npx et connecte un endpoint MCP server pour que l'assistant puisse récupérer les recettes à la demande ; une variante locale lit directement les fichiers source depuis le dépôt sans serveur ; et un chemin manuel consiste simplement à copier les fichiers de SWPackage dans un projet Xcode. Chaque composant est décrit comme autonome, avec une règle de dépendance indiquant que SWUtil n'a aucune dépendance interne, que SWAnimation/SWChart/SWComponent peuvent dépendre uniquement de SWUtil, et que SWModule peut dépendre de SWUtil et SWComponent. Les types utilisent un préfixe SW et les modificateurs de vue un préfixe .sw minuscule.
Licence et périmètre :
Tout le code client iOS est sous licence MIT. Certaines recettes sont marquées Pro et ajoutent des détails d'implémentation backend, checklists d'intégration, modèles de conformité et notes de pièges ; le README mentionne également un service de développement d'applications payant. Une application companion de démonstration est disponible sur l'App Store pour prévisualiser les composants sur un appareil. Le projet cible Swift 5.0+ et iOS 18.0+, et cite SwiftUI, StoreKit 2, Amplify SDK, AVFoundation/Vision, SpriteKit et VolcEngine ASR parmi ses technologies. Les contributions sont acceptées via fork et pull request, avec commentaires en anglais et respect des conventions de nommage et de dépendance.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.