From de639b961382c1a76e77386272af8c6962d83f53 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Mon, 10 Nov 2025 23:39:17 +0100
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20Add=20instructions=20to=20README?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 38 +++++++++++++++++++++++++++++++++++---
 1 file changed, 35 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 1b8a4a3..9b801f7 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,6 @@
 # fastapi-new
 
-Create a new FastAPI project in one command.
-
-✨ Coming soon! ✨
+Create a new FastAPI project in one command. ✨
 
 <a href="https://github.com/fastapi/fastapi-new/actions?query=workflow%3ATest+event%3Apush+branch%3Amain" target="_blank">
     <img src="https://github.com/fastapi/fastapi-new/actions/workflows/test.yml/badge.svg?event=push&branch=main" alt="Test">
@@ -17,6 +15,40 @@ Create a new FastAPI project in one command.
     <img src="https://img.shields.io/pypi/pyversions/fastapi-new.svg?color=%2334D058" alt="Supported Python versions">
 </a>
 
+## How to use
+
+Install [uv](https://docs.astral.sh/uv/getting-started/installation/) following their guide for your system.
+
+Run:
+
+```bash
+uvx fastapi-new awesomeapp
+```
+
+This will create a new project `awesomeapp` with a basic FastAPI app, configured with uv.
+
+Enter the directory:
+
+```bash
+cd awesomeapp
+```
+
+Run the development server:
+
+```bash
+uv run fastapi dev
+```
+
+Open your browser and go to `http://localhost:8000` to see your new FastAPI app running! 🚀
+
+### Existing directory
+
+If you want to create a new FastAPI project in an existing directory, run the command without a project name:
+
+```bash
+uvx fastapi-new
+```
+
 ## License
 
 This project is licensed under the terms of the MIT license.