MultiConnectMultiConnectDocs Website home
MultiConnectCloud › Website Deployments

5. Site settings explained

All of these can be changed later. Changing SPA fallback, Compression, Cache Max-Age, Basic auth or Build Output Directory redeploys your current build with the new setting, because these settings are built into each container.

SPA fallback

On Off
A path that is not a file, such as /settings, is answered with index.html, so your app's router shows the right page A path that is not a file answers 404
Use for single-page apps with client-side routing: React Router, Vue Router, Angular Use for a multi-page static site, so missing pages return a real 404
index.html is sent with no-cache, so visitors get the new version straight after a deploy

Without it, a single-page app works until a visitor refreshes on a page other than the home page, which then shows a 404.

A missing JavaScript, CSS, image or font file always returns 404, even with SPA fallback on, so a broken link to a file is not hidden behind your home page.

Compression

Sends HTML, JavaScript, CSS, JSON, XML, SVG and WebAssembly files compressed, so pages load faster. Leave it on unless you have a specific reason not to.

Cache Max-Age

How long, in seconds, browsers may keep a file before asking for it again. It applies to files ending in .js, .css, .png, .jpg, .jpeg, .gif, .ico, .svg, .webp, .avif, .woff, .woff2, .ttf, .eot and .map. These files are marked as unchanging, so browsers do not re-check them until the time runs out.

Choice Seconds
No cache 0
1 hour 3600
1 day 86400
1 year 31536000
Custom Any whole number from 0 to 31536000

The time applies by file type, not by file name. 1 year suits most framework builds, because their file names contain a hash of the content, like main.3f9a1c.js, and change on every build. If your file names stay the same between builds, such as app.js or logo.png, visitors can keep the old file for the whole time after a deploy, so choose a shorter time or No cache.

HTML pages are not covered by this setting. With SPA fallback on, index.html is always re-checked, so visitors see a new deploy straight away. With it off, HTML pages are sent without a cache instruction and each browser decides.

Basic auth

Asks visitors for a username and password before showing anything. It suits a staging or preview site that should not be public yet. It is not a replacement for user accounts in your app.

Field Rules
Username Required. Up to 100 characters: letters, numbers, dots, hyphens and underscores
Password At least 8 characters, with no colon (:)

When you update a website that already has Basic auth on, leave Password blank to keep the current password, or type a new one to replace it. Turning Basic auth on for the first time needs a password.

Turning Basic auth off deletes the stored username and password.