Uploading a built site

Put a built site up with one command. It stays online when your computer is off.

Upload a folder

npm run buildouicu deploy ./dist

Point it at the folder your build writes: dist for Vite and Astro, out for a Next.js static export, build for Create React App. ouicu uploads it and prints the link. After that, your computer can be off: ouicu serves the site.

What the terminal says on Free

Uploaded 24 of 24 files   Live at https://calm-otter-4821.ouicu.app  24 files, 1.2 MB  It stays up until 2026-10-11, a week after this upload, on your plan.

Only files ouicu doesn't have yet are uploaded, so uploading the same site again is quick. The guide Share a website without setting up hosting goes through it from the start.

Update a site

Each ouicu deploy without --name makes a new site with a random name. To update a site, deploy again with its name:

ouicu deploy ./dist --name calm-otter-4821

Visitors see the new version as soon as the upload finishes. Until then, they see the old one.

Flags

Flags for ouicu deploy
Flag	What it does	Plans
`--name <name>`	One of your sites to replace, or a reserved name (Hobby and Pro).	All
`--spa`	A single-page app: paths with no file get `index.html`, so routing in the browser works.	All
`--password`	Ask visitors for a password, typed at the prompt or read from `OUICU_PASSWORD`.	Hobby and Pro
`--no-qr`	Leave out the QR code for opening the link on a phone.	All
`--json`	One JSON object a line: `progress`, `deployed` or `error`.	All

What --json prints

{"event":"progress","sent":0,"total":24}{"event":"progress","sent":24,"total":24}{"event":"deployed","url":"https://studiolund.ouicu.app","name":"studiolund","files":24,"bytes":1258291,"expiresAt":null,"skipped":[]}

How addresses find files

/ and /docs/ get their index.html.
/about gets about.html, or about/index.html.
Any other path gets index.html with --spa. Without it, your 404.html if the site has one, or a page from ouicu saying the page isn't on the site.
A live share under the same name wins: while you share at a site's name, visitors see the share.

What gets uploaded

The files a web page is made of: HTML, CSS, JavaScript, JSON, source maps, images, fonts, WebAssembly, text and XML. Others, like videos, PDFs and archives, are left out, and the terminal lists them:

  Left out /intro.mp4: not part of a web page.

Dot files are left out too, apart from .well-known, and so are node_modules and links.

Limits

Uploaded sites by plan
	Free	Hobby	Pro
Sites	1	10	Unlimited
Size of one site	25 MB	100 MB	250 MB
How long a site stays	7 days after its last upload	Until you delete it	Until you delete it

On every plan, a site holds up to 5,000 files of up to 50 MB each (bigger files are left out), and you can upload 30 times an hour. The command refuses a folder with more than 5,000 files or 1 GB: that is a project, not a build.

When a Free site's 7 days are up, its link stops working; upload again to start over. If you move to Free from a paid plan, your sites get 7 days from then.

Delete a site

On the Shares page, press Delete by the site. The link stops working and its files are deleted. From code, use ouicu.sites.delete(id) in the SDK, or DELETE /api/sites/{id}.