Merge 5892ce34a1 into f492970e62

Move favicon sample to middleware docs.
Fix Markdown document path.
2025-05-04 06:27:23 +00:00 · 2023-09-05 12:17:12 +02:00 · 2023-09-04 18:58:54 +02:00 · 2023-09-04 16:48:40 +02:00
2 changed files with 31 additions and 0 deletions
--- a/docs/advanced/middleware.md
+++ b/docs/advanced/middleware.md
@ -132,6 +132,33 @@ let file = try FileMiddleware(bundle: .main, publicDirectory: "Public")

 Also make sure to use Folder References instead of Groups in Xcode to maintain folder structure in resources after building the application.

+
+The following code from `/Sources/App/routes.swift` can be used with a `favicon.ico` put in `Public/`. The icon of your choosing should be visible on your tab in a browser if you visit the server root resource.
+
+```swift
+import Vapor
+
+func routes(_ app: Application) throws {
+    app.get { req async in
+        Response(
+            status: .ok,
+            headers: ["Content-Type": "text/html"],
+            body:
+                """
+                <html>
+                    <head>
+                        <link rel="shortcut icon" href="/favicon.ico">
+                    </head>
+                    <body>
+                        It works!
+                    </body>
+                </html>
+                """
+        )
+    }
+}
+```
+
 ## CORS Middleware

 Cross-origin resource sharing (CORS) is a mechanism that allows restricted resources on a web page to be requested from another domain outside the domain from which the first resource was served. REST APIs built in Vapor will require a CORS policy in order to safely return requests to modern web browsers.
--- a/docs/getting-started/folder-structure.md
+++ b/docs/getting-started/folder-structure.md
@ -35,6 +35,10 @@ let fileMiddleware = FileMiddleware(
 app.middleware.use(fileMiddleware)
 ```

+If running from Xcode please set the project schema run option working directory.
+See [here](xcode.md#custom-working-directory) for more information.
+
+
 ## Sources

 This folder contains all of the Swift source files for your project.
Author	SHA1	Message	Date
Łukasz Wieczorek	6720e54715	Merge `5892ce34a1` into `f492970e62`	2025-05-04 06:27:23 +00:00
Łukasz Wieczorek	5892ce34a1	Move favicon sample to middleware docs.	2023-09-05 12:17:12 +02:00
Łukasz Wieczorek	02e694e0e3	Fix Markdown document path.	2023-09-04 18:58:54 +02:00
Łukasz Wieczorek	08bfaef4f1	Add more info about favicon.ico.	2023-09-04 16:48:40 +02:00