Wildside is a mobile “serendipity engine” for urban exploration, generating bespoke, narrative-rich walking tours tailored to user interests, time, and location. Leveraging OpenStreetMap, Wikidata, and a custom orienteering-based algorithm, it optimizes for “interestingness” over efficiency. The MVP will be a PWA with a Rust/React stack, self-hosted map/routing services, and a strong data-validation pipeline. The strategy emphasises cost control, security-first AI integration, and clear differentiation from fitness, hiking, and static tour apps.

The workspace manages JavaScript dependencies with pnpm. Enable Corepack so that the pnpm command is available locally:

corepack enable

After enabling Corepack, install the workspace dependencies with a frozen lockfile:

pnpm install --frozen-lockfile

The Bun toolchain remains in use for runtime scripts and formatting tasks.

Infrastructure automation, GitOps workflows, and ephemeral preview environments are maintained in the Nile Valley repository (../../nile-valley). This repository ships the application code, container images, and Helm chart that Nile Valley deploys.

Use the Makefile targets to format, lint, and type-check both the Rust backend and the TypeScript/JavaScript workspaces:

# Format all code (Rust + Biome with write)
make fmt

# Lint all code (Clippy + Biome CI)
make lint

# Type-check TypeScript workspaces
make typecheck

# Check formatting only (no writes)
make check-fmt

Under the hood, Biome runs via Bun (see the Makefile). If you prefer to invoke Biome directly:

# Format JS/TS files in-place
bun x biome format --write

# Lint with CI output for selected packages/paths
bun x biome ci \
  frontend-pwa \
  packages/tokens/src packages/tokens/build \
  packages/types/src

Notes:

• Biome respects .biomeignore and VCS ignore files (we enable vcs.useIgnoreFile), so build artefacts such as any target/ directory are ignored. There is also an explicit override that disables Biome for **/target/**.
• Run pnpm install --frozen-lockfile once in the repo root if dependencies are not already installed.

Ensure documentation and diagrams remain valid:

make markdownlint-docs
make mermaid-lint

The included Helm chart surfaces several values for managing secrets:

Note: Helm client version 3.2.0 or later is required when secretEnvFromKeys is used, as the chart invokes lookup during template rendering.