# Windows

A window is the first thing anyone sees of your app, and Glaze apps are not limited to one plain shape. They can be a standard resizable window, a sleek frameless panel, a small always-on-top utility, a modal that focuses attention, or even a transparent overlay. You describe the feel you want and the agent sets the window up to match.

## Standard Windows

By default your app gets a normal macOS window: a title bar with the red, yellow, and green traffic-light buttons, resizable edges, and a sensible starting size. The agent chooses an initial width and height that suit the content and sets a minimum size so the layout never collapses awkwardly. For most apps this is exactly right, and you do not have to think about it.

## Frameless and Custom-Chrome Windows

For a more designed look, an app can drop the native title bar and use a **frameless** window where your own header runs edge to edge. The header can still be **draggable**, so the window moves when you drag the top of it, just without the standard bar. This is how apps get a clean, custom top area while still feeling like a proper window.

## Title Bar and Traffic Lights

You have fine control over the title bar and the traffic-light buttons:

- **Inset title bar**: Keep the buttons but blend the bar into your content for a modern look.
- **Hidden title bar**: Remove the bar entirely for a frameless design.
- **Repositioned or hidden buttons**: Move or hide the close, minimize, and zoom controls when your layout calls for it.

These let an app match a specific aesthetic while keeping the controls people expect.

## Floating and Utility Windows

An app can use a small **floating** or **utility** window that stays **always on top**, hovering above other apps so it is there when you need a glance, such as a timer, a mini player, a note. These are ideal for companions you want visible while you work in something else.

## Modal and Document Windows

Apps can present a **modal** window, a child window that takes focus and sits in front of its parent until you deal with it, perfect for a confirmation or a focused task. They can also use **document-style** windows, where each open document gets its own window, the familiar pattern from editors and other document apps.

## Transparent and Click-Through Overlays

For special effects, an app can use a **transparent** window with no visible background, showing only its content over whatever is behind it. Combined with **click-through**, where mouse clicks pass through the window to the app underneath, this enables overlays like an on-screen annotation layer or a heads-up display that floats above your desktop without getting in the way.

## Multiple Windows

An app is not limited to a single window. It can open several at once, for example a main window plus a floating inspector, or a new window per document, so the layout fits how you actually work.

> [!TIP]
> You do not need the names of these window types to use them. Describe the window behavior you want and the agent picks the right setup for your app.