Code Monkey home page Code Monkey logo

clendar's Introduction

SwiftLint

πŸ’™ Clendar is now temporarily removed from sale. I will try to get it back soon, thank you all the for all supporting over the years, it means the world to me!

Hi everyone,

I 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.

I'm truly grateful for all the support and contributions from the Open Source community over the past year. 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.

Thank you for your understanding and patience. I look forward to resuming work on Clendar and continuing to engage with this fantastic community.

Best Regards,

Vinh Nguyen


Clendar - Minimal Calendar

Minimal Calendar & Widget

Download on the App Store

Landing Page

Table of Contents

About

This project is started out as an UIKit base app for me to learn new WWDC features over the years. But one day, I decided to convert the whole app from UIKit -> SwiftUI and boom, here we are.

This is the PR => #35

What's 'Clendar'?

It'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).

Clendar is a calendar app made simpler. The application includes features like widgets, themes, keyboard shortcuts, and natural language parsing.

Its main features include:

  • Widgets, with customizable dark/light themes
  • Keyboard shortcuts
  • Siri shortcuts
  • Apple Watch complications
  • Custom app icons
  • Natural language parsing
  • Lunar day view
  • Dark and light modes built-in
  • Accessibility support
  • Localizations support

SwiftUI

πŸ“– I believe the best way to Learn is by doing. SwiftUI is evolving and I think it's the future of writing apps.

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.

-- Apple

The true power of SwiftUI, to me, is it's flexibility, thanks to it's vast realm of view modifiers and expressiveness with property wrappers.

You can create an "Hello, World!" app with just a few lines of code (check out the new @main attribute!) or even, a calendar view.

SwiftUI give you the most flexible tool an Apple developer could ever ask for, all you need is a bit of creativity, and the possibilities, are, limitless.

Clendar would not be possible without the public knowledge of the community. To name a few, in no particular order:

my notes about SwiftUI:

By publishing Clendar, I would like to give back to the community. 😊

Tip to build on M1 Macs

So, maybe someone, who wants to contribute in this repo will find the next info a very helpful. If you have Macbook on m1:

sudo arch -x86_64 gem install ffi
arch -x86_64 pod install

Or:

run terminal with Rosetta and run pod install

Thanks #220 (comment)

Tech stacks

The following technologies were used to develop our application:

Core:

Build delivery tool:

Package Managers:

Linter:

Formatter:

Action:

Requirements

(for async/await):

  • Xcode 13.1
  • iOS 15.0
  • watchOS 8.0
  • Ruby (for Fastlane build automation)

My own Swift Packages currently used in Clendar

  • Shift - Result-based wrapper for EventKit. SwiftUI supported!
  • Laden - SwiftUI loading indicator view

Contributing

Contributing 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. Thanks!

How To Contribute:

  • Report issues you're facing
  • Give a πŸ‘ on issues that are relevant to you
  • Answer queries on the issue tracker

If you don't know where to start:

  • Navigate to the issues page
  • Filter by label
  • Look for issues related to good first issue
  • Feel free to look at all the issues opened and pick one that interests you!
  1. Fork the project repository by clicking Fork in the top right hand corner 🍴
  2. Clone the repository onto your local machine using the Git url πŸ’»
  3. Switch to the branch you want to work on and start contributing! πŸ“

When submitting an issue, please make sure your description is clear and has enough information for someone to be able to reproduce the issue!

Important Files To Look At

Contributors

Huge thanks everyone who took their precious time and effort to contribute to the project:

Words simply can not describe how thankful am I, I'm deeply appreciated all for your kind contribution.

I feel very lucky that my small side project help people find inspiration πŸ’™

Thank you again, you rocks!

πŸ‡ΊπŸ‡³ πŸš€

License

MIT License

You can do whatever you want with this source code: modify, tweak or use as learning resources, for example... πŸ› πŸ‘¨πŸ»β€πŸ’»

But, please don't re-distribute the app on App Store with different name. πŸ₯Ί

And, if you like, you can download the app for free on the App Store.

Open-source inspiration


Star History

Star History Chart


Thanks and take care! πŸ€

I'm on @vinhnx on almost everywhere.

clendar's People

Contributors

andreybozhko avatar carboitel avatar dependabot[bot] avatar levyathanus avatar prabal4546 avatar samis0707 avatar shadowfax90 avatar vinhnx avatar wywwwwei avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

clendar's Issues

Fix `firstWeekDay`

remove

cv_defaultFirstWeekday

change:

func firstWeekday() -> Weekday { cv_defaultFirstWeekday }

to:

func firstWeekday() -> Weekday { CVCalendarWeekday(rawValue: Calendar.autoupdatingCurrent.firstWeekday) ?? .monday }

README localization workflow

  1. Find all string in Xcode project, using regex:

https://stackoverflow.com/a/48927333
In Xcode > Search > Find > Regular Expression -- type "[a-zA-Z0-9]+"

  1. Add NSLocalizedString("text", comment: "") to string that want to translate
  2. run
find . -type f \( -name \*.m -o -name \*.swift \) -print0 | xargs -0 genstrings -o /Users/v.vinhnx7/Downloads/Clendar-master/Clendar/Resources/en.lproj
  1. use https://github.com/Flinesoft/BartyCrouch
  2. (install if need: brew install bartycrouch)
  3. At root of project folder, run: to update en.lproj to vi.lproj
bartycrouch update
  1. Use https://github.com/marmelroy/Localize-Swift to change language on-the-fly, without having to set language in Settings πŸ‘

for storyboard, use

ibtool MainStoryboard.storyboard --generate-strings-file file_name.strings

or just add text to .strings everytime has new string

check lai quick event date picker

  • can not scroll when changing enddate time. keyboard not avoid
  • add event handling when start date change -> should change end date too.

genstring script

  1. at each string text, call NSLocalizedString("foo", comment: "")
  2. run:
find . \( -name "*.swift" ! -path "./Carthage/*" ! -path "./Pods/*" \) -print0 | xargs -0 genstrings -o en.lproj

App Store Submission preparation

Apple's Common App Rejections Styleguide - Highlighted some of the most common issues that cause apps to get rejected.
Free App Store Optimization Tool - Lets you track your App Store visibility in terms of keywords and competitors.
App Release Checklist - A checklist to pore over before you ship that amazing app that has taken ages to complete, but you don't want to rush out in case you commit a schoolboy error that will end up making you look dumber than you are.
Harpy - Notify users when a new version of your iOS app is available, and prompt them with the App Store link.
appirater - A utility that reminds your iPhone app's users to review the app.
Siren - Notify users when a new version of your app is available and prompt them to upgrade.
Appstore Review Guidelines - A curated list of points which a developer has to keep in mind before submitting his/her application on appstore for review.
AppVersion - Keep users on the up-to date version of your App.

https://github.com/vsouza/awesome-ios#app-store

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    πŸ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. πŸ“ŠπŸ“ˆπŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❀️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.