Reference

Settings

Exact reference for HYPER_FRONTEND_DIR, HYPER_VITE_OUTPUT_DIR, HYPER_VITE_DEV_SERVER_URL, and HYPER_DEV.

This page focuses on the practical details. Use the quick links below to move to the previous, next, or related docs.

HYPER_FRONTEND_DIR

Type:

  • Path | str

Purpose:

  • tells HyperDjango where your hyper/ directory lives

Expected contents usually include:

  • routes/
  • layouts/
  • templates/
  • shared frontend files

Example:

HYPER_FRONTEND_DIR = BASE_DIR / "hyper"

HYPER_VITE_OUTPUT_DIR

Type:

  • Path | str

Purpose:

  • tells HyperDjango where Vite writes built assets

Example:

HYPER_VITE_OUTPUT_DIR = BASE_DIR / "dist"

HYPER_VITE_DEV_SERVER_URL

Type:

  • str

Purpose:

  • tells HyperDjango which Vite dev server URL to inject during development

Example:

HYPER_VITE_DEV_SERVER_URL = "http://localhost:5173/"

HYPER_DEV

Type:

  • bool

Purpose:

  • switches asset loading between development mode and manifest-based production mode

Typical usage:

HYPER_DEV = DEBUG

Behavior:

  • True: use Vite dev server URLs and inject @vite/client
  • False: resolve assets from the built Vite manifest in HYPER_VITE_OUTPUT_DIR
Page navigation