+
+
diff --git a/docs/src/templates/tutorial001.py b/docs/src/templates/tutorial001.py
new file mode 100644
index 000000000..0f00c3fca
--- /dev/null
+++ b/docs/src/templates/tutorial001.py
@@ -0,0 +1,16 @@
+from fastapi import FastAPI
+from starlette.requests import Request
+from starlette.staticfiles import StaticFiles
+from starlette.templating import Jinja2Templates
+
+app = FastAPI()
+
+app.mount("/static", StaticFiles(directory="static"), name="static")
+
+
+templates = Jinja2Templates(directory="templates")
+
+
+@app.get("/items/{id}")
+async def read_item(request: Request, id: str):
+ return templates.TemplateResponse("item.html", {"request": request, "id": id})
diff --git a/docs/tutorial/static-files.md b/docs/tutorial/static-files.md
new file mode 100644
index 000000000..31955fcb7
--- /dev/null
+++ b/docs/tutorial/static-files.md
@@ -0,0 +1,34 @@
+You can serve static files automatically from a directory using Starlette's Static Files.
+
+## Install `aiofiles`
+
+First you need to install `aiofiles`:
+
+```bash
+pip install aiofiles
+```
+
+## Use `StaticFiles`
+
+* Import `StaticFiles` from Starlette.
+* "Mount" it the same way you would mount a Sub-Application.
+
+```Python hl_lines="2 6"
+{!./src/static_files/tutorial001.py!}
+```
+
+Then you could have a directory `./static/` with some files that will be served directly.
+
+## Details
+
+The first `"/static"` refers to the sub-path this "sub-application" will be "mounted" on. So, any path that starts with `"/static"` will be handled by it.
+
+The `directory="static"` refers to the name of the directory that contains your static files.
+
+The `name="static"` gives it a name that can be used internally by **FastAPI**.
+
+All these parameters can be different than "`static`", adjust them with the needs and specific details of your own application.
+
+## More info
+
+For more details and options check Starlette's docs about Static Files.
diff --git a/docs/tutorial/templates.md b/docs/tutorial/templates.md
new file mode 100644
index 000000000..a909ece48
--- /dev/null
+++ b/docs/tutorial/templates.md
@@ -0,0 +1,67 @@
+You can use any template engine you want with **FastAPI**.
+
+A common election is Jinja2, the same one used by Flask and other tools.
+
+Starlette has utilities to configure it easily that you can use directly in your **FastAPI** application.
+
+## Install dependencies
+
+Install `jinja2`:
+
+```bash
+pip install jinja2
+```
+
+If you need to also serve static files (as in this example), install `aiofiles`:
+
+```bash
+pip install aiofiles
+```
+
+## Using `Jinja2Templates`
+
+* Import `Jinja2Templates` form Starlette.
+* Create a `templates` object that you can re-use later.
+* Declare a `Request` parameter in the *path operation* that will return a template.
+* Use the `templates` you created to render and return a `TemplateResponse`, passing the `request` as one of the key-value pairs in the Jinja2 "context".
+
+```Python hl_lines="4 11 15 16"
+{!./src/templates/tutorial001.py!}
+```
+
+!!! note
+ Notice that you have to pass the `request` as part of the key-value pairs in the context for Jinja2. So, you also have to declare it in your *path operation*.
+
+## Writing templates
+
+Then you can write a template at `templates/item.html` with:
+
+```jinja hl_lines="7"
+{!./src/templates/templates/item.html!}
+```
+
+It will show the `id` taken from the "context" `dict` you passed:
+
+```Python
+{"request": request, "id": id}
+```
+
+## Templates and static files
+
+And you can also use `url_for()` inside of the template, and use it, for example, with the `StaticFiles` you mounted.
+
+```jinja hl_lines="4"
+{!./src/templates/templates/item.html!}
+```
+
+In this example, it would link to a CSS file at `static/styles.css` with:
+
+```CSS hl_lines="4"
+{!./src/templates/static/styles.css!}
+```
+
+And because you are using `StaticFiles`, that CSS file would be served automatically by your **FastAPI** application at the URL `/static/styles.css`.
+
+## More details
+
+For more details, including how to test templates, check Starlette's docs on templates.
\ No newline at end of file
diff --git a/mkdocs.yml b/mkdocs.yml
index 57712ec12..d5b81d543 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -73,6 +73,8 @@ nav:
- Background Tasks: 'tutorial/background-tasks.md'
- Sub Applications - Behind a Proxy: 'tutorial/sub-applications-proxy.md'
- Application Configuration: 'tutorial/application-configuration.md'
+ - Static Files: 'tutorial/static-files.md'
+ - Templates: 'tutorial/templates.md'
- GraphQL: 'tutorial/graphql.md'
- WebSockets: 'tutorial/websockets.md'
- 'Events: startup - shutdown': 'tutorial/events.md'
diff --git a/tests/test_tutorial/test_templates/__init__.py b/tests/test_tutorial/test_templates/__init__.py
new file mode 100644
index 000000000..e69de29bb
diff --git a/tests/test_tutorial/test_templates/test_tutorial001.py b/tests/test_tutorial/test_templates/test_tutorial001.py
new file mode 100644
index 000000000..f53030ae3
--- /dev/null
+++ b/tests/test_tutorial/test_templates/test_tutorial001.py
@@ -0,0 +1,19 @@
+import shutil
+
+from starlette.testclient import TestClient
+
+
+def test_main():
+ shutil.copytree("./docs/src/templates/templates/", "./templates")
+ shutil.copytree("./docs/src/templates/static/", "./static")
+ from templates.tutorial001 import app
+
+ client = TestClient(app)
+ response = client.get("/items/foo")
+ assert response.status_code == 200
+ assert b"