> 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

Documentation hub for Monthly Calendar Widgets.

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

### Seven main Home Screen calendar choices

* **Monthly**, **Weekly**, and **Small**: add the size you need, then choose an existing theme or layout in **Edit Widget → Design**.
* **Custom Monthly 1 / 2** and **Custom Weekly 1 / 2**: independently choose saved calendars, photo calendars, or photo-only designs.
* Existing widgets and designs keep working; older theme entries remain available in Apple’s Other section.

### 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

Create Calendar or Photo only designs. Position and zoom photos, use Fill or Fit with black bars, and match colors to the photo on-device. Detailed calendar controls remain under Advanced calendar settings. Start with a short gradient selection or see all 20 presets.

### Pro

Unlocks full calendar widget access, use of saved custom widgets on the Home Screen, and Lock Screen utilities. 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 main calendar entry, and tap **Add Widget**. Touch and hold it → **Edit Widget → Design** to choose its design.
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.