Update README, add vscode settings, prettier and install Swashbuckle.AspNetCore.Cli

Author: richard-willis-chevin

.config/dotnet-tools.json

@@ -1,5 +1,12 @@
-{
-  "version": 1,
-  "isRoot": true,
-  "tools": {}
+{
+  "version": 1,
+  "isRoot": true,
+  "tools": {
+    "swashbuckle.aspnetcore.cli": {
+      "version": "6.1.5",
+      "commands": [
+        "swagger"
+      ]
+    }
+  }
 }

.prettierrc.json

@@ -0,0 +1,20 @@
+{
+    "singleQuote": true,
+    "tabWidth": 2,
+    "printWidth": 80,
+    "useTabs": false,
+    "overrides": [
+        {
+            "files": "*.md",
+            "options": {
+                "tabWidth": 2
+            }
+        },
+        {
+            "files": "*.yml",
+            "options": {
+                "tabWidth": 2
+            }
+        }
+    ]
+}

.vscode/extensions.json

@@ -0,0 +1,9 @@
+{
+  "recommendations": [
+    "EditorConfig.EditorConfig",
+    "ms-dotnettools.csharp",
+    "streetsidesoftware.code-spell-checker",
+    "esbenp.prettier-vscode",
+    "ms-azure-devops.azure-pipelines"
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,22 @@
+{
+  "omnisharp.enableRoslynAnalyzers": true,
+  "omnisharp.enableEditorConfigSupport": true,
+  "editor.formatOnSave": true,
+  "[markdown]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[json]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[jsonc]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[yaml]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[xml]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "cSpell.language": "en-GB",
+  "cSpell.words": []
+}

README.md

@@ -1,5 +1,10 @@
 # openapi-typescript-fetch-example
 
+A simple project that demonstrates:
+
+- How generate a typed HTTP client from an OpenAPI definition using the `typescript-fetch` template
+- How to consume the HTTP client
+
 ## Project Overview
 
 ```console
@@ -15,8 +20,15 @@ dotnet new tool-manifest
 dotnet new nugetconfig
 dotnet tool install Swashbuckle.AspNetCore.Cli
 dotnet new sln --name OpenAPITypeScriptFetchExample
-dotnet new webapi -o WebAPI 
+dotnet new webapi -o WebAPI
 dotnet sln add WebAPI
 
 # .editorconfig config manually created from https://docs.microsoft.com/en-us/dotnet/fundamentals/code-analysis/code-style-rule-options
 ```
+
+## TODO
+
+- [ ] Add bearer token auth to .NET project
+- [ ] Setup TS project in `./Client`
+- [ ] Generate HTTP client from OpenAPI spec
+- [ ] Show usage of HTTP client including token renewal in middleware