otter/.devcontainer/README.md

This devcontainer provides a development environment for the Otter Tauri app.

What it includes

• Node 24 (from base image)
• pnpm (via Corepack)
• Rust (installed with rustup, stable toolchain)
• @tauri-apps/cli (global npm install)
• just (installed via cargo install just)
• Linux libraries required by Tauri: libwebkit2gtk, libssl, GTK, appindicator, etc.

How to use

1. Open this repository in VS Code.
2. When prompted, reopen in container. If not prompted: Command Palette → Remote-Containers: Reopen in Container.
3. After the container builds, the postCreateCommand will run: it enables Corepack, activates pnpm, runs pnpm install and cargo fetch.

Notes

• If you need additional system libraries for your distribution, edit Dockerfile.
• Forwarded ports:
  • 5173 (Vite dev server)
  • 5900 (VNC server - direct VNC connection)
  • 6080 (noVNC web interface - access via browser)
• just is available in the container; run just to execute repository tasks.

VNC / noVNC (Remote Desktop)

• This devcontainer includes a headless X11 environment with XFCE4 desktop.
• To start VNC: Run just start-vnc in the terminal
• To stop VNC: Run just stop-vnc
• Access the desktop via:
  1. Browser (recommended): http://localhost:6080/vnc.html
  2. VNC client: Connect to localhost:5900 with password devpass
• Default VNC password: devpass (set via VNC_PASSWORD environment variable)
• If you see "Port 6080 already in use", the noVNC service is already running.