Flask integration for Hypergen, with a repo-root examples/ app for local development.
-
Sync the dev environment:
uv sync -
Start the example app:
flask --app examples/app.py run --debug -
Open
http://127.0.0.1:5000/
Project structure and tooling mostly derives from Coppy. See its documentation for context and additional instructions.
This project can be updated from the upstream repo, see Updating a Project.
From zero to hero (passing tests that is):
-
Ensure host dependencies are installed
-
Start docker service dependencies (if applicable):
docker compose up -d -
Sync project virtualenv w/ lock file:
uv sync -
Configure prek:
prek install -
Run tests:
nox
The readable Hypergen browser source lives in src/flask_hypergen/static-src/. The
minified files in src/flask_hypergen/static/ are generated package assets; do not edit
them directly.
Install the pinned Node and Aube toolchain through mise, then build or watch the
runtime:
mise install
mise run js-build
mise run js-watchAube is the project's only JavaScript package installer and script runner. The generated
bundle and source map remain committed so Python package users do not need JavaScript
tooling. Watch mode produces development output directly in the static directory; run
mise run js-build before committing or packaging to apply the production finalization.
The JavaScript tasks are executable scripts in tasks/, so tasks/js-build,
tasks/js-watch, tasks/js-verify, and tasks/js-check can also be called without Mise
when the pinned Node and Aube tools are already on PATH. Prek automatically rebuilds and
checks these assets when related files are committed.
Versions are date based. A version task shows and bumps versions:
# Show current version
mise version show
# Bump version based on date, tag, and push:
mise version bump
# See other options
mise version -- --helpSee docs/coverage-notes.md.