# The Mac app

> Flozu in its own window, with a native menu bar and every map saved as a file you can see in Finder.

The Mac app is Flozu in a native window, with no server and no sign-in. It runs the same app as the browser, in the Mac’s own web view (the one Safari uses), so it’s small and works the same. What it adds:

- **Maps are files.** Each map is a `.flozu.json` file in **Documents › Flozu**, and projects and folders are real folders there. See [files and folders](https://docs.flozu.app/mac/files-and-folders.md).
- **A menu bar,** with the shortcuts below.
- **A window that reopens where you left it,** at the size you left it.

## Get the Mac app

The Mac app is built from the same code as the web app. To build and run it yourself, you need what Flozu needs, plus Rust and Xcode’s command line tools:

```sh
xcode-select --install
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
pnpm install
pnpm desktop      # opens the app
```

The first run compiles the app, which takes a few minutes. Later runs take seconds. [docs/mac-app.md](https://github.com/flozu-app/flozu/blob/main/docs/mac-app.md) in the repo covers packaging, signing and releasing.

> **Note**
>
> The first time, macOS asks whether Flozu may use your Documents folder. Flozu needs it to keep your maps there. A build that isn’t signed yet opens with a warning: right-click the app, choose **Open**, then **Open** again.

## The menu bar

| Menu   | Item                   | Keys    |
| ------ | ---------------------- | ------- |
| File   | New map                | `⌘N`    |
| File   | All maps               | `⇧⌘M`   |
| File   | Import…                | `⌘O`    |
| File   | Export…                | `⌘E`    |
| File   | Export all maps…       | `⌥⌘E`   |
| File   | Close map              | `⌘W`    |
| File   | Show maps in Finder    | `⇧⌘F`   |
| File   | Close window           | `⇧⌘W`   |
| Edit   | Undo                   | `⌘Z`    |
| Edit   | Redo                   | `⇧⌘Z`   |
| View   | Show or hide sidebar   | `⌃⌘S`   |
| View   | Show or hide library   | `⌥⌘1`   |
| View   | Show or hide inspector | `⌥⌘2`   |
| View   | Fit to screen          | `⇧⌘1`   |
| View   | Play or pause          | `⌥⌘P`   |
| View   | Switch theme           | `⌥⌘T`   |
| Window | Show next open map     | `⌃Tab`  |
| Window | Show previous open map | `⌃⇧Tab` |

Undo and redo act on the text when you’re typing in a field, and on the map otherwise. Cut, copy, paste, select all, full screen, minimise, hide and quit are the Mac’s own.