Quick answer
How to host a website from a ZIP file
A website ZIP becomes a live site when a host extracts it and serves itsindex.htmlfile as the homepage. Put the finished HTML, CSS, JavaScript, images, and fonts in one ZIP, upload it to GeminiLaunch, and publish. You receive a public HTTPS link; visitors see the website, not a file download.
- Input
- A ZIP, folder, or single HTML file
- Required
- A browser-ready index.html homepage
- Output
- A public website on an HTTPS URL
- Not required
- Git, GitHub, a CLI, or server setup
Choose the simplest input
Single HTML file, ZIP, or folder?
All three can become a website. Use the format that matches what you already have.
Single HTML file
Best for one page with inline styles, or a page that loads assets from the web.
Paste or upload HTML
Website ZIP
Best for several pages or separate CSS, JavaScript, images, and fonts.
One file keeps paths together
Website folder
Best while working locally because you can select the finished folder directly.
No zipping step
Only have one page? Read the focused guide to hosting an HTML file online.
The part that matters
Use a clean website ZIP structure
The homepage and its assets must be inside the archive. Relative paths keep those assets working after the site moves from your computer to the web.
my-website.zip
├── index.html
├── css/
│ └── styles.css
├── js/
│ └── app.js
└── images/
└── logo.webpmy-project.zip
├── package.json
├── node_modules/
├── src/
└── .envUse relative asset paths
images/logo.webpC:\Users\me\logo.webpThe first path travels with the website. The second only exists on your computer.
No Git workflow
Turn the ZIP into a live website in 3 steps
A simple static site can be online in a few minutes.
- 1
Prepare the finished website
Use a folder that contains index.html, CSS, JavaScript, images, and fonts. If the project uses Vite, React, Vue, or another build tool, run its build command and use the finished dist or build folder instead of src.
- 2
Check the ZIP or folder
Make sure index.html is easy to find, asset paths are relative, and private files such as .env are not included. GeminiLaunch also provides a free ZIP checker that runs in your browser.
- 3
Upload and publish
Upload the ZIP or choose the folder in GeminiLaunch, give the site a name, and publish. The result is a public HTTPS website that opens in a browser, not a ZIP download page.
Free readiness check
Catch a blank website before you publish
GeminiLaunch can inspect a ZIP in your browser without uploading it. The tool looks for the mistakes that cause most blank or broken static websites.
- Missing index.html
- Extra wrapper folder
- src instead of dist
- Missing asset files
Ask your AI to prepare the ZIP
Paste this into ChatGPT, Claude, Gemini, Cursor, or another coding assistant:
Prepare this project as a static website ZIP.
The ZIP must contain:
- index.html as the homepage
- all CSS, JavaScript, images, and fonts
- relative asset paths
- the finished dist/build output, not src or node_modules
Remove .env files, secrets, server code, and unused source files.
The site should work when index.html is opened in a browser.Static website boundary
What works from a ZIP—and what does not
A ZIP upload is ideal when the browser can run the finished website by itself. Server features need a different kind of host.
Works well
- HTML, CSS, and browser JavaScript
- Images, fonts, videos, and documents
- Multi-page static websites
- Vite, React, and Vue static build output
- Portfolios, landing pages, demos, and client previews
Needs another service
- PHP or a Node.js server
- Private databases and server credentials
- Server-side rendering and API routes
- A framework project that has not been built
- Authentication or payments without an external service
| Method | What the visitor gets | Best use |
|---|---|---|
| ZIP website hosting | A website that opens in the browser | Publishing a finished static site |
| ZIP file sharing | A file to download | Sending source files or an archive |
| HTML preview | A temporary browser preview | Checking one HTML page |
Fast troubleshooting
Fix the most common ZIP upload problems
Start with the file structure before changing the design or rebuilding the whole site.
There is no index.html
The host cannot find a homepage.
Fix: Name the main page index.html, using lowercase letters.
The site is one folder too deep
The ZIP opens to another folder before the website files appear.
Fix: Zip the website files themselves, or use GeminiLaunch, which can unwrap one normal wrapper folder.
You uploaded src instead of dist
The archive has package.json and src, but no browser-ready homepage.
Fix: Run the build command, then upload the new dist or build folder.
Images or styles are missing
The page opens, but it is blank, unstyled, or missing pictures.
Fix: Include every referenced asset and use paths such as images/logo.png, not paths from your computer.
Still seeing a white page? Follow the deeper blank ZIP website troubleshooting guide or the focused guide to uploading dist instead of src.
Start free, upgrade when the site has a job
Choose the plan around what happens next
The first publish can be free. Pay when you need to keep editing, use your own domain, protect a client preview, or measure traffic.
Free
Free
- Up to 3 live sites
- 5 MB ZIP or folder uploads
- Free HTTPS subdomain
- First version stays as published
Lite
$5/mo
- 15 MB uploads
- Edit and republish
- 1 custom domain
- Password protection and no badge
Pro
$15/mo
- 45 MB uploads
- Unlimited live sites
- 5 custom domains
- Website analytics
Questions
ZIP website hosting FAQ
Short answers to the questions people ask before uploading a website ZIP.
- How do I turn a ZIP file into a website?
- Put a browser-ready static website inside the ZIP, with index.html as the homepage. Upload the ZIP to a static website host such as GeminiLaunch. The host extracts the files and gives you a public HTTPS address that opens the website in a browser.
- Can I turn a ZIP file into a website for free?
- Yes. GeminiLaunch Free publishes up to 3 live sites on free GeminiLaunch subdomains and accepts website ZIP or folder uploads up to 5 MB per site. A free site stays as first published; editing and republishing start on Lite.
- What should be inside a website ZIP?
- Include index.html, plus every CSS, JavaScript, image, font, and other file used by the site. Keep links relative, preserve the folder structure, and leave out node_modules, .git, .env, source maps, and other files the public website does not need.
- Can I upload a folder instead of making a ZIP?
- Yes. GeminiLaunch accepts either a website folder or a ZIP. A folder is easier while you are still making changes. A ZIP is convenient when an AI tool or website builder already exported one file for you.
- What is the difference between a single HTML file and a website ZIP?
- Upload one HTML file when the page contains everything it needs or uses web-hosted assets. Use a ZIP when the website has separate CSS, JavaScript, images, fonts, or several HTML pages. The ZIP keeps those files and their paths together.
- Why is my website blank after I upload the ZIP?
- The usual causes are a missing index.html, an extra wrapper folder, uploading source files instead of the finished build, filename capitalization that does not match, or missing CSS, JavaScript, and image files. The free GeminiLaunch ZIP checker tests these problems in your browser.
- Can I host a React, Vite, or Vue project from a ZIP?
- Yes, if it has been built as a static website. Run the project build command, then ZIP and upload the finished dist or build output. Do not upload src, node_modules, or a project that still needs a server to run.
- Will PHP, Node.js, a database, or API routes run from the ZIP?
- No. ZIP website hosting serves static browser files. Client-side JavaScript works, but PHP, Node.js servers, databases, server-side rendering, authentication services, and private API code need a host that supports their runtime.
- Is ZIP website hosting the same as sharing a ZIP file?
- No. File sharing gives visitors the archive to download. ZIP website hosting extracts the archive and serves index.html, CSS, JavaScript, and images as a real website. Visitors open pages instead of downloading your files.
- Can I update the website without changing its link?
- Yes on a paid GeminiLaunch plan. Lite ($5/mo) is the lowest plan that allows editing and republishing at the same address. Free sites remain online as first published.
- Can I use my own domain for a website uploaded as a ZIP?
- Yes. Publish on a free subdomain first, then connect one custom domain on Lite ($5/mo), up to 5 on Pro ($15/mo), or unlimited domains on Scale. SSL is included.
Ready when your files are
Turn the ZIP into a website
Publish the first version on a free HTTPS link. Add your domain or keep updating the same site when you need more.
