{"id":13372978,"url":"https://github.com/vinhnx/clendar","last_synced_at":"2025-05-15T07:06:59.059Z","repository":{"id":38085190,"uuid":"177301105","full_name":"vinhnx/Clendar","owner":"vinhnx","description":"Clendar - Minimal Calendar app. Written in SwiftUI.","archived":false,"fork":false,"pushed_at":"2025-03-20T14:14:21.000Z","size":22530,"stargazers_count":667,"open_issues_count":78,"forks_count":87,"subscribers_count":12,"default_branch":"main","last_synced_at":"2025-04-14T13:00:14.366Z","etag":null,"topics":["apple","calendar","catalyst","eventkit","fastlane","github-actions","ios","ipad","iphone","macos","siri","swift","swift-package-manager","swiftformat","swiftlint","swiftui","watchos","widget"],"latest_commit_sha":null,"homepage":"https://apps.apple.com/app/clendar-a-calendar-app/id1548102041","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/vinhnx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"vinhnx","patreon":"vinhnx","open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2019-03-23T14:48:23.000Z","updated_at":"2025-04-10T13:32:32.000Z","dependencies_parsed_at":"2023-10-21T13:18:16.823Z","dependency_job_id":"9b02fd3c-dd9b-4895-8d28-c8717a15cc0d","html_url":"https://github.com/vinhnx/Clendar","commit_stats":{"total_commits":894,"total_committers":13,"mean_commits":68.76923076923077,"dds":"0.15324384787472034","last_synced_commit":"d55e99b58842e066fa8c254f4f5a0f049127c85a"},"previous_names":[],"tags_count":91,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vinhnx%2FClendar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vinhnx%2FClendar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vinhnx%2FClendar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vinhnx%2FClendar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vinhnx","download_url":"https://codeload.github.com/vinhnx/Clendar/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254292042,"owners_count":22046426,"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":["apple","calendar","catalyst","eventkit","fastlane","github-actions","ios","ipad","iphone","macos","siri","swift","swift-package-manager","swiftformat","swiftlint","swiftui","watchos","widget"],"created_at":"2024-07-30T04:00:50.056Z","updated_at":"2025-05-15T07:06:54.050Z","avatar_url":"https://github.com/vinhnx.png","language":"Swift","funding_links":["https://github.com/sponsors/vinhnx","https://patreon.com/vinhnx"],"categories":["Open source apps"],"sub_categories":["iOS"],"readme":"[![SwiftLint](https://github.com/vinhnx/Clendar/actions/workflows/swiftlint.yml/badge.svg)](https://github.com/vinhnx/Clendar/actions/workflows/swiftlint.yml)\n\n---\n\nHi everyone,\n\nI wanted to provide an update regarding the Clendar app. Due to some personal matters, I haven't been able to dedicate much time to maintaining the app recently.\n\nI'm truly grateful for all the support and contributions from the Open Source community over the past years. Your encouragement and assistance have meant a lot to me and motivated me to continually improve the app. Unfortunately, I've had to step back temporarily to address some personal matters.\n\n[This app started out as just my personal project to catch up with annual WWDC changes](https://github.com/vinhnx/Clendar?tab=readme-ov-file#about), and one day I decided to convert the whole app from Swift \u0026 UIKit to SwiftUI.\n\nThe rest is history, and the stars keep rising 🌟❤️.\n\nWords simply cannot describe how grateful I am for all your [contributions and warm messages](https://github.com/vinhnx/Clendar/issues). I'm touched that everyone [loves](https://github.com/vinhnx/Clendar/stargazers) this small app and project as much as I do.\n\nClendar will always be in my heart.\n\nThank you for your understanding and patience. I look forward to resuming work on Clendar and continuing to engage with this fantastic community.\n\nBest regards,\n\nVinh Nguyen\n\n---\n\n\u003ch1 align=\"center\"\u003e\nClendar - Minimal Calendar\n\u003c/h1\u003e\n\u003cp align=\"center\"\u003eMinimal Calendar \u0026 Widget\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"https://is1-ssl.mzstatic.com/image/thumb/Purple116/v4/1c/4f/b7/1c4fb766-21ba-d822-4370-c7ad59bf6b8f/AppIcon-0-2x-4-85-220.png/230x0w.webp\"\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003ca href=\"https://apps.apple.com/app/clendar-a-calendar-app/id1548102041#?platform=iphone\"\n                style=\"display: inline-block; overflow: hidden; border-top-left-radius: 13px; border-top-right-radius: 13px; border-bottom-right-radius: 13px; border-bottom-left-radius: 13px; width: 250px; height: 83px;\"\u003e\u003cimg\n                    src=\"https://apple-resources.s3.amazonaws.com/media-badges/download-on-the-app-store/white/en-us.svg\"\n                    alt=\"Download on the App Store\"\n                    style=\"border-top-left-radius: 13px; border-top-right-radius: 13px; border-bottom-right-radius: 13px; border-bottom-left-radius: 13px; width: 250px; height: 83px;\"\u003e\u003c/a\u003e\u003c/p\u003e\n\n\u003e [Landing Page](http://vinhnx.github.io/clendar-site)\n\n### Architecture\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"clenda_new_diagram.png\" alt=\"diagram\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cem\u003e* Diagram generated by \u003ca href=\"https://github.com/ahmedkhaleel2004/gitdiagram\"\u003egitdiagram\u003c/em\u003e\n\u003c/p\u003e\n\n### Table of Contents\n\n- 📋 [About](#about)\n- 🚀 [What's Clendar](#whats-clendar)\n- 📦 [SwiftUI](#swiftui)\n- 💻 [Tip to build on M1 Macs](#tip-to-build-on-m1-macs)\n- 📚 [Tech stacks](#tech-stacks)\n- 📖 [Requirements](#requirements)\n- 💖 [My own Swift Packages currently used in Clendar](#my-own-swift-packages-currently-used-in-clendar)\n- 📝 [Contributing](#contributing)\n- 📂 [Important Files To Look At](#important-files-to-look-at)\n- 🙌 [Contributors](#contributors)\n- ⚖️ [License](#license)\n- 🏆 [Open-source inspiration](#open-source-inspiration)\n  \n### About\n\nThis project started out as a UIKit-based app for me to learn new WWDC features over the years. But one day, I decided to convert the whole app from UIKit to SwiftUI and boom, here we are.\n\nThis is the PR =\u003e [https://github.com/vinhnx/Clendar/pull/35](https://github.com/vinhnx/Clendar/pull/35)\n\n### What's 'Clendar'?\n\nIt's just Calendar, without an 'a'. I thought it was unique, but it turns out it's not going well with ASO (App Store Optimization) and SEO (Search Engine Optimization).\n\nClendar is a calendar app made simpler. The application includes features like widgets, themes, keyboard shortcuts, and natural language parsing.\n\nIts main features include:\n\n- Widgets, with customizable dark/light themes\n- Keyboard shortcuts\n- Siri shortcuts\n- Apple Watch complications\n- Custom app icons\n- Natural language parsing\n- Lunar day view\n- Dark and light modes built-in\n- Accessibility support\n- Localizations support\n\n### SwiftUI\n\n📖 I believe the best way to learn is by doing. [SwiftUI](https://developer.apple.com/xcode/swiftui/) is evolving and I think it's the future of writing apps.\n\n\u003e SwiftUI is an innovative, exceptionally simple way to build user interfaces across all Apple platforms with the power of Swift. Build user interfaces for any Apple device using just one set of tools and APIs.\n\u003e\n\u003e -- Apple\n\nThe true power of SwiftUI, to me, is its flexibility, thanks to its vast realm of view modifiers and expressiveness with property wrappers.\n\nYou can create a \"Hello, World!\" app with just a few lines of code (check out the new [@main](https://developer.apple.com/documentation/swiftui/app/main()) attribute!) or even, [a calendar view](https://gist.github.com/mecid/f8859ea4bdbd02cf5d440d58e936faec).\n\nSwiftUI gives you the most flexible tool an Apple developer could ever ask for, all you need is a bit of creativity, and the [possibilities](https://github.com/Juanpe/About-SwiftUI), [are](https://github.com/chinsyo/awesome-swiftui), [limitless](https://github.com/onmyway133/awesome-swiftui).\n\nClendar would not be possible without the public knowledge of the community. To name a few, in no particular order:\n\n- [swiftwithmajid.com](https://swiftwithmajid.com)\n- [raywenderlich.com](https://raywenderlich.com)\n- [swiftbysundell.com](https://www.swiftbysundell.com)\n- [hackingwithswift.com](https://www.hackingwithswift.com)\n- [sarunw.com](https://sarunw.com)\n- [onmyway133/blog/issues](https://github.com/onmyway133/blog/issues)\n- [swiftui](https://github.com/topics/swiftui)\n\nMy notes about SwiftUI:\n\n- [notes/issues](https://github.com/vinhnx/notes/issues?q=is%3Aissue+is%3Aopen+swiftui+label%3ASwiftUI)\n- [notes/issues/342](https://github.com/vinhnx/notes/issues/342)\n\nBy publishing Clendar, I would like to give back to the community. 😊\n\n### Tip to build on M1 Macs\n\n\u003e So, maybe someone, who wants to contribute to this repo will find the next info very helpful.\n\u003e If you have a MacBook on M1:\n\u003e\n\u003e ```bash\n\u003e sudo arch -x86_64 gem install ffi\n\u003e arch -x86_64 pod install\n\u003e ```\n\u003e Or:\n\u003e\n\u003e run terminal with Rosetta and run `pod install`\n\u003e\u003e Thanks [https://github.com/vinhnx/Clendar/issues/220#issuecomment-1107809043](https://github.com/vinhnx/Clendar/issues/220#issuecomment-1107809043)\n\n### Tech stacks\n\nThe following technologies were used to develop our application:\n\nCore:\n\n- [SwiftUI](https://developer.apple.com/xcode/swiftui/) (and UIKit interoperability)\n- iPadOS\n- [WidgetKit](https://developer.apple.com/documentation/widgetkit)\n- [SiriKit](https://developer.apple.com/documentation/sirikit/)\n- EventKit/EvenKit UI - wrapper with my own [Shift package](https://github.com/vinhnx/Shift) 📆\n- [WatchKit](https://developer.apple.com/documentation/watchkit/)\n- Combine\n- Catalyst\n- [StoreKit](https://developer.apple.com/documentation/storekit)\n\nBuild delivery tool:\n\n- [Fastlane](https://fastlane.tools/)\n\nPackage Managers:\n\n- [Swift Package Manager](https://www.swift.org/package-manager/)\n- [CocoaPods](https://cocoapods.org/)\n\nLinter:\n\n- [SwiftLint](https://swiftpackageindex.com/realm/SwiftLint)\n\nFormatter:\n\n- [SwiftFormat](https://formulae.brew.sh/cask/swiftformat-for-xcode)\n\nAction:\n\n- [SwiftLint is integrated on GitHub Action workflow](https://github.com/vinhnx/Clendar/actions?query=workflow%3ASwiftLint) 🚀\n\n### Requirements\n\n(for async/await):\n\n- Xcode 13.1\n- iOS 15.0\n- watchOS 8.0\n- Ruby (for Fastlane build automation)\n\n### My own Swift Packages currently used in Clendar\n\n- [Shift](https://github.com/vinhnx/Shift) - Result-based wrapper for EventKit. SwiftUI supported!\n- [Laden](https://github.com/vinhnx/Laden) - SwiftUI loading indicator view\n\n### Contributing\n\nContributing is more than welcome. If you feel like helping the app or want to add new features, feel free to take a look at my [issues page](https://github.com/vinhnx/Clendar/issues). Thanks!\n\nHow To Contribute:\n\n- Report issues you're facing\n- Give a 👍 on issues that are relevant to you\n- Answer queries on the issue tracker\n\nIf you don't know where to start:\n\n- Navigate to the [issues page](https://github.com/vinhnx/Clendar/issues)\n- Filter by label\n- Look for issues related to [good first issue](https://github.com/vinhnx/Clendar/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22)\n- Feel free to look at all the issues opened and pick one that interests you!\n\n1. Fork the project repository by clicking Fork in the top right-hand corner 🍴\n2. Clone the repository onto your local machine using the Git URL 💻\n3. Switch to the branch you want to work on and start contributing! 📝 \n\nWhen submitting an issue, please make sure your description is clear and has enough information for someone to be able to reproduce the issue!\n\n### Important Files To Look At\n\n- [Clendar](https://github.com/vinhnx/Clendar/tree/main/Clendar)\n  - Clendar application program\n- [ClendarTests](https://github.com/vinhnx/Clendar/tree/main/ClendarTests)\n  - Contents to test the Clendar program on iOS software\n- [ClendarUITests](https://github.com/vinhnx/Clendar/tree/main/ClendarUITests)\n  - Contents to test the Clendar UI on iOS software\n- [ClendarWatchApp Extension](https://github.com/vinhnx/Clendar/tree/main/ClendarWatchApp%20Extension)\n  - Contents used to create Clendar compatibility to watchOS using SwiftUI\n- [Packages](https://github.com/vinhnx/Clendar/tree/main/Packages)\n  - Contains Clendar theme and SwiftUI calendar view\n\n### Contributors\n\nHuge thanks to everyone who took their precious time and effort to contribute to the project:\n\n- [Aleksandr Sutulov](https://github.com/AlexanderSutul)\n- [Jan Matoniak](https://github.com/kapucnov2321)\n- [Prabaljit Walia](https://github.com/prabal4546)\n- [Gaurav Kakkar](https://github.com/shadowfax90)\n- [Andrey Bozhko](https://github.com/AndreyBozhko)\n- [carboitel](https://github.com/carboitel)\n- [Michele Zenoni](https://github.com/Levyathanus)\n- [Samis](https://github.com/samis0707)\n- 💡 [your name here?...](https://github.com/vinhnx/Clendar/issues) \n\nWords simply cannot describe how thankful I am. I'm deeply appreciative of all your kind contributions. \n\nI feel very lucky that my small side project helps people find inspiration 💙\n\nThank you again, you rock!\n\n🇺🇳 🚀\n\n### License\n\n[MIT License](https://github.com/vinhnx/Clendar/blob/main/LICENSE)\n\nYou can do whatever you want with this source code: modify, tweak, or use it as learning resources, for example... 🛠👨🏻‍💻👩🏻‍💻\n\nBut, please don't re-distribute the app on the App Store with a different name. 🥺\n\nAnd, if you like, you can download the app for free on the [App Store](https://apps.apple.com/us/app/clendar-a-calendar-app/id1548102041?itsct=apps_box\u0026itscg=30200).\n\n### Open-source inspiration\n\n- [Hackers is an elegant iOS app for reading Hacker News written in Swift.](https://github.com/weiran/Hackers)\n- [jeffreybergier](https://github.com/jeffreybergier)\n\n---\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=vinhnx/Clendar\u0026type=Date)](https://star-history.com/#vinhnx/Clendar\u0026Date)\n\n---\n\nThanks and take care! 🍀\n\nI'm `@vinhnx` on almost everywhere.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvinhnx%2Fclendar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvinhnx%2Fclendar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvinhnx%2Fclendar/lists"}