TOURKIT : l’onboarding façon Apple pour vos apps Mac
⏱️ Temps de lecture estimé : 3 minutes
https://github.com/rampatra/TourKit
📌 TourKit est un package Swift qui ajoute à votre application Mac une visite guidée en diaporama, façon écran d’accueil Apple, avec une fenêtre flottante prête à l’emploi.
Personne ne lit la documentation d’une app au premier lancement. On veut comprendre l’essentiel en trois écrans, puis passer à autre chose. TourKit prend ce problème à la racine : au lieu d’un carrousel à habiller soi-même, il livre un diaporama d’accueil complet, dessiné en SwiftUI et pensé pour macOS.
Concrètement, vous décrivez vos étapes dans un tableau de pages, puis vous les affichez de deux manières. Vous pouvez intégrer la vue dans une feuille ou une fenêtre que vous gérez déjà. Ou laisser TourKit présenter sa propre fenêtre : sans bordure, transparente, déplaçable par son fond, dimensionnée exactement à la carte. Deux appels suffisent, et rappeler la présentation ramène simplement la fenêtre au premier plan si elle existe déjà.
Chaque page est une TourPage avec une image, un titre et un sous-titre. L’image vient d’un catalogue d’assets, d’un bundle précis — pratique quand la ressource vit dans un package — ou d’un fichier sur disque (png, jpg, heic, tiff, gif, webp). TourKit conseille un ratio 16:10 et fige la hauteur de l’image à la création, pour que chaque diapositive s’affiche à la même taille, sans que la carte ne bouge d’un écran à l’autre.
Le rendu est sombre et soigné. Un dégradé fond le bas de l’illustration dans le panneau de texte, l’indicateur de page s’anime en pilules, et les boutons ronds reprennent un matériau verre, jusqu’au liquid glass sur les versions récentes du système. Le passage d’une page à l’autre se fait par un fondu très court, la flèche de retour disparaît sur la première page, et la touche Retour valide l’action principale. Titres, descriptions et libellés de boutons sont tous localisables, avec prise en charge de tables .strings et .xcstrings précises, voire d’un bundle de chaînes dédié.
- 🪟 Fenêtre flottante macOS prête à l’emploi, déplaçable par son fond
- 🖼️ Images depuis assets, bundle ou fichier disque (png, jpg, heic, gif, webp…)
- 🌍 Titres, sous-titres et boutons entièrement localisables
- ✨ Dégradé, indicateur animé, boutons en verre, retour clavier
- 🧩 Vue SwiftUI à intégrer dans votre propre mise en page
- 🪶 Aucune dépendance : SwiftUI et AppKit seulement
Deux réserves. TourKit ne vise que macOS 13 et plus, et iOS reste annoncé sans être encore livré. Les diapositives se limitent pour l’instant à une image, un titre et un texte : ni vidéo ni vue personnalisée par page, même si c’est sur la feuille de route. La licence MIT autorise l’usage personnel comme commercial, à condition de conserver la notice de copyright.
Je trouve le pari juste. TourKit ne cherche pas à tout faire : il donne une vue propre à intégrer et, pour ceux qui veulent l’effet Apple sans gérer les fenêtres, un contrôleur qui s’en charge. Une app Mac qui soigne son premier lancement en a vite pour son compte.
Sources
