Files
wild-central/web
Paul Payne 518cdbbce5 Add DNS filtering with dnsmasq address=/ directives for wildcard blocking
Adds Pi-hole-style DNS filtering using dnsmasq's native address=/ directives,
which block domains and all subdomains. Users subscribe to blocklists by URL
or upload files, with suggested lists from Hagezi, Steven Black, and OISD.
Background runner refreshes lists on a configurable interval (default 24h).
2026-07-12 12:44:19 +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.