Skip to content

Project templates

You can control how new projects are created by the new command using Hatch's config file.


name = "..."
email = "..."


headers = true
default = [

The list of licenses should be composed of SPDX identifiers. If multiple licenses are specified, then they will be placed in a LICENSES directory.



This adds a tests directory with environments for testing and linting.

tests = true


This adds a GitHub Actions workflow that runs tests on all platforms using modern versions of Python.

ci = false

src layout

See this blog post.

src-layout = true

Feature flags

Command line interface

The --cli flag adds a CLI backed by Click that can also be invoked with python -m <PKG_NAME>.