> 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/widgets/widget-catalog/home-screen.md).

# Home Screen widgets

Home Screen widgets are the core feature of Monthly Calendar Widgets. The app includes **55 Home Screen widgets** across 10 theme families and multiple sizes.

## Widget sizes

### Large (4x4) -- Month view (11 widgets)

The Large widget shows your **entire month** in a grid layout. Available in 10 theme families + iOS 26 Liquid Glass.

**What you'll see:**

* A full month grid with day numbers.
* Event bars inside day cells, color-coded by calendar or accent color.
* Current day highlighted with a circle or background tint.
* Month name and year in the header.
* Optional navigation buttons (forward/back), sync button, and add-event button (varies by theme and configuration).

**Best for:** People who plan around a monthly view and want to see schedule density at a glance.

### Medium (4x2) -- Week view (9 widgets)

Week view widgets focus on the **current 7 days** with event indicators. Available in 8 standard themes + Custom.

* Day names and dates displayed horizontally.
* Event indicators for each day.
* Current day highlighted.

**Best for:** People who plan around the coming week.

### Medium (4x2) -- Event + Calendar (8 widgets)

Event + Calendar widgets combine a **mini month calendar** with a **today's events list** in a split layout. Available in 8 standard themes.

* Left side: compact month grid.
* Right side: today's upcoming events with times and colors.

**Best for:** People who want today's schedule alongside a month overview.

### Small (2x2) -- Compact calendar (8 widgets)

Small widgets provide a minimal calendar presence. Available in 8 standard themes.

* Compact month or date display.
* Subtle, space-efficient design.

**Best for:** Minimal home screens and tight layouts.

### Progress widgets (2 widgets)

Progress dot widgets show day and year progress in a dot-based layout. Available in Light and Dark variants.

**Best for:** Tracking daily and yearly progress at a glance.

## Theme families

Each widget size is available across multiple visual themes:

| Theme                     | Vibe                       | Available sizes                   |
| ------------------------- | -------------------------- | --------------------------------- |
| **Clean White**           | Bright, clear, minimal     | Large, Medium (Week + E+C), Small |
| **Dark / OLED**           | True black, battery-saving | Large, Medium (Week + E+C), Small |
| **Monochrome**            | Grayscale, sophisticated   | Large, Medium (Week + E+C), Small |
| **Minimalist**            | Maximum whitespace         | Large, Medium (Week + E+C), Small |
| **Paper / Notebook**      | Warm, textured, analog     | Large, Medium (Week + E+C), Small |
| **Sakura**                | Soft pink, cherry blossom  | Large, Medium (Week + E+C), Small |
| **Ukiyo-e**               | Japanese sunset gradients  | Large, Medium (Week + E+C), Small |
| **Manga / Comic Book**    | Bold, high-contrast        | Large, Medium (Week + E+C), Small |
| **Custom**                | User-designed (builder)    | Large, Medium (Week only)         |
| **Liquid Glass (iOS 26)** | Translucent, tinted        | Large only                        |

## How to choose the right widget

| If you...                        | Choose                              |
| -------------------------------- | ----------------------------------- |
| Plan around the full month       | **Large Month**                     |
| Focus on the current week        | **Medium Week**                     |
| Want today's events + a calendar | **Medium Event + Calendar**         |
| Want a minimal date presence     | **Small**                           |
| Want day/year progress tracking  | **Progress**                        |
| Want full design control         | **Custom Widget** (Large or Medium) |

## Interacting with widgets

Widgets are interactive and configurable:

* **Tap a widget** to open the app. The tap action is configurable in Settings > Optional Settings > Widget Tap Action:
  * **Open App** (default) -- Opens the Monthly Calendar Widgets app.
  * **Open Google Calendar** -- Opens the Google Calendar app (if installed).
  * **Open iOS Calendar** -- Opens Apple's Calendar app.- **+ button** (if visible) -- The action is configurable in Settings > Optional Settings > Widget + Button Action:
  * **Create in App** (default) -- Opens the event creation screen in the app.
  * **Create in Google Calendar** -- Opens Google Calendar to create an event.
  * **Create in iOS Calendar** -- Opens Apple Calendar to create an event.- **Sync button** (if enabled) -- Triggers a calendar data refresh. Toggle visibility in Settings > Optional Settings > Show Sync Button.- **Navigation buttons** (on custom widgets) -- Navigate forward/back between months or weeks directly from the widget.## Multiple widgetsYou can add as many Home Screen widgets as you like. Each operates independently with its own theme and size. Mix and match:- A Large Month widget on your main Home Screen.
* A Medium Event + Calendar widget on a secondary page.
* A Small widget inside a Smart Stack.Widgets work in Smart Stacks and display beautifully in StandBy mode.


---

# 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/widgets/widget-catalog/home-screen.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.
