https://github.com/simonberner/monthly-theme-widget

An iOS17+ Monthly Theme Widget 📅
https://github.com/simonberner/monthly-theme-widget

intents widget

Last synced: about 2 months ago
JSON representation

An iOS17+ Monthly Theme Widget 📅

• Host: GitHub
• URL: https://github.com/simonberner/monthly-theme-widget
• Owner: simonberner
• License: mit
• Created: 2022-11-23T16:26:40.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2023-12-16T15:05:31.000Z (about 1 year ago)
• Last Synced: 2023-12-16T16:26:23.910Z (about 1 year ago)
• Topics: intents, widget
• Language: Swift
• Homepage:
• Size: 3.8 MB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Monthly Theme Widget




    

        

    

    

        

    

    

        

    

    

        

    

    

        

    

    

        

    

    

        

    

    

        

    



A small project to learn the fundamentals of how to create a simple Widget with an intent and configuration for iOS 17+.

---

## Contents

* [Functionality](#functionality)

* [Tech Stack](#tech-stack)

* [Frameworks](#frameworks)

* [Device Compatibility](#device-compatibility)

* [Screenshots](#screenshots)

* [Learnings](#learnings)

* [Code Comments](#code-comments)

* [Pull Requests](#pull-requests)

* [Credits](#credits)

---

## Functionality

A simple Date Widget that changes the day at midnight and its theme every month. With iOS17+ it is also available in the [StandBy mode](https://support.apple.com/en-gb/guide/iphone/iph878d77632/ios).

## Tech Stack

- Xcode 15.0

- Swift 5.9

## Frameworks

- SwiftUI

- WidgetKit

## Device Compatibility

- iPhone with iOS 17+

- iPad with iOS 17+

## Screenshots

| Widget Normal Font | Intent |

| :---: | :---: |

|  |  |

| Configuration | Widget Fun Font |

| :---: | :---: |

|  |  |

| StandBy Mode (iOS17) |

| :---: |

|  |

| Different Days Overview |

| :---: |

|  |

## Learnings

- A Widget comes in 4 "fixed" sizes: systemSmall, systemMedium, systemLarge, systemExtraLarge

- The shape of a Widget is given

- The content of a widget can only be implemented with SwiftUI (no UIKit)

- The IntentTimelineProvider creates the timeline of the widget when to update its content:

    - placehoder: dummy data (in case there is no data from the snapshot eg. network call needed)

    - getSnapshot: how does the widget look right now (this state is shown in the widget gallery)

    - getTimeline: this is where the timeline actually gets created. It consists of an Array of entries (the data)

### Fonts

- [Best Free Fonts for iOS app](https://sarunw.com/posts/free-fonts-ios/)

- [List all fonts available on iOS device in console](https://gist.github.com/simonbromberg/24a48fb5e94b2bde82df1e5c97e733da)

- [Old list of iOS fonts](http://iosfonts.com/)

### Widget Intent & Configuration

- 1. Create a intent definition file add some intents with parameters

- 2. Add the IntentConfiguration to the Widget, which then takes in a IntentTimelineProvider

## Code Comments

I love putting in the effort of adding comments to my code, [here is why](https://www.youtube.com/watch?v=1NEa-OcsTow).

## Pull Requests

When I create PRs I stick to [this guideline](https://www.youtube.com/watch?v=_sfzAOfY8uc).

## FAQ

### Whats new for this App with iOS17?

- App Intents for Widget-Configuration and interactive Widgets

### Why is this App iOS17+ only?

- Because I want to be able the new way of implementing App Intents in code rather than using the SiriKit definition file (prior to iOS17).

- Because I don't want to fidle around with ``if #available(iOS 17, *) {...}``

## Credits

🙏🏽 Sean Allen iOS Courses





Made with a 🙂 Simon Berner