{"id":22339654,"url":"https://github.com/pierrejanineh-com/clukui","last_synced_at":"2026-05-13T12:44:07.927Z","repository":{"id":207557610,"uuid":"719175610","full_name":"PierreJanineh-com/ClukUI","owner":"PierreJanineh-com","description":"ClukUI is a Swift package offering elegant clock visualizations for SwiftUI. Perfect for iOS, macOS, and tvOS apps, it's easy to integrate and customize. Enhance your apps with stylish time displays!","archived":false,"fork":false,"pushed_at":"2023-11-17T15:20:14.000Z","size":29,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-07T06:16:58.810Z","etag":null,"topics":["clock","swiftui"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PierreJanineh-com.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-11-15T16:01:58.000Z","updated_at":"2023-11-18T19:44:04.000Z","dependencies_parsed_at":"2023-11-16T12:50:55.332Z","dependency_job_id":null,"html_url":"https://github.com/PierreJanineh-com/ClukUI","commit_stats":null,"previous_names":["pierrejanineh-com/clukui"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PierreJanineh-com%2FClukUI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PierreJanineh-com%2FClukUI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PierreJanineh-com%2FClukUI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PierreJanineh-com%2FClukUI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PierreJanineh-com","download_url":"https://codeload.github.com/PierreJanineh-com/ClukUI/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245623078,"owners_count":20645680,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["clock","swiftui"],"created_at":"2024-12-04T07:09:01.296Z","updated_at":"2025-10-19T10:14:48.129Z","avatar_url":"https://github.com/PierreJanineh-com.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ClukUI\n\n[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2FPierreJanineh-com%2FClukUI%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/PierreJanineh-com/ClukUI)\n[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2FPierreJanineh-com%2FClukUI%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/PierreJanineh-com/ClukUI)\n\n## Overview\nClukUI is a Swift package designed to provide elegant and easy-to-integrate clock visualizations for SwiftUI applications. Perfect for apps that require time-related components with a sleek and modern design.\n\n## Features\n- Customizable clock faces\n- Support for both analog and digital formats\n- Easy integration with SwiftUI\n- Lightweight and optimized for performance\n- Adaptive design for iOS, tvOS and macOS\n\n## Requirements\n- iOS 13.0+ / macOS 10.14+ / tvOS 13.0+\n- Xcode 12.0+\n- Swift 5.9+\n\n## Installation\nTo install ClukUI, simply add it to your project as a Swift Package:\n\n1. In Xcode, open your project and navigate to `File → Swift Packages → Add Package Dependency`.\n2. Paste the repository URL: `https://github.com/PierreJanineh-com/ClukUI`\n4. Select the version you want to use.\n\n## Usage\n```swift\nimport SwiftUI\nimport ClukUI\n\nstruct ContentView: View {\n    var body: some View {\n        ClukView(date: .now)\n        ClukView() //With no value for default Date()\n    }\n}\n```\n\n## Current Development Status\n### Version: `PRE-RELEASE`\n**Developed Features:**\n- **Basic Clock Visualization**: The package currently includes `ClukView`, a SwiftUI view that visualizes a simple analog clock. This view displays the current time with hour, minute, and second hands.\n- **Customizability**: Users can customize the displayed time by passing a Date variable to ClukView.\n- **Cross-Platform Support**: The clock visualization is compatible with iOS, tvOS, and macOS platforms, adhering to adaptive design principles for each platform.\n- **Environment Integration**: Designed for seamless integration into SwiftUI applications.\n\n**Code Implementation:**\n- The package uses SwiftUI to create the clock visualization.\n- A `@State` property for the current time allows the clock to be updated in real-time.\n- Custom struct `ClukHand` is used to draw the clock hands.\n\n## Future Development Roadmap\n### Short-Term Goals:\n- **Refinement of Current Features**: Enhance the visual appeal and accuracy of the analog clock. This could include smoothing the movement of the clock hands and adding options for different clock hand styles.\n- **Improved Customizability**: Allow users to customize more aspects of the clock, such as hand colors, clock face design, seconds ticking, and adding tick marks or numbers.\n\n### Mid-Term Goals:\n- **Digital Clock Format**: Introduce an option to switch between analog and digital clock formats. This includes designing a digital clock face within the ClukView.\n- **Complex Time Formats**: Support for different time formats, including 24-hour format and varying time zones.\n\n### Long-Term Goals:\n- **Additional Time-Related Components**: Develop more components such as countdown timers, stopwatches, and world clocks.\n- **Interactive Features**: Add functionalities like setting alarms or timers directly from the clock interface.\n- **Localization and Accessibility**: Ensure the package supports multiple languages and is accessible to users with disabilities.\n\n## Contribution Opportunities\nContributions are welcome! If you'd like to contribute, please fork the repository and use a feature branch. Pull requests are warmly welcome.\n- **Design Contributions**: Graphics designers can contribute to creating various clock face designs and themes.\n- **Feature Development**: Developers can contribute to implementing new features such as the digital clock format or additional time-related components and current open issues.\n- **Testing and Feedback**: Users and developers are welcome to test the package in different scenarios and provide feedback for improvements.\n\n## License\nClukUI is available under the MIT license. See the LICENSE file for more info.\n\n## Contact\nFor support or queries, please reach out to clukui@pierrejanineh.com.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpierrejanineh-com%2Fclukui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpierrejanineh-com%2Fclukui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpierrejanineh-com%2Fclukui/lists"}