fix: serve the website dist so Coolify answers GET /
All checks were successful
CI — Website / Website — typecheck, build (pull_request) Successful in 1m1s

Nixpacks built Vite but had no production start command, so Coolify returned Cannot GET /.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
john kevin asprec
2026-08-17 22:27:25 +08:00
parent 5a79f1a2eb
commit efdae32ae1
16 changed files with 193 additions and 38 deletions

View File

@@ -24,27 +24,45 @@ npm run website:build
# → packages/website/dist/
```
Preview production build: `npm run website:preview`.
Preview production build locally: `npm run website:preview` (Vite, localhost only).
Uses HashRouter so the site works on static hosts without server-side rewrite rules.
Production start (what Coolify should run): `npm start` — serves `dist/` on `0.0.0.0:$PORT` (default 3000).
Uses HashRouter so deep links work even without SPA rewrite rules. The production server still maps unknown paths to `index.html`.
## Deploy on Coolify
This package is a **static** Vite build (`dist/`). No LexAI API keys or env vars.
This package is a static Vite build. No LexAI API keys or env vars. Do not add `LEXAI_API_KEY`.
1. In Coolify: **+ New** → **Resource** → **Private Repository (with deploy key)** (Gitea).
2. Repo SSH URL, for example `git@git.juankibin.space:kibin/LexAI.git`. If Gitea SSH is not on port 22, use `ssh://git@git.juankibin.space:PORT/kibin/LexAI.git` (Coolify sometimes needs `ssh:///` with three slashes).
`Cannot GET /` means Coolify started a Node process that is not serving `dist/` (no `start` command, or "static site" pointed at the wrong folder). Fix: use one of the two setups below, then **Redeploy**.
**Required on either setup**
1. **+ New** → **Resource** → **Private Repository (with deploy key)** (Gitea).
2. Repo SSH URL, for example `git@git.juankibin.space:kibin/LexAI.git`. If Gitea SSH is not on port 22, use `ssh://git@git.juankibin.space:PORT/kibin/LexAI.git`.
3. Add Coolify’s public deploy key to the Gitea repo: **Settings → Deploy / Access Keys** (read-only).
4. Branch: `dev` or `main`.
5. **Build Pack:** Nixpacks.
6. **Base Directory:** `/packages/website` — required. Root `npm run build` builds Chrome, not this site.
7. Enable **Is it a static site?**
8. **Publish Directory:** `/dist`
9. **Install command** (if the build says `vite: not found`): `npm ci` (do not omit devDependencies — Vite lives there).
10. Optional env: `NIXPACKS_NODE_VERSION=22`
11. Optional **Watch Paths:** `packages/website` so Chrome/VS Code/CLI commits do not redeploy.
12. Set the domain, **Deploy**, then open `https://your-domain/#/docs`.
5. **Base Directory:** `packages/website` — no leading slash. Root `npm run build` builds Chrome, not this site.
6. Optional **Watch Paths:** `packages/website`.
7. Set the domain, deploy, open `https://your-domain/` (docs: `https://your-domain/#/docs`).
### Option A — Dockerfile (recommended)
1. **Build Pack:** Dockerfile.
2. Leave **Is it a static site?** **off**.
3. **Ports Exposes:** `80`.
4. If Coolify asks for a Dockerfile path: `packages/website/Dockerfile` (or omit it when Base Directory is already `packages/website`).
### Option B — Nixpacks
1. **Build Pack:** Nixpacks.
2. Leave **Is it a static site?** **off**. Nixpacks runs `npm run build` then `node server.mjs`.
3. **Start command** (if the field is shown): `npm start` or `node server.mjs`.
4. **Ports Exposes:** `3000`.
5. Optional env: `NIXPACKS_NODE_VERSION=22`. Do not set `NODE_ENV=production` at **build** time — Vite is a devDependency and `npm ci` would skip it.
Do **not** tick "Is it a static site?" with Publish Directory `/dist`. The leading slash is an absolute path (`/dist` on the container), which is empty, and Coolify then answers `Cannot GET /`.
If you already created the resource: uncheck static site, set Base Directory and port as above, then Redeploy (no need to recreate the app).
Auto-deploy: Coolify resource → **Webhooks** → copy the URL + secret into Gitea **Settings → Webhooks** (push events).
Do not add `LEXAI_API_KEY` or any provider key to this Coolify app.