@hamedb89/localghost 0.1.9 → 0.1.10

package/docs/ghost-tunnel.md

@@ -25,7 +25,7 @@ export default defineLocalghostConfig({
 });
 ```
 
-With `ghostTunnel: { domains }`, route output and Vite startup output use local defaults for `route`, `project`, and `owner`, then fill the configured domain:
+With `ghostTunnel: { domains }` in the default manual mode, route output and Vite startup output use local defaults for `route`, `project`, and `owner`, then fill the configured domain:
 
 ```txt
 localghost ghost tunnel
@@ -43,6 +43,14 @@ localghost ghost tunnel
 
 `manual` is the default activation mode. `ghostTunnel: "manual"` and `ghostTunnel: "public"` are shorthand modes. Use `enabled: false` to keep domains/config in the file without exposing the tunnel surface.
 
+Public mode keeps the namespace flexible unless you configure a preview. This is useful for deployed wildcard endpoints that react to whichever route arrives:
+
+```txt
+localghost ghost tunnel
+  mode: public
+  configured: https://<route>-<project>-<owner>.ghost.socialworkouts.app/
+```
+
 Use object form to override defaults or provide a concrete preview URL:
 
 ```js
@@ -67,6 +75,42 @@ export default defineLocalghostConfig({
 5. Construct tunnel URLs from `route`, `project`, and `owner`.
 6. Validate the incoming request host, protocol, and auth before serving the tunnel surface.
 
+## Vercel DNS
+
+For Vercel, add the Ghost Tunnel wildcard domain to the project first:
+
+```txt
+*.ghost.decisionlayer.tech
+```
+
+Then create the DNS record that points that wildcard at the same Vercel project. In Vercel-managed DNS, the record name is relative to the zone:
+
+```txt
+Name:  *.ghost
+Type:  ALIAS
+Value: <the Vercel DNS target shown for the project>
+TTL:   60
+```
+
+For example, if Vercel shows `cname.vercel-dns-016.com` as the project target, use the fully-qualified value with the trailing dot when the DNS form requires it:
+
+```txt
+Name:  *.ghost
+Type:  ALIAS
+Value: cname.vercel-dns-016.com.
+TTL:   60
+```
+
+When DNS is managed somewhere else, use the provider's wildcard subdomain shape:
+
+```txt
+Name:  *.ghost
+Type:  CNAME
+Value: cname.vercel-dns-016.com.
+```
+
+Do not use only `*` for Ghost Tunnel. A record named `*` covers `anything.decisionlayer.tech`, but Ghost Tunnel URLs look like `decisionlayer-decision-layer-hamed.ghost.decisionlayer.tech`, so the wildcard must live under `ghost`.
+
 ```ts
 import {
   assertSecureGhostTunnelRequest,

package/docs/localghost.1.md

@@ -154,7 +154,7 @@ When `localghost.config.mjs` exists, `run`, `dev`, `setup`, `status`, `routes`,
 
 Relay helpers are private by default. Registration requires an authenticated local-agent bearer token plus an exact signed route claim. Targets must be explicit local host/port objects, dangerous ports are blocked, private/LAN targets require explicit opt-in, internal and hop-by-hop headers are stripped, sensitive logs are redacted, and offline agents get a safe 503 page.
 
-When `ghostTunnel` is configured, route output and Vite startup logs print local defaults for `route`, `project`, and `owner`. Add `ghostTunnel.domains` to fill one or more production base domains. When `ghostTunnel.preview` is configured with `route`, `project`, and `owner`, they print the concrete URL, inheriting `ghostTunnel.domains` unless `preview.domain` is set. In an interactive Vite terminal, press `g` to show Ghost Tunnel configuration and open a numbered concrete URL.
+When `ghostTunnel` is configured, route output and Vite startup logs print the production URL shape. Manual mode can fill local defaults for `route`, `project`, and `owner`; public mode leaves those slots as `<route>`, `<project>`, and `<owner>` unless `ghostTunnel.preview` pins a concrete URL. Add `ghostTunnel.domains` to fill one or more production base domains. When `ghostTunnel.preview` is configured with `route`, `project`, and `owner`, logs print the concrete URL, inheriting `ghostTunnel.domains` unless `preview.domain` is set. In an interactive Vite terminal, press `g` to show Ghost Tunnel configuration and open a numbered concrete URL.
 
 `dev` and `run` register active sessions in a user-local activity file so `localghost ps` can show what is running across projects.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hamedb89/localghost",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Friendly local hostnames for app repos with .localghost, Caddy, /etc/hosts, and Vite.",
   "type": "module",
   "bin": {