FastHTML CLI

Fastest way to scaffold FastHTML apps!

Usage

To create a new FastHTML application, use the fh-init command. Make sure uv is installed before running uvx:

uvx fh-init [OPTIONS] NAME

Arguments

• NAME: The name of your FastHTML application (required).

Options

• --template, -p TEXT: The name of the FastHTML template to use (default: base).
• --reload, -r: Enable live reload.
• --pico, -p: Enable Pico CSS (default: True).
• --uv / --no-uv: Use uv to manage project dependencies (default: uv).
• --tailwind, -t: Enable Tailwind CSS.
• --install-completion: Install completion for the current shell.
• --show-completion: Show completion for the current shell.
• --help: Show the help message and exit.

Example

uvx fh-init my_awesome_app --reload --tailwind

This command will create a new FastHTML application named my_awesome_app with live reload and Tailwind CSS enabled.

Then to run the FastHTML app:

cd my_awesome_app
uv run main.py