Static Sites

Host static websites and SPAs (Single Page Applications) with nginx, CDN, and automatic SSL.

What Are Static Sites

Static sites are applications that run entirely in the browser — HTML, CSS, JavaScript, and assets. Examples:

• Landing pages
• Documentation (like the one you're reading!)
• SPAs with React, Vue, Svelte, etc.
• SSG-generated sites (Next.js, Astro, VitePress, etc.)

Creating a Static Site

1. Go to your stack and click New App
2. Select App as the type
3. Choose Static as the source
4. Set a name for the app
5. Click Create

Uploading Files

After creating the app, you can upload files in two ways:

ZIP Upload

1. On the app edit screen, go to the Static Deploys section
2. Click Upload ZIP
3. Select the ZIP file containing your static files
4. PodCubo extracts and serves them automatically

Tip: The ZIP should contain index.html at the root or inside a single folder (e.g., dist/). PodCubo detects and adjusts automatically.

Deploy from GitHub

You can also connect a GitHub repository and deploy static files via CI/CD. Just build your project and upload the generated ZIP.

How It Works

PodCubo serves your static files with nginx, configured with:

• SPA routing — requests to routes that don't exist as files are redirected to index.html
• Aggressive caching — assets (JS, CSS, images, fonts) get 1-year cache with immutable header
• Gzip — automatic compression for text, CSS, JS, and SVGs
• CDN — all traffic goes through Cloudflare with caching and DDoS protection

Versioning

Each upload creates a new deploy version. You can:

• View deploy history in the Static Deploys section
• Activate a previous version with one click (instant rollback)

Domain

Your static site automatically gets a *.podcubo.com subdomain. You can also configure a custom domain in the app's Basics section.