# Installation notes (FTP only)

## Target

Local document root:

```text
C:\ServBay\www\servbay\colorlex.com\
```

Public URL:

```text
https://colorlex.com/
```

Treat that folder as the public webroot. `index.html` is the default document.

## Deployment

1. Edit files locally in the webroot (or copy this tree).
2. FTP upload the same tree to the host document root.
3. Overwrite matching files. Do not run a build on the server.

There is no `npm install`, no `composer install`, no Docker compose, no GitHub Action, no webpack, no Vite.

## Required constraints

- No bundlers
- No dependency managers
- No containerization
- No CI/CD
- No symlinks
- No Composer
- No NPM
- No Laravel / React compile step
- No frameworks that require compilation

Everything must run from the files placed in the webroot.

## What belongs here now

```text
index.html
README.txt
docs/overview.md
docs/architecture.md
docs/explaining-lupopedia-to-modern-ides.md
docs/auto-installer-ecosystem.md
docs/why-modern-stack-breaks-lupopedia.md
docs/federation-registration-model.md
docs/local-data-model.md
docs/intent-statement.md
docs/colorlex-purpose.md
docs/installation-notes.md
docs/federation-node-3.md
docs/routing-basics.md
assets/css/style.css
lupopedia/            (Lupopedia Semantic OS -- not ColorLex)
```

## What does not belong here

- `node_modules/`
- `vendor/`
- `.git` is optional for local work; FTP deploys files, not a required remote git workflow
- Compiled `dist/` output from a frontend toolchain
- PHP that needs Composer autoload

PHP may be added later as **plain PHP + PDO**, matching Lupopedia doctrine, still without Composer. That is not this placeholder.

## Markdown in the browser

`docs/*.md` may display as raw text depending on the host. That is acceptable for this stage. Do not add a Markdown compiler pipeline to "fix" that.

## Lupopedia subdirectory

The Lupopedia Semantic OS is at `lupopedia/` under this webroot:

- Keep ColorLex files at the vhost root unless Captain moves them.
- Lupopedia lives in `lupopedia/`. ColorLex stays at `/`.
- Do not point ColorLex hrefs at a hardcoded drive letter.
- Use Lupopedia's own public-path rules inside that install (`LUPOPEDIA_PUBLIC_PATH` / `$base` in Lupopedia PHP). ColorLex HTML stays relative.
- Public URL: `https://colorlex.com/lupopedia/`

This host is the reference color-node install. Other domains install the same OS at `theirdomain.com/lupopedia/` through the auto-installer ecosystem (Softaculous, Installatron, Fantastico, AMPPS, Webuzo, cPanel Site Software, DirectAdmin, Plesk Application Vault, InterWorx, host-specific catalogs; FTP and zip now). ColorLex is node 3, not those other domains. See [architecture.md](architecture.md) and [auto-installer-ecosystem.md](auto-installer-ecosystem.md). If an IDE suggests Composer, Docker, npm, a GitHub pipeline, or moving Lupopedia to document root, that is a break condition -- read [why-modern-stack-breaks-lupopedia.md](why-modern-stack-breaks-lupopedia.md) and [explaining-lupopedia-to-modern-ides.md](explaining-lupopedia-to-modern-ides.md) first.

## ServBay

Local preview uses ServBay on this machine. The vhost document root must be this folder. No extra build watchers.