Purpose of web root folder in project options?

[briar]

Have looked at the documentation but can’t understand WebRoot Folder in project options/general. I am creating a static site: development Env: Own Server, server model: none. INto this WebRoot FOlder field am I meant to enter a folder in the website files on my computer or does it relate to eg public_html on the website? Wappler is not accepting anything that I put in here. Should I just leave it blank?

[franse]

Maybe this can clarify:

@Hyperbytes

The Web root is the folder where your website files are put. Typically the folder in which you put your home page.
Common locations are “www”, “htdocs”, “public_html” although for a node site it will be your application folder, something like “nodejsapp” or whatever your choose.
Many systems, especially on shared platforms have both an ftp root (server root) and a Web root which is often a sub folder of the ftp root.
A common setup error is pointing to the ftp root rather than the Web root as all connection checks will fail as the test files will be uploaded to the wrong place.

[ben]

Hi Briar,
You're not alone, this one's a bit of a chameleon depending on your setup.

Think of the Web Root Folder as the public-facing folder where your site’s files live when served to a browser. Its meaning shifts depending on the server model:

• PHP: Typically uses /www, /htdocs, or /public_html as the web root.

• Node.js: Conventionally /public is the folder exposed to the browser.

• No server model (static site): There’s no “web root” in the traditional sense, Wappler just needs to know where your homepage (index.html) and assets live locally.

So, in your case—static site, own server, no server model, you’re free to point it to whatever folder holds your site files on your machine. For local development, you can leave it blank.

No server, no rules. Just vibes.

[briar]

Thanks Ben. Re your last point. You say : There’s no “web root” in the traditional sense, Wappler just needs to know where your homepage (index.html) and assets live locally.

I tried to enter the local folder in which the index.html lives but it wouldn’t let me enter anything. I guess that’s because it’s local development?

When it comes to ftp upload to remote server will it still work if that field is not filled in?

Sorry - I’m a basic user - though enjoying Wappler.

Thanks for your help.

[ben]

Apologies for the late reply, I was out of the office.

When uploading the site, you will need to state the remote web root folder which will most likely be one of the PHP web root folders.