Skip to main content
Klipeo
Klipeo Docs
Getting Started

Projects & Compositions

How Klipeo organizes your work, and the difference between a project and a composition.

Klipeo keeps two levels of organization, and it helps to know which is which before you start.

Projects hold compositions

A project is a container. Think of it as the folder for a piece of work: a client, a channel, a campaign. A composition is one actual video edit, and a project can hold as many as you want. The trailer, the full cut, and the three social clips can all be compositions inside one project.

Project

The container. It has a name, an optional description, and the collaborators you invite. It's also what connects to GitHub for versioning.

Composition

One edit. It has its own timeline, canvas size, frame rate, and duration, and it opens in the editor.

Creating things

From your dashboard, New Project makes a project and drops you into its first composition. Inside a project you can add more compositions whenever you need another cut; new ones are named Edit 2, Edit 3, and so on until you rename them.

Each composition remembers its own canvas and frame rate, so a vertical TikTok and a wide YouTube cut can live side by side without fighting each other. A fresh one starts at 1920 x 1080 (16:9), 30 fps, on a black background. The presets are 16:9, 9:16, 1:1, 4:3, 4:5, 21:9, and 2:3, and frame rate can be 24, 25, 30, 50, or 60 fps.

Your work saves itself

You don't save by hand. The editor pushes changes to the server about 800 ms after you stop making them, and a badge in the header tells you where things stand: Saved, Saving, or Offline if the connection dropped. Try to close the tab with a save still in flight and the browser warns you first.

Newer version wins

If someone else (or another tab of yours) saved the same composition while you were working, your save is rejected and the editor reloads the server's version. The badge reads Reloaded — newer version, and any edits you hadn't saved yet are gone. Keep one tab per composition when you can.

Project settings

Open a project's settings page to rename it (up to 256 characters), edit the description and AI context, copy the Project ID, and see its stats. Deleting a project is a two-step confirmation, and it takes every composition inside with it.

On the dashboard, each project card has a menu for Change image (set your own thumbnail) and Delete.

Why the split matters

Two reasons. First, collaborators and GitHub repos attach to the project, so everyone working on that piece of content shares one place and one history, even across several cuts. Second, your AI context attaches to the project too, so notes about the brand or the tone carry across every composition inside it.

Versioning lives at the project level

When you back a project with GitHub, each person gets one branch for the whole project, and all its compositions ride along on that branch. The details are in Projects on GitHub.

Finding your work later

Your dashboard lists your projects, newest first, with a search box to filter them by name. Open a project to see its compositions, which you can search, rename, and delete.

Pin the ones you're actually working on and they sort to the front of the list. Pins are a per-browser preference, so they follow the machine you set them on rather than your account.

On this page