Projects and Storage

Miao projects are stored by project ID. There are no user accounts in the current app.

Create a Project

1. Open Project, or click Create editable copy from the unsaved demo.
2. Fill New title.
3. Fill Password.
4. Click Create.

The password must be at least 8 characters. The server creates a unique 10-character project ID and returns a route like /p/k541vGO6Dq.

The Project menu is grouped into Create, Open, Current project, and Files sections when those actions apply. Manual opens the user manual from the same menu.

The Project menu is the main place for project creation, unlock, save, export, history, sharing, file cleanup, and help.

Unlock a Project

1. Open Project.
2. Fill Project ID.
3. Fill Password.
4. Click Unlock.

Unlocking returns a temporary token valid for 12 hours. The token is stored in the browser session so the app can save, export, download audio files, and collaborate while the session remains valid.

WARNING

There is no account recovery and no password change flow in the current app. Keep the project ID and password.

Save

Use Save, Cmd+S, or the command palette. Saving writes the current project document to server storage.

Each save writes:

• A latest snapshot at projects/{projectId}/snapshots/latest.json.
• A history snapshot under projects/{projectId}/snapshots/history/.
• Updated project metadata.

Snapshots include the project chord lane, key/scale, MIDI clips, regions, ideas, markers, comments, tracks, routing, instruments, effects, and automation settings.

History

Open Project and click History. Miao lists saved snapshots by timestamp.

Click Copy beside a history entry to create a new project copied from that snapshot. The copied project keeps the original password and creates a new project ID. Referenced remote audio files are copied to the new project storage path.

Project Link

Open Project and click Link to copy the current project link. A collaborator still needs the project password to unlock it.

Project Audio Files

Imported and recorded audio is saved to the project when the project is unlocked. The Worker stores project audio under:

projects/{projectId}/assets/{assetId}/{filename}

The app stores a reference to the uploaded file in the project document and restores it after the project is unlocked. Miao handles any browser-side working copies automatically.

Clean Unused Files

Open Project and click Clean unused files. Miao saves first, then deletes project audio files that are no longer referenced by any region or take.

This is important for privacy because unused audio files are removed from R2 rather than being left behind after editing.

What Is Not Stored

Some runtime-only state is not intended as persistent project content:

• Input monitoring is disabled from saved project documents.
• Temporary remote edit locks are not long-term project data.
• Browser audio playback state is rebuilt from the saved project document.

Storage Summary

Data	Storage
Project metadata	Cloudflare R2 JSON
Latest project snapshot	Cloudflare R2 JSON
Snapshot history	Cloudflare R2 JSON files
Imported and recorded audio	Cloudflare R2 objects
Export ZIP files	Cloudflare R2 objects
Realtime collaboration	Cloudflare Durable Object room
Unlock token	Browser session storage