baeroe/prevju repository overview

⁠prevju

Self-hosted previews for HTML drafts. Upload a folder, send the link to your client, optionally with a password.

Docs: prevju.dev⁠

⁠Quick start

docker-compose.yml:

services:
  prevju:
    image: baeroe/prevju:latest
    restart: unless-stopped
    ports:
      - "7738:8080"
    environment:
      APP_URL: "${APP_URL}"
      ADMIN_EMAIL: "${ADMIN_EMAIL}"
      ADMIN_PASSWORD: "${ADMIN_PASSWORD}"
    volumes:
      - prevju-data:/var/www/html/storage/app

volumes:
  prevju-data:

.env next to it:

APP_URL=https://preview.example.com
[email protected]
ADMIN_PASSWORD=change-me

docker compose up -d                              # start
docker compose pull && docker compose up -d       # update

Open APP_URL, log in with ADMIN_EMAIL / ADMIN_PASSWORD. HTTPS via a reverse proxy in front of port 7738.

⁠Docs

• Setup⁠ and Reverse proxy⁠
• What works⁠: relative paths, Vite/CRA builds, SPA routing
• MCP⁠: upload drafts from Claude Code or Codex
• Upgrading⁠

The docs live in docs/⁠ (VitePress). Run them locally with cd docs && npm install && npm run dev.

⁠Release

Push a tag, GitHub Actions builds the image for amd64 and arm64, pushes it to Docker Hub and creates a GitHub release:

git tag v1.0.0 && git push origin v1.0.0

⁠License

MIT⁠