briefroom frequently asked questions

Upload the whole folder, including the images, CSS, and JavaScript your HTML references. If you upload index.html on its own, relative references such as images/logo.png point to files that are not there, so the images do not render. When you drag and drop, drop the folder itself rather than individual files. With the CLI, npx @briefroom/cli deploy ./your-folder uploads the entire folder. HTML that references absolute paths on your own machine (file:///Users/... or C:\...) will not render either. Rewrite those as relative paths before uploading.

A share URL has two display modes: review mode and live mode. The header and the commenting UI appear in review mode, which is the default and is meant for asking people to review the page. Switch to live mode and no briefroom UI is shown — only the HTML you uploaded, full screen. That suits showing a page to people outside your team as simple hosting. You can pick the display mode when you create a share URL, and change it at any time afterwards from the share URL settings in the dashboard. Password protection and email-invite access still work in live mode.

A share URL contains a random string — it is a page only people who know the link can open. It is not listed by search engines. If you need tighter control, use password protection or email-invite access (both on Pro and above).

You get 3 rooms, 3 share URLs, and 500 MB of storage for free. Uploading, sharing, commenting, and handing feedback back to an AI are all unrestricted on the free plan. Password protection, email-invite access, version management, and PDF export are Pro features.

Upload the whole folder, including the images, CSS, and JavaScript your HTML references. If you upload index.html on its own, relative references such as images/logo.png point to files that are not there, so the images do not render. When you drag and drop, drop the folder itself rather than individual files. With the CLI, npx @briefroom/cli deploy ./your-folder uploads the entire folder. HTML that references absolute paths on your own machine (file:///Users/... or C:\...) will not render either. Rewrite those as relative paths before uploading.

We allow .html / .htm / .css / .js / .mjs / .json / .png / .jpg / .jpeg / .gif / .webp / .svg / .woff / .woff2 / .ico. Upload your HTML together with the static files it references. If you upload a single PNG, JPEG, GIF, or WebP on its own, we build a page around it for you. Formats that are not on the list (executables and the like) are rejected. Renaming the extension does not help — we inspect the file contents as well.

On the free plan: 5 MB per file, 30 MB per upload, and 500 MB of storage in total. On Pro those become 20 MB, 200 MB, and 5 GB.

Upload to the same room again and it is added as a new version — the share URL stays the same. There is no need to send the URL again.

The major CDNs work. We allow jsDelivr, cdnjs, unpkg, esm.sh, and Google Fonts. Other CDNs are blocked, so bundle those files with your upload or switch to an allowed CDN. At upload time we detect the external URLs your HTML loads and list them in a warning panel. Allowed CDNs appear in that list too, but they render fine. The exception is the Tailwind Play CDN (cdn.tailwindcss.com): it renders today, but Tailwind officially discourages it for production and it has blocked our delivery domains before, so we classify it as unstable and keep warning about it. Bundling a pre-built CSS file is the recommended approach.

A share URL contains a random string — it is a page only people who know the link can open. It is not listed by search engines. If you need tighter control, use password protection or email-invite access (both on Pro and above).

A share URL has two display modes: review mode and live mode. The header and the commenting UI appear in review mode, which is the default and is meant for asking people to review the page. Switch to live mode and no briefroom UI is shown — only the HTML you uploaded, full screen. That suits showing a page to people outside your team as simple hosting. You can pick the display mode when you create a share URL, and change it at any time afterwards from the share URL settings in the dashboard. Password protection and email-invite access still work in live mode.

Yes, on Pro and above. Set a password from the share URL settings screen and viewers are asked for it before the page opens.

Use email-invite access on Pro and above. Only the people at the email addresses you invite can view the page. You can invite up to 5 people per share URL.

On the free plan you can choose 24 hours or 7 days. Pro and above add 30 days, 90 days, and no expiry.

You can revoke a share URL from the dashboard at any time. Once revoked, opening the same URL no longer shows the page.

Anyone who can open the share URL can comment without creating an account. The people you ask for a review never have to sign up.

When you comment by picking an element or dragging a box around an area, a screenshot showing that spot is recorded alongside the comment. That saves everyone from describing "this bit here" in words.

Pass the share ID to the CLI command npx @briefroom/cli feedback pull with --format prompt, and you get the comments back as text an AI can read directly. Over MCP, an AI agent can fetch the comments itself.

Claude Code, Codex CLI, Cursor, Cline, Roo Code — any AI agent that can run terminal commands can use the CLI. We also ship a stdio MCP server, so MCP-capable clients can call it as a tool without going through the CLI.

You get 3 rooms, 3 share URLs, and 500 MB of storage for free. Uploading, sharing, commenting, and handing feedback back to an AI are all unrestricted on the free plan. Password protection, email-invite access, version management, and PDF export are Pro features.

The pricing page has a full feature comparison table.

Credit cards (Visa, Mastercard, American Express, JCB, and Diners Club). Payments are processed through Stripe, and card details are never stored on our servers. Monthly plans are charged when you sign up and renew automatically on the same day each month. Founders Edition is a single one-time charge at purchase.

Cancelling a paid plan does not delete anything you have uploaded. Your plan returns to Free, and while you are over the free plan limits you cannot create new rooms or share URLs. Deleting your account is a different matter: it removes your rooms, version history, share URLs, and uploaded files, and after 30 days the records are physically deleted from the database as well. That cannot be undone.

HTML uploaded by users is served from a domain separate from the main service. Even if malicious code got through, it has no path to your login credentials. The security page describes our inspection steps in detail.

Metadata is stored in Supabase (Tokyo region) and the HTML itself in Cloudflare R2 (US region). See the privacy policy for details.

Deleting from the dashboard erases the stored files, the database records (versions, share URLs, comments, and access logs), and the delivery cache.