Flat / HTML hosting
HTML hosting: share an HTML file as a URL.
Publish HTML from your browser or the CLI, then share the link. Readers can open your report, prototype, or static site without a Flat account.
Checking your upload limits... · Public · Limits
Drop your HTML files here
or choose them from your device.
Select HTML filesWhat readers see at your HTML link
You have a finished report or demo to show. Publish its static files, open the link to check the page, then send it to your client or colleague.
HTML, CSS, and client-side JavaScript run in the visitor's browser. A self-contained report can include charts, filters, and other browser-based controls.
A root index.html opens as the main page. An exact file path, such as /report.html, opens that HTML page. Without a root index.html, the main link opens Flat's file viewer or explorer.
How to upload and publish an HTML website
Prepare your HTML files
Use a static export or a page that is ready to run in a browser. If your project needs a build, run it first and publish the output. Name the main page index.html.
Include the images, stylesheets, and scripts your page uses. Keep their paths consistent with the files you publish. Flat does not build source code or run server-side code.
Upload in your browser
Drop your HTML file and any supporting files into the uploader above, or select them from your device. Enter your email if signed out, then choose "Publish page".
Each file needs a unique name. Selected files publish together at the top level. For a site with subfolders, use the CLI. The browser uploader does not accept folders or extract ZIPs.
Deploy with the CLI
Install Node.js 20 or newer, then run this command from your project directory to publish its finished output:
npx -y @getflat/cli deploy ./distReplace ./dist with your output folder, or use ./index.html for a standalone page. The CLI preserves relative file paths and prints the published URL. If your export is a ZIP, extract it first.
Open and share the URL
Check the page, images, links, and controls at the published URL. Copy the link and send it when the result is ready.
Signed-out uploads from either route expire after 1 hour. Sign in before expiry to keep them online, or sign in before publishing for no default expiry.
What you can publish with HTML hosting
Client proposals and reports
Share a finished HTML proposal or report in a browser. If you made it with an AI tool, export standalone static files first. Check that the page works without that tool's runtime.
Prototypes for feedback
Give collaborators a link to the version you want them to review. Ask for feedback through the conversation or review tool you already use.
Landing pages and static websites
Upload website files from an existing landing page or static site export. Keep any forms or other server-dependent features connected to a separate service that supports them.
Keep a version, or keep an address.
Share this version
Every upload gets its own link. Publishing revised files creates a new link and leaves the earlier version unchanged. Use the version link when someone needs to review a specific upload.
Update files at one address
Use a named onflat.page address or your own domain. Sign in, then publish with the CLI using --domain. Publish revised files with the same domain to point that address to the new upload.
Named addresses are included on Free. Adding your own domain requires a paid plan. The browser uploader does not set up or repoint these addresses.
HTML hosting questions
Is hosting free, and what are the limits?
Yes. Signed-in Free includes 5 MiB per upload, 1 GiB of storage, and 5 GiB of monthly transfer, with no default expiry. The per-upload limit covers all files in that upload. Paid plans raise these limits.
Do readers need a Flat account?
No. Public links open without a Flat account. Anyone with the link can open the uploaded files. Password-protected links also require the visitor password.
Can I password-protect my upload?
Yes. Password protection is available on every plan. Add --password YOUR_PASSWORD to your CLI deploy command. It protects access to the upload and its files, but does not prevent someone with access from saving a copy. The browser uploader creates public uploads.
Can I replace files without changing the link?
A version link always refers to its original upload. For same-address updates, use a named address or your own domain. Publish revised files with the same --domain value in the CLI to point that address to the new upload.
What happens when an upload expires?
Flat stops serving it. An expired upload cannot be recovered. Signed-out uploads expire after 1 hour by default. For browser uploads, use the sign-in link shown after publishing. For CLI uploads, run npx -y @getflat/cli login. Complete sign-in before expiry to keep the upload online. If you chose a shorter expiry in the CLI, that deadline stays in place.
What if my file is called report.html?
You can publish it. Open its exact file path, such as /report.html, to see the page. Without a root index.html, the main link opens Flat's file viewer or explorer instead. Rename your main page before uploading if you want it at the main link.
Can Flat host a React or Next.js project?
Flat can host a compatible static build or export. It does not build source code or run server rendering. Features that need a server require another service.
Can I publish HTML made with Claude or ChatGPT?
Yes, if you have finished static files that work independently of the AI tool. A standalone HTML page can fit. An app that needs the tool's runtime, a server, or secret API credentials needs a different setup.
Is this an HTML to URL converter?
Flat gives your HTML file a hosted URL. Your file stays HTML. Open the hosted page at its exact file path, or use index.html for the main link.
Can I edit my page in Flat?
Edit your source files in your own tool, then publish a new upload. If you use a reusable address, point it to the new version through the CLI.
Give someone a link to your page.
Publish the finished files. Check the result in your browser, then send the URL.
Publish pageFree to start · View pricing
Sharing a document instead? See PDF hosting.