Skip to content

Commit

Permalink
Updated README.md file to include supporting links and more detail to…
Browse files Browse the repository at this point in the history
… sections (#260)

* Updated README.md and added more detail to sections

* Fixed urls on README.md

* Added files section to README.md
  • Loading branch information
carboitel authored Oct 3, 2023
1 parent bafe47d commit c3184d5
Showing 1 changed file with 85 additions and 24 deletions.
109 changes: 85 additions & 24 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,12 +15,46 @@ Clendar - Minimal Calendar

> [Landing Page](http://vinhnx.github.io/clendar-site)
### Table of Contents

- 📋 [About](#about)
- 🚀 [What's Clendar](##whats-clendar)
- 📦 [SwiftUI](#swiftui)
- 💻 [Tip to build on M1 Macs](#tip-to-build-on-m1-macs)
- 📚 [Tech stacks](#tech-stacks)
- 📖 [Requirements](#requirements)
- 💖 [My own Swift Packages currently used in Clendar](#my-own-swift-packages-currently-used-in-clendar)
- 📝 [Contributing](#contributing)
- 📂 [Important Files To Look At](#important-files-to-look-at)
- 🙌 [Contributors](#contributors)
- ⚖️ [License](#license)
- 🏆 [Open-source inspiration](#open-source-inspiration)

### 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 => https://github.com/vinhnx/Clendar/pull/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](https://developer.apple.com/xcode/swiftui/) is evolving and I think it's the future of writing apps.
Expand Down Expand Up @@ -68,36 +102,38 @@ By publishing Clendar, I would like to give back to the community. 😊
### Tech stacks
The following technologies were used to develop our application:
Core:
- SwiftUI (and UIKit interoperability)
- [SwiftUI](https://developer.apple.com/xcode/swiftui/) (and UIKit interoperability)
- iPadOS
- WidgetKit
- SiriKit
- [WidgetKit](https://developer.apple.com/documentation/widgetkit)
- [SiriKit] (https://developer.apple.com/documentation/sirikit/)
- EventKit/EvenKit UI - wrapper with my own [Shift package](https://github.com/vinhnx/Shift) 📆
- WatchKit
- [WatchKit] (https://developer.apple.com/documentation/watchkit/)
- Combine
- Catalyst
- StoreKit
- [StoreKit](https://developer.apple.com/documentation/storekit)
Build delivery tool
Build delivery tool:
- Fastlane
- [Fastlane](https://fastlane.tools/)
Package Managers
Package Managers:
- Swift Package Manager
- CocoaPods
- [Swift Package Manager](https://www.swift.org/package-manager/)
- [CocoaPods](https://cocoapods.org/)
Linter
Linter:
- SwiftLint
- [SwiftLint](https://swiftpackageindex.com/realm/SwiftLint)
Formatter
Formatter:
- SwiftFormat
- [SwiftFormat](https://formulae.brew.sh/cask/swiftformat-for-xcode)
Action
Action:
- [SwiftLint is integrated on GitHub Action workflow](https://github.com/vinhnx/Clendar/actions?query=workflow%3ASwiftLint) 🚀
Expand All @@ -117,11 +153,42 @@ Action
### Contributing
Contributing is more than welcome, if you feel like helping the app, or want to add new feature, feel free to take a look at my [issues page](https://github.com/vinhnx/Clendar/issues). Thanks!
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](https://github.com/vinhnx/Clendar/issues). 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](https://github.com/vinhnx/Clendar/issues)
- Filter by label
- 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)
- 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
- [Clendar](https://github.com/vinhnx/Clendar/tree/main/Clendar0)
- Clendar application program
- [ClendarTests](https://github.com/vinhnx/Clendar/tree/main/ClendarTests)
- Contents to test the Clendar program on IOS software
- [ClendarUITests](https://github.com/vinhnx/Clendar/tree/main/ClendarUITests)
- Contents to test the Clendar UI on IOS software
- [ClendarWatchApp Extension](https://github.com/vinhnx/Clendar/tree/main/ClendarWatchApp%20Extension)
- Contents used to create Clendar compatibility to watchOS using SwiftUI
- [Packages](https://github.com/vinhnx/Clendar/tree/main/Packages)
- Contains Clendar theme and SwiftUI calendar view
### Contributors
🙏🏻🤯🎉
Huge thanks everyone who took their precious time and effort to contribute to the project:
- [Aleksandr Sutulov](https://github.com/AlexanderSutul)
Expand All @@ -142,13 +209,7 @@ And, if you like, you can download the app for free on the [App Store](https://a
### Open-source inspiration
- https://github.com/jeffreybergier/WaterMe
### What's 'Clendar'?
It's just Calendar, without an 'a'. I thought it's unique, but turns out it's not going well with ASO (App Store Optimization) and SEO (Search Engine Optimization).
But, whatever!
- https://github.com/jeffreybergier
---
Expand Down

0 comments on commit c3184d5

Please sign in to comment.