From bb20d578456bb227b74251dc56263ef9f9e73635 Mon Sep 17 00:00:00 2001
From: Dylan <145150333+dmmqz@users.noreply.github.com>
Date: Wed, 4 Jun 2025 19:18:10 +0000
Subject: [PATCH] uv-init: add page (#16748)

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>
---
 pages/common/uv-init.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 pages/common/uv-init.md

diff --git a/pages/common/uv-init.md b/pages/common/uv-init.md
new file mode 100644
index 0000000000..3f27c5e68f
--- /dev/null
+++ b/pages/common/uv-init.md
@@ -0,0 +1,32 @@
+# uv init
+
+> Create a new Python project.
+> More information: <https://docs.astral.sh/uv/reference/cli/#uv-init>.
+
+- Initialize a project in the current directory:
+
+`uv init`
+
+- Initialize a project with a certain name:
+
+`uv init {{project_name}}`
+
+- Create a project in a given directory:
+
+`uv init --directory {{path/to/directory}} {{project_name}}`
+
+- Create a project for a Python library:
+
+`uv init {{[--lib|--library]}} {{project_name}}`
+
+- Specify the build system:
+
+`uv init --build-backend {{build_backend}} {{project_name}}`
+
+- Only create a `pyproject.toml`:
+
+`uv init --bare {{project_name}}`
+
+- Set the project description:
+
+`uv init --description "{{description}}" {{project_name}}`