# FAQ

- URL: https://getroomi.com/docs/faq
- Built: 2026-10-26

Short answers to the questions people ask first, each with the page that
explains it in full.

## Getting started

### How do I sign up?

Sign in at app.getroomi.com with GitHub or Google, and your account and
a Free workspace are made on the spot. Then add Roomi to Claude as a
connector and say "deploy it to roomi". For a container demo or a bigger build, run
the CLI with `npx @getroomi/cli`, or install it with `npm install -g
@getroomi/cli`; the command is `roomi` throughout these docs. See the
[Quickstart](https://getroomi.com/docs/quickstart), [Deploying from Claude](https://getroomi.com/docs/claude) and
[Install the CLI](https://getroomi.com/docs/install).

### What does it cost?

Free is £0, and is the plan every workspace starts on. Pro is £4 a month, for
one person, and Team £5 a seat a month, for 2 to 5 people, before VAT; a year
costs ten months. Enterprise, for teams of more than 5, is by arrangement:
contact sales. Start on Free, and move to a paid plan whenever you need one,
in the app's Settings, Billing. See [Plans and limits](https://getroomi.com/docs/plans).

### What does Free include?

Five projects, static demos only, two deploys a day, and no private viewer
links. A Free project is an unlisted draft only your workspace can open, or,
once you list it and its
community card passes the checks, public at one address for up to five
people at once, with 100 hours of viewing a month across your public addresses.
Its analytics are total views over the last 30 days, and its rooms carry the
"Made with Roomi" mark. See
[Plans and limits](https://getroomi.com/docs/plans).

### Which AI tools work with it?

Claude in the app or on claude.ai, through the connector: add it, and say
"deploy it to roomi" in a chat. Claude Code, through the Roomi
plugin, in the demo's folder. And any agent that can run commands in a
terminal can run `roomi`, which rehearses by default and publishes only with
`--commit`. See [Deploying from Claude](https://getroomi.com/docs/claude) and [Build with your AI
agent](https://getroomi.com/docs/ai-agents).

## Building a demo

### What can I deploy?

Two kinds of demo. A **static** demo is a built folder of HTML, CSS and
JavaScript with an `index.html`. A **container** demo is a server, from a
Dockerfile, holding every app under its own path on one origin. See [Static
demos](https://getroomi.com/docs/static) and [Container demos](https://getroomi.com/docs/containers).

### Can my demo use a real database or real API keys?

No. Every demo runs on mock data: every viewer gets a copy, so nothing in it
may be real. A demo's container has no internet, so it cannot reach a real
system, and `roomi deploy` stops if it finds a secret in the project or the
build. Seed the demo with mock data on every start. See [Security and
privacy](https://getroomi.com/docs/security).

### Is my code safe?

Your code runs only in its own container, as a user that is not root, with no
access to the platform's database, storage or secrets, and no internet. Nothing
leaves your machine until you run `roomi deploy --commit`, and only after a
secret scan. Demos are served from their own domain, apart from where people
sign in. See [Security and privacy](https://getroomi.com/docs/security).

### My demo is several apps on several ports. Can I deploy it?

Not as it is. A room loads your demo from one origin, so the apps have to be
served by one server, each under its own path. `roomi init` detects this and
prints the change it proposes; it never makes it for you. See
[Troubleshooting](https://getroomi.com/docs/troubleshooting#not-deployable-yet-not-single-origin).

### What does roomi deploy do without --commit?

It rehearses: checks `pitch.json`, scans for secrets, builds, runs your demo on
this machine on the platform's own runner, runs each step of your tour, and
prints what would go live. Nothing is uploaded. `roomi deploy --commit`
publishes exactly what was rehearsed. See [Quickstart](https://getroomi.com/docs/quickstart).

### Can I update a room that viewers already have links to?

Yes. Deploy again: the new build goes live, and everyone opening a link gets it
from their next page load. Nobody's link changes.

### Can I see a build before it goes live?

Yes, two ways. On your own machine, `roomi dev` serves the real room around
your running dev server, tour and all, and nothing in it is recorded or sent.
See [Preview locally](https://getroomi.com/docs/preview). On the platform, `roomi deploy --commit
--preview` (or `deploy_static` with `preview` from Claude) sends a build as a
preview: viewers keep the live build, and only you and your team see the new
one, with **Preview** in the app or `roomi open --preview`. `roomi promote
--commit`, **Make this live** on the project's **Builds** tab, or
`promote_preview` from Claude makes it live. A plain `roomi deploy --commit`
still makes its build live at once.

### Can I roll back?

Yes. `roomi rollback` says which build would go live, and `roomi rollback
--commit` makes the one before the live build live again (`--build` names
another). In the app, the project's **Builds** tab lists every build, and
**Roll back to this** does the same. It does not count as a deploy.

### Does roomi work on Windows or Linux?

Yes. `roomi login` signs in through your browser on any system. On a Mac the
token goes in the macOS Keychain; on Linux and Windows it goes in a file only
you can read. For CI, make an API token in Settings and pass it in
`ROOMI_TOKEN`. See [CLI](https://getroomi.com/docs/cli#api-tokens).

## Running a pitch

### Does a viewer need an account?

No. A private link is the viewer's way in: they open it, and the room opens.
At a listed project's public address anyone can look, and only signing in to
comment or react needs a GitHub or Google account. See [Running a
roomi](https://getroomi.com/docs/running).

### Does a viewer have to give an email?

Only if they comment or react on a private link, which asks for one once, or
if you turn on "Require an email to view" for the project. Nothing is ever
sent to it, and it is not checked. See [Running a pitch](https://getroomi.com/docs/running).

### What if a link is forwarded?

Every browser that opens a link is asked "Are you Priya?", the first one
included, so whoever opens it first is not taken to be her. Someone else can
say who they are, and you see them on the link's pipeline card and in its
journey. If more than one session says yes, the card says so. See
[Analytics and the pipeline](https://getroomi.com/docs/analytics).

### A viewer lost their link. Can I send it again?

Yes. **Copy link** beside them, on the project's **Links** tab, their pipeline
card or their journey, copies the same address again; so do
`roomi link copy "<their name>"` and `get_link` from Claude. Each time is
recorded in the project's history. A link made before 1 October 2026 offers
**Reissue link** instead: the same viewer under a new address, with the old one
stopping at once. See [Sharing a private link](https://getroomi.com/docs/sharing#when-they-lose-it).

### How do I stop a link working?

Revoke it, in the project's **Links** tab, with `revoke_link` from Claude, or
give it an expiry of 1 to 365 days when you make it. A revoked or expired link
stops working on the next request. See [Sharing a private link](https://getroomi.com/docs/sharing).

### A viewer asked me to delete their data. How?

**Erase data** beside their link, on the project's **Links** tab, erases
everything anyone did under that link: visits, comments and their pictures,
answers, reactions, meetings, and your notes on them. The link stops opening
the room, and its name and email go too. To erase one person a link was passed
on to, use **Erase data** beside them on the link's journey, and the link and
everyone else stay. The app counts what will go and asks first; it cannot be
undone. `erase_viewer` from Claude does the same, and rehearses first. Your
project's history records that it was done, without their name. If you would
rather we did it, write to us and we will.

### Can I close a room for a while?

Yes: pause it from the project's Settings, with a note if you like. Every link
shows a page saying the room is paused, until you resume it; nothing is
deleted and the links do not change. See [Pausing a
room](https://getroomi.com/docs/running#pausing-a-room).

### What can I see about each viewer?

On a paid plan: every visit, how long they spent on each app and page, the
order they did things in, how far they took the tour, what they commented and
which next step they chose. On Free: total views. See [Analytics and the
pipeline](https://getroomi.com/docs/analytics).

### How do I know when someone opens a link?

New viewers and feedback show up in the app: each visit in the link's journey,
on the project's **Activity** tab, and the link's card moving on in the
**Pipeline**; comments and answers in **Feedback**. A follow-up date you set
shows on the card. From a chat, Claude can tell you who looked and what they
said. See [Analytics and the pipeline](https://getroomi.com/docs/analytics).

### Can my rooms carry my brand?

On a paid plan, yes: your name, accent colour and logo. On Free, a room carries
a "Made with Roomi" mark, and the brand you set is kept for when you
move to a paid plan. See [Brand and next steps](https://getroomi.com/docs/brand).

### Can I work on a workspace with my team?

On Team or Enterprise, yes: invite someone by email, and send them the link the app makes;
Roomi sends nothing. See [Teams and invites](https://getroomi.com/docs/teams).

### What happens if I go over a limit?

The thing you asked for is refused, with what your plan allows and which plan
would allow more. Nothing is ever deleted: over the project limit, the ones
used least recently are paused, and over the month's viewer-hours, rooms stop taking new
visits without cutting anyone off. See [Plans and limits](https://getroomi.com/docs/plans).

## Viewing a pitch

### Is the data in the demo real?

No. Every room says so: "This demo runs on mock data. Nothing you do here
reaches a real system." Change anything you like. On a private link your copy
of the demo is your own, and nobody else sees what you do in it; at a public
address everyone shares one copy.

### Can I open the demo on my phone?

Yes. "Open on your phone" shows a QR code that opens the same app on your
phone, as the same person. On a demo with a server, the phone joins the same
copy, so what you do on one screen shows on the other. The code works for ten
minutes.

### What does the publisher see about me?

On a private link: the name they gave the link, anything you typed (a name, an
email, comments, answers), and what you did in the room, with how long you
spent on each app and page and whether you were on a phone, tablet or
computer.
Inside the demo, only if you said yes when the room asked: the screens you
opened and what you clicked, never what you typed. No IP address or location.
At a public address: nothing about you, unless you sign in to comment or react, when they
see your name, handle and avatar, never your email. See [Security and
privacy](https://getroomi.com/docs/security).

### Why does it say the demo is full?

A listed project's public address lets five people in at once, and a container
demo runs as many copies as its plan allows. Try again in a few minutes. See
[Troubleshooting](https://getroomi.com/docs/troubleshooting#this-demo-is-full-right-now).

### Why did the demo pause?

A copy runs only while you are using it. Leave the tab hidden or untouched for
ten minutes and it stops a few minutes later; **Resume the demo** starts a
fresh copy. See [Troubleshooting](https://getroomi.com/docs/troubleshooting#the-demo-paused).

## The community

### Is my project public?

Not unless you list it and its card and build pass Roomi's checks. Every project
starts as an unlisted draft that only your workspace can open. See [The
community](https://getroomi.com/docs/community).

### Can I browse the community?

Yes, at [the community page](https://getroomi.com/community):
every listed card, newest first, each opening its project in a new tab. See
[The community](https://getroomi.com/docs/community#where-listed-projects-appear).

> [!NOTE]
> Every workspace starts on Free, and moves to Pro or Team whenever you like, in Settings, Billing. Sign in at app.getroomi.com with GitHub or Google, then add the connector to Claude at https://mcp.getroomi.com/mcp, or run the CLI with npx @getroomi/cli. These pages describe the connector, the CLI, pitch.json, the app and the room as they are.
