Files
wild-central/web
Paul Payne 4cafe68064 fix: Use relative API URLs for browser compatibility
VITE_API_BASE_URL must be empty (relative URLs) so API calls go to
the same origin the browser loaded the page from. Setting it to
http://localhost:15055 breaks when accessing via LAN hostname since
the browser resolves localhost to its own machine, not the server.

The Go backend handles /api/v1/* routes before the Vite proxy
catch-all, so relative URLs work correctly in dev mode.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-07-09 04:39:08 +00:00
..

Wild Cloud Web App

The Wild Cloud Web App is a web-based interface for managing Wild Cloud instances. It allows users to view and control their Wild Cloud environments, including deploying applications, monitoring resources, and configuring settings.

Prerequisites

Before starting the web app, ensure the Wild Central API is running:

cd ../api
make dev

The API should be accessible at http://localhost:5055.

Development

Initial Setup

  1. Copy the example environment file:
cp .env.example .env
  1. Update .env if your API is running on a different host/port:
VITE_API_BASE_URL=http://localhost:5055
  1. Install dependencies:
pnpm install
  1. Start the development server:
pnpm run dev

The web app will be available at http://localhost:5173 (or the next available port).

Other Scripts

pnpm run build # Build the project
pnpm run lint # Lint the codebase
pnpm run preview # Preview the production build
pnpm run type-check # Type check the codebase
pnpm run test # Run tests
pnpm run test:ui # Run tests with UI
pnpm run test:coverage # Run tests with coverage report
pnpm run build:css # Build the CSS using Tailwind
pnpm run check # Run lint, type-check, and tests

Environment Variables

VITE_API_BASE_URL

The base URL of the Wild Central API server.

  • Default: http://localhost:5055
  • Example: http://192.168.1.100:5055
  • Usage: Set in .env file (see .env.example for template)

This variable is used by the API client to connect to the Wild Central API. If not set, it defaults to http://localhost:5055.