> 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/installation.md).

# Installation

## Requirements

* **iPhone** running iOS 17 or later.
* **iPad** is also supported (widgets adapt to iPad screen sizes).
* An active internet connection is only needed for the initial download and for Google Calendar sync. The app and widgets work offline after setup.

## Install from the App Store

1. Open the **App Store** on your iPhone or iPad.
2. Search for **Monthly Calendar Widgets**.
3. Tap **Get** (or the download icon) to install.
4. Open the app once installation is complete.

## First-run onboarding

When you open the app for the first time, you'll be guided through a short onboarding flow:

1. **Welcome screen** -- Overview of what the app offers.
2. **Calendar permission** -- The app will ask for access to your calendars. This is required for displaying events in widgets and in-app views.
3. **Choose your calendars** -- Select which calendars you want to display.
4. **Widget preview** -- See examples of the widget styles available.

## Permissions explained

### Calendar access (required)

Calendar permission is the core permission the app needs. Without it, widgets will appear blank and the app cannot display any events.

The app requests **Full Access** so it can:

* Read event titles, times, calendar names, and colors to display in widgets.
* Create and edit events directly from the app (optional feature).
* Write event snapshots to the widget extension via App Group storage.\*\*If you denied access by mistake:\*\*1. Open **Settings** on your iPhone.

2. Go to **Privacy & Security** > **Calendars**.
3. Find **Monthly Calendar Widgets** and set it to **Full Access**.### Google sign-in (optional)If you want to connect Google Calendar, the app will open a Google OAuth flow in a browser window. This is entirely optional. The app never sees or stores your Google password.## Updating the appThe app updates automatically if you have automatic updates enabled in the App Store. You can also manually update by going to the App Store > your profile > Updates.After an update, your widgets, custom designs, and settings are preserved. No reconfiguration needed.


---

# 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/installation.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.