> For the complete documentation index, see [llms.txt](https://monthly-calender-widgets.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://monthly-calender-widgets.gitbook.io/docs/getting-started/readme.md).

# Overview

Monthly Calendar Widgets is a widget-first iOS app that puts your month, week, events, and utilities directly on your **Home Screen** and **Lock Screen** -- so you can glance instead of opening an app.

Whether you're planning your week, tracking a countdown, or timing a workout, everything stays one look away.

## What you get

### Home Screen calendar widgets (55 widgets)

* **Large (4x4)** -- Full month grid with event bars across 10 theme families + iOS 26 Liquid Glass.
* **Medium (4x2)** -- Week view and Event + Calendar layouts with theme variants.
* **Small (2x2)** -- Compact calendar for minimal home screens.
* **Progress widgets** -- Light and dark day/year progress dot displays.
* **Custom widgets** -- Design your own Month (Large) or Week (Medium) widget with the Custom Widget Builder.

### Lock Screen utility widgets (26 widgets)

* **Day progress** (4 types) -- Day Remaining, Day Gauge, Day Dots, Day Squares.
* **Year progress** (2 types) -- Year Dots, Year Squares.
* **Countdown timers** (10 types) -- Circular, bar, detailed, inline, dots, dashes, ring, grid, and more.
* **Dual timers** (3 types) -- Equal, Hero, and Dual Rings layouts.
* **Stopwatch** (1 type) -- Detailed rectangular display.
* **Dual stopwatches** (2 types) -- Equal and Hero layouts.

### 10 theme families

Clean White, Dark/OLED, Monochrome, Minimalist, Paper/Notebook, Sakura, Ukiyo-e, Manga, Custom (user-designed), and iOS 26 Liquid Glass.

### Two calendar sources

* **Calendar (iOS)** -- Automatic updates via EventKit. Works with iCloud and calendars configured in iOS Calendar (including Outlook, Exchange, Yahoo, Google added in iOS, CalDAV, and subscribed calendars).
* **Google Calendar (optional)** -- read-only OAuth sync with the Google Calendar API. This is the only direct, separate calendar API integration in the app. It fetches events with exact Google colors and stores them locally for offline viewing after each sync. Free accounts get 2 syncs per week; Pro is unlimited. Each sync covers 2 years past + 1 year future.

### Custom Widget Builder

Design your own Month or Week widget with 28 configurable properties: background (solid, gradient, or image), text colors, grid lines, cell styling, header buttons, 6 independent opacity sliders, event color mode, monochrome mode, and corner radius. 20 gradient presets included.

### Pro

Unlocks all 80+ widgets, the Custom Widget Builder, all Lock Screen utilities, and advanced customization. Available as a weekly subscription ($1.99/week with a 3-day free trial) or a one-time lifetime purchase ($19.99).

## Quick start

1. **Install** -- Download Monthly Calendar Widgets from the App Store.
2. **Grant Calendar access** -- The app needs Full Access to read your events and power widgets.
3. **Add a widget** -- Long press your Home Screen, tap **+**, search for **Monthly Calendar Widgets**, choose a size, and tap **Add Widget**.
4. **Connect Google Calendar (optional)** -- Settings > **Google Calendar** > **Connect** > **Sync Now** for exact Google colors and offline access.

## Quick actions (Home Screen long press)Long press the app icon on your Home Screen for quick actions:- **Add Event** -- Jump straight to creating a new event.

* **Today** -- View today's events.
* **Widgets** -- Go to the Widgets tab.## Need help?- [Troubleshooting](/docs/privacy-and-support/troubleshooting.md) -- Common issues and fixes.
* [Support](/docs/privacy-and-support/support.md) -- How to contact us.