Sharing, Public Viewer & Drops

Share any project with a public link, let anyone view it (and the layers behind edited images), and clone it into their own account.

Share a project

To create a share link:

  1. In the editor's top bar, open the project menu and click Share Project (Share icon).
  2. The Share project dialog opens and auto-generates a link the first time. The URL appears in the read-only field at the bottom — click the copy button (Copy icon) next to it.
  3. Under What to share, toggle Canvas and/or 3D scene. At least one must stay selected (an amber "Select at least one surface" note appears otherwise). Surfaces with no content show an "empty" tag and are greyed out. New shares default to Canvas-only; 3D is opt-in.
  4. Anyone with the link can view the included surfaces and clone the whole project — no sign-in needed to view.

Notes:

  • Canvas viewer options (shown when Canvas is shared): Show lineage edges (the connecting lines between nodes, on by default) and Show model & prompt (per-image badges, off by default).
  • Changes save instantly — you don't need to regenerate the link when you flip a toggle.
  • To revoke: click Stop sharing (bottom-left of the dialog). The link stops working immediately.

What the recipient sees (public /viewer)

Opening a share link (/viewer/<id>) loads a read-only view of the project — public, no account required:

  • If both Canvas and 3D were shared, a pill at the top center toggles between Canvas and 3D.
  • The canvas renders the placed images, videos, and 3D models exactly as positioned, with lineage edges / badges per the owner's viewer options.
  • Empty, expired, deleted, or invalid links show a clear status card instead of an error.
  • If the owner set a password, a "Password Protected" screen asks for it first.

Inspect image layers in the viewer

Edited images on a shared canvas carry their full edit-layer stack. To inspect them:

  1. On a composited image, click the small layers badge (Layers icon + layer count) in its bottom-right corner — or double-click / double-tap the image.
  2. The view-only Layers inspector opens: the composited image on the left, a layers panel on the right.
  3. Toggle individual layers or folders with the eye icon to see how the image was built. Nothing is saved — visibility resets when you click Back to canvas (or press Esc).

Clone a shared project

Any signed-in user can clone a shared project for free into their own account:

  1. In the viewer, click Clone to my projects (bottom-center). The hint reads "View-only — clone to edit."
  2. If you're not signed in, the button reads Sign in to clone and sends you to sign-in, returning you to the viewer afterward.
  3. On success you're taken straight into the editor with your own copy (named with a "(copy)" suffix). On mobile, a dialog confirms the clone landed in your account — open Framo on desktop to edit it.
  4. Returning later, the button reads Open your copy so you don't create duplicates.

Cloning deep-copies every image, video, and 3D model into your account. Future generations on the clone use your own credits. (Cloning your own share link is hidden — there's nothing to copy.)

Drops feed (browse & clone)

Drops (framo.app/drops) is a public gallery of featured projects, newest first. To use it:

  1. Open /drops and scroll the grid (it loads more as you scroll). Recent additions carry a New badge.
  2. Click any card to open it in the public viewer.
  3. From there, clone it like any shared project (see above).

Feature a project on Drops (admin only)

Adding a project to the Drops feed is admin-only — the control is hidden for everyone else and the server rejects non-admin attempts.

If you're an admin, in the Share project dialog:

  1. Under Drops, check Feature on framo.app/drops. This lists the project publicly, ordered by the share-link's creation date.
  2. Optionally upload a custom Cover image (e.g. the exact image you posted on Instagram; 3:4 works best). Remove reverts to the auto cover derived from the project.
  3. Uncheck to remove it from the feed.

Admins can only feature their own projects. Password-protected and expired shares never appear on Drops.

Cross-deployment import (dev/admin tool)

Copying a full project library between deployments (e.g. dev → prod) is a command-line admin tool (projectFullCloneAction), not part of the in-app UI. It is not used in normal sharing or cloning.