FAQ

Short answers to the questions people ask first.

On this page

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, Deploying from Claude and Install the CLI.

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.

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.

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 and Build with your AI agent.

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 and Container demos.

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.

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.

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.

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.

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. 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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

Can I browse the community?

Yes, at the community page: every listed card, newest first, each opening its project in a new tab. See The community.