> 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)** -- 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. Limited to 2 syncs per week; 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://monthly-calender-widgets.gitbook.io/docs/getting-started/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.