Files
wild-central/web
Paul Payne 6f85d25362 Add login screen for API token authentication
AuthGate component wraps the app layout:
- On load, checks if saved token is valid by calling a protected endpoint
- If auth not required (dev mode), passes through immediately
- If auth required and no valid token, shows a clean login screen
- Token input with password field, stored in localStorage on success
- Shows guidance: "Find your token in secrets.yaml under api.bearerToken"
- Handles connection errors gracefully (shows app anyway)
2026-07-14 13:21:34 +00:00
..
2026-07-12 21:40:15 +00:00
2026-07-12 21:40:15 +00:00

Wild Central Web App

The Wild Central Web App is a web-based interface for managing Wild Central and its connected services. It allows users to configure networking (DNS, gateway, VPN, firewall, TLS), manage Wild Cloud instances, deploy applications, and monitor resources.

Prerequisites

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

cd ..
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.

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