Files & projects

Flywrite keeps organization simple: a project is a folder, and its files are plain files you can see in Finder.

The file tree

The file tree shows everything in your project. From here you can:

Create files and folders with the + File and + Folder buttons. Name a file without an extension and it becomes a markdown file — "notes" creates notes.md.
Choose where new things land by clicking a folder. The folder is marked with an accent edge and becomes the destination for everything that creates a file — the + File and + Folder buttons, ⌘N, the + button above your tabs, and File → New File. Click a file to clear the selection and go back to the top of the project.
Expand or collapse every folder at once with the icon buttons at the top of the file list, or with ⌃⇧↓ and ⌃⇧↑.
Drag and drop to move things around — including straight from Finder: drop files or folders onto any folder in the tree to move them into your project, or hold Option while dropping to copy them instead.
Right-click any file for more: Rename, Delete, Reveal in Finder, Copy file (a real file you can paste into Finder or Mail), Copy file contents, and Copy path (the file's full path, ready to paste into a terminal).
Right-click a folder to create a file or folder inside it, rename or delete it, or Open in Finder.

The file you're editing has its own quick actions in the bottom bar, next to the file name: the current line number, a copy button that copies the whole file's contents (⌘⌥C), and a reveal-in-Finder button (⌘⌥R).

Files that match your project's .gitignore appear dimmed in the tree, so the files you're actually tracking stand out. Gitignored folders (build output, dependencies, and the like) list their contents when you expand them rather than up front, which keeps even very large projects fast — and once you've expanded one, anything written inside it shows up there too.

Symlinks — files and folders that are really pointers to somewhere else on your Mac — are marked with a small link icon and read quieter than your own files, so you can tell at a glance what actually lives in the project. Hover over one to see exactly where it points. Linked folders open like any other folder, a level at a time.

The tree keeps itself current. Files an agent creates while you're watching appear on their own, and switching back to the Flywrite window picks up anything that was created in the meantime — from a terminal outside the app, or another app entirely.

Multiple projects

The projects rail on the far left holds all your projects — click one to switch. Add another anytime with the + button (see Your first project for the three ways to add one).

You can switch projects from the keyboard too: ⌥⌘↑ and ⌥⌘↓ cycle through the rail, or open the command palette (⌘⇧P) and type Go to Project to jump to any project by name.

Right-click a project and choose Project Settings to give it a display name, a color (background and text, including your own hex values), and an icon — an emoji, initials, or a small icon from the list (or type any name from lucide.dev/icons) — so it's easy to spot at a glance. Drag projects up or down the rail to put them in whatever order you like.

One special entry: open your app settings as files (Settings → Edit settings file (JSON)) and a Settings project appears pinned to the top of the rail. It works like any project, and closes with the × on its entry when you're done. More in Appearance & themes.

Hiding and removing projects

Hide Project tucks a project away behind the eye icon at the bottom of the rail. Nothing is deleted, and you can bring it back anytime.
Delete Project (in the same right-click menu, or via the Remove button in Project Settings) takes it out of Flywrite after a confirmation — but the folder and all its files stay on your computer.

If a project's folder goes missing

Delete, move, or rename a project's folder outside Flywrite and the app flags the project with a warning in the rail. Click Fix to sort it out: locate the folder if it moved, re-clone it if the project is connected to GitHub, or remove the project from the list.