How hhru/nivelir works
Nivelir is a Swift navigation DSL for iOS and tvOS. An app defines screens, then submits chainable routes to a navigator, which finds UIKit containers and performs stack, modal, tab, and window navigation. Deep links form a separate input path: the manager resolves URL, notification, or shortcut payloads, applies interceptors, and asks the navigator to navigate. The repository also provides UI addons, including a configurable bottom-sheet presentation system, plus decoding utilities used by deep-link handling. Addon relationships are limited where implementation excerpts were not provided.
Main entry points: DeeplinkManager.swift Deep Link Manager · ScreenNavigator.swift Screen Navigator · BottomSheetPresentationController.swift Sheet Presentation · BottomSheetController.swift Sheet Controller
Components 26
Screen Navigation
- Screen Definition
Sources/Screen/Screen.swift - Route DSL
Sources/Screen/Route/ScreenRoute.swift - Navigation Actions
Sources/Screen/Actions/ScreenAction.swift - Screen Navigator
Sources/Screen/Navigator/ScreenNavigator.swift - UIKit Containers
Sources/Screen/Container/ScreenContainer.swift - Navigation Observation
Sources/Screen/Observation/ScreenObserver.swift
Deep Links
- Link Inputs
Sources/Deeplink/URL/URLDeeplink.swift - Notification Links
Sources/Deeplink/Notification/NotificationDeeplink.swift - Shortcut Links
Sources/Deeplink/Shortcut/ShortcutDeeplink.swift - Deep Link Manager
Sources/Deeplink/DeeplinkManager.swift - Link Interceptors
Sources/Deeplink/DeeplinkInterceptor.swift - Link Storage
Sources/Deeplink/DeeplinkStorage.swift
UI Addons
- Screen Addon Actions
Sources/Addons - Media Picker
Sources/Addons/MediaPicker/MediaPickerManager.swift - Document Preview
Sources/Addons/DocumentPreview/DocumentPreviewManager.swift - Safari Launcher
Sources/Addons/Safari/SafariManager.swift - Sharing
Sources/Addons/Sharing/Sharing.swift - Progress HUD
Sources/Addons/HUD/HUD.swift
Bottom Sheet
- Bottom Sheet API
Sources/Addons/BottomSheet/BottomSheet.swift - Sheet Controller
Sources/Addons/BottomSheet/BottomSheetController.swift - Sheet Presentation
Sources/Addons/BottomSheet/Presentation/BottomSheetPresentationController.swift - Detent Resolver
Sources/Addons/BottomSheet/Detention/BottomSheetDetentionController.swift - Gesture Interaction
Sources/Addons/BottomSheet/Interaction/BottomSheetInteractionController.swift
Decoding Tools
- URL Query Decoder
Sources/Tools/URLQueryDecoder/URLQueryDecoder.swift - Dictionary Decoder
Sources/Tools/DictionaryDecoder/DictionaryDecoder.swift
Other components
- App
Connections 18
- App → Screen Definition: defines
- App → Route DSL: builds routes
- App → Screen Navigator: submits navigation
- Screen Navigator → UIKit Containers: finds containers
Sources/Screen/Navigator/ScreenNavigator.swift - Screen Navigator → Navigation Observation: supports observation
Sources/Screen/Navigator/ScreenNavigator.swift - Deep Link Manager → Screen Navigator: requests navigation
Sources/Deeplink/DeeplinkManager.swift - Deep Link Manager → Link Interceptors: runs interceptors
Sources/Deeplink/DeeplinkManager.swift - Deep Link Manager → Link Storage: stores resolved link
Sources/Deeplink/DeeplinkManager.swift - Deep Link Manager → URL Query Decoder: decodes URL query
Sources/Deeplink/DeeplinkManager.swift - Deep Link Manager → Dictionary Decoder: decodes payload
Sources/Deeplink/DeeplinkManager.swift - Media Picker → Screen Addon Actions: implements action
Sources/Addons/MediaPicker/MediaPickerManager.swift - Sheet Controller → Sheet Presentation: creates presentation
Sources/Addons/BottomSheet/BottomSheetController.swift - Sheet Presentation → Detent Resolver: resolves detents
Sources/Addons/BottomSheet/Presentation/BottomSheetPresentationController.swift - Sheet Presentation → Gesture Interaction: delegates gestures
Sources/Addons/BottomSheet/Presentation/BottomSheetPresentationController.swift - Sheet Controller → Bottom Sheet API: copies configuration
Sources/Addons/BottomSheet/BottomSheetController.swift - Link Inputs → Deep Link Manager: is resolved by
- Notification Links → Deep Link Manager: is resolved by
- Shortcut Links → Deep Link Manager: is resolved by