From 56dea1b1047fb6e41bb8f43a45262992b07e4382 Mon Sep 17 00:00:00 2001
From: Romain Lenzotti <rom.lenzotti@gmail.com>
Date: Sat, 30 Nov 2024 22:38:45 +0100
Subject: [PATCH] docs: update home content

---
 docs/.gitignore                               |   2 +-
 docs/.vitepress/config.mts                    |  25 ++-
 .../{api.ts => scripts/api-summary.js}        |   7 +-
 docs/.vitepress/theme/index.ts                |  12 +-
 docs/.vitepress/theme/style.css               |   4 +
 docs/api.md                                   |  12 +-
 docs/docs/authentication.md                   |  12 +-
 docs/docs/cache.md                            |  12 +-
 docs/docs/command.md                          |  12 +-
 docs/docs/configuration/index.md              |  12 +-
 docs/docs/controllers.md                      |  12 +-
 docs/docs/exceptions.md                       |  12 +-
 docs/docs/json-mapper.md                      |  12 +-
 docs/docs/logger.md                           |  12 +-
 docs/docs/model.md                            |  12 +-
 docs/docs/platform-serverless-http.md         |  12 +-
 docs/docs/platform-serverless.md              |  12 +-
 docs/docs/providers-lazy-loading.md           |  12 +-
 docs/docs/providers.md                        |  12 +-
 docs/docs/response-filter.md                  |  12 +-
 docs/docs/serve-files.md                      |  12 +-
 docs/docs/templating.md                       |  12 +-
 docs/docs/upload-files.md                     |  12 +-
 docs/getting-started.md                       | 147 ++++++++++++++++++
 docs/index.md                                 |  53 +++----
 .../create-your-first-controller.md           |  12 +-
 docs/introduction/getting-started.md          |   8 +-
 docs/introduction/migrate-from-v7.md          |  12 +-
 docs/more/team.md                             |   4 +-
 docs/package.json                             |   9 +-
 docs/plugins/index.md                         |  12 +-
 docs/yarn.lock                                |  10 +-
 readme.md                                     |  11 +-
 team.json                                     |   4 +-
 34 files changed, 374 insertions(+), 174 deletions(-)
 rename docs/.vitepress/{api.ts => scripts/api-summary.js} (85%)
 create mode 100644 docs/getting-started.md

diff --git a/docs/.gitignore b/docs/.gitignore
index 7df88fdf9e8..072eb4cac60 100644
--- a/docs/.gitignore
+++ b/docs/.gitignore
@@ -3,6 +3,7 @@ api
 .vitepress/cache
 .vitepress/dist
 public/api.json
+public/reference-sidebar.json
 
 # Yarn
 .pnp.*
@@ -13,4 +14,3 @@ public/api.json
 !.yarn/cache
 !.yarn/sdks
 !.yarn/versions
-
diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
index 867340ca81a..eb22b5019ae 100644
--- a/docs/.vitepress/config.mts
+++ b/docs/.vitepress/config.mts
@@ -1,14 +1,15 @@
 import {apiAnchor} from "@tsed/vitepress-theme/markdown/api-anchor/api-anchor.js";
 import {defineConfig} from "vitepress";
 import pkg from "../../package.json";
-import {getSidebar} from "./api.js";
+import referenceSidebar from "../public/reference-sidebar.json";
+import team from "../team.json";
 
 
 // https://vitepress.dev/reference/site-config
 export default defineConfig({
-  title: "Ts.ED",
+  title: "Ts.ED a modern Node.js/Bun.js framework built with TypeScript",
   lastUpdated: true,
-
+  description: "Ts.ED offers a flexible and easy-to-learn structure designed to enhance the developer experience. It provides decorators, guidelines, and supports Node.js, Bun.js, Express, Koa, CLI, and serverless architectures (e.g., AWS).",
   sitemap: {
     hostname: "https://tsed.io"
   },
@@ -26,13 +27,26 @@ export default defineConfig({
     ["meta", {property: "og:title", content: "Ts.ED - A Node.js and TypeScript Framework on top of Express/Koa.js."}],
     ["meta", {property: "og:site_name", content: "Ts.ED"}],
     ["meta", {property: "og:image", content: "https://tsed.dev/tsed-og.png"}],
-    ["meta", {property: "og:url", content: "https://tsed.dev/"}]
+    ["meta", {property: "og:url", content: "https://tsed.dev/"}],
+    [
+      "script",
+      {async: "", src: "https://www.googletagmanager.com/gtag/js?id=G-3M3Q4QME6H&cx=c&_slc=1"}
+    ],
+    [
+      'script',
+      {},
+      `window.dataLayer = window.dataLayer || [];
+      function gtag(){dataLayer.push(arguments);}
+      gtag('js', new Date());
+      gtag('config', 'G-3M3Q4QME6H');`
+    ]
   ],
 
   themeConfig: {
     logo: "/tsed.svg",
     siteTitle: false,
     apiUrl: "/api.json",
+    team,
     apiRedirectUrl: "",
     repo: "tsedio/tsed",
     githubProxyUrl: "https://api.tsed.io/rest/github/tsedio/tsed",
@@ -560,8 +574,7 @@ export default defineConfig({
           ].sort((a, b) => a.text.localeCompare(b.text))
         }
       ],
-
-      "/api/": getSidebar()
+      "/api/": referenceSidebar
     },
     socialLinks: [
       {icon: "github", link: "https://github.com/tsedio/tsed"},
diff --git a/docs/.vitepress/api.ts b/docs/.vitepress/scripts/api-summary.js
similarity index 85%
rename from docs/.vitepress/api.ts
rename to docs/.vitepress/scripts/api-summary.js
index 23699c5b236..0a198bbe116 100644
--- a/docs/.vitepress/api.ts
+++ b/docs/.vitepress/scripts/api-summary.js
@@ -1,5 +1,6 @@
 import {mapApiReferences} from "@tsed/vitepress-theme/composables/api/mappers/mapApiReferences.js";
-import api from "../public/api.json";
+import api from "../../public/api.json" with {  type: "json" };
+import {writeFile} from "node:fs/promises";
 
 const IS_CORES = /core|@tsed\/di|hooks|schema$|\/exceptions$|engines|json-mapper|open-spec/;
 const IS_PLATFORM = /platform/;
@@ -31,7 +32,7 @@ export function getSidebar() {
         platformModules.push(item);
       } else if (IS_ORM.test(module)) {
         ormModules.push(item);
-      }else {
+      } else {
         thirdParties.push(item);
       }
     });
@@ -56,3 +57,5 @@ export function getSidebar() {
   ];
 }
 
+
+await writeFile(import.meta.dirname + "/../../public/reference-sidebar.json", JSON.stringify(getSidebar(), null, 2));
diff --git a/docs/.vitepress/theme/index.ts b/docs/.vitepress/theme/index.ts
index c7f17922b83..ec02c623bb2 100644
--- a/docs/.vitepress/theme/index.ts
+++ b/docs/.vitepress/theme/index.ts
@@ -1,15 +1,15 @@
 // https://vitepress.dev/guide/custom-theme
 import {DefaultTheme} from "@tsed/vitepress-theme";
-import type {Theme} from "vitepress";
-import {h} from "vue";
 import HomeBanner from "@tsed/vitepress-theme/organisms/home/HomeBanner.vue";
-import HomePartners from "@tsed/vitepress-theme/organisms/home/HomePartners.vue";
 import HomeBody from "@tsed/vitepress-theme/organisms/home/HomeBody.vue";
 import HomeTabsTerminal from "@tsed/vitepress-theme/organisms/home/terminal/HomeTabsTerminal.vue";
+import HomeTabTerminalBun from "@tsed/vitepress-theme/organisms/home/terminal/HomeTabTerminalBun.vue";
 import HomeTabTerminalNpm from "@tsed/vitepress-theme/organisms/home/terminal/HomeTabTerminalNpm.vue";
-import HomeTabTerminalYarn from "@tsed/vitepress-theme/organisms/home/terminal/HomeTabTerminalYarn.vue";
 import HomeTabTerminalPnpm from "@tsed/vitepress-theme/organisms/home/terminal/HomeTabTerminalPnpm.vue";
-import HomeTabTerminalBun from "@tsed/vitepress-theme/organisms/home/terminal/HomeTabTerminalBun.vue";
+import HomeTabTerminalYarn from "@tsed/vitepress-theme/organisms/home/terminal/HomeTabTerminalYarn.vue";
+import HomeBeforeFeatures from "@tsed/vitepress-theme/organisms/home/HomeBeforeFeatures.vue";
+import type {Theme} from "vitepress";
+import {h} from "vue";
 import "./style.css";
 
 export default {
@@ -26,7 +26,7 @@ export default {
               bun: () => h(HomeTabTerminalBun)
             })
         }),
-      "home-features-before": () => h(HomePartners),
+      "home-features-before": () => h(HomeBeforeFeatures),
       "home-features-after": () => h(HomeBody)
     });
   }
diff --git a/docs/.vitepress/theme/style.css b/docs/.vitepress/theme/style.css
index f00ef8b1960..fd8b9049a5f 100644
--- a/docs/.vitepress/theme/style.css
+++ b/docs/.vitepress/theme/style.css
@@ -3,3 +3,7 @@
   padding-right: 0;
 }
 
+
+.box a {
+  color: var(--vp-c-brand-1);
+}
diff --git a/docs/api.md b/docs/api.md
index 6acd11e620b..aad5a15c0c9 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -1,11 +1,13 @@
 ---
 layout: page
 sidebar: false
-meta:
-  - name: description
-    content: Api Reference of Ts.ED. Use decorator to build your model and map data.
-  - name: keywords
-    content: api reference model decorators ts.ed express typescript node.js javascript jsonschema json mapper serialization deserialization
+head:
+  - - meta
+    - name: description
+      content: Api Reference of Ts.ED. Use decorator to build your model and map data.
+  - - meta
+    - name: keywords
+      content: api reference model decorators ts.ed express typescript node.js javascript jsonschema json mapper serialization deserialization
 ---
 
 <script setup>
diff --git a/docs/docs/authentication.md b/docs/docs/authentication.md
index bf65e7a50b1..9e9e176b115 100644
--- a/docs/docs/authentication.md
+++ b/docs/docs/authentication.md
@@ -1,9 +1,11 @@
 ---
-meta:
-  - name: description
-    content: Authentication configuration
-  - name: keywords
-    content: ts.ed express typescript auth node.js javascript decorators
+head:
+  - - meta
+    - name: description
+      content: Authentication configuration
+  - - meta
+    - name: keywords
+      content: ts.ed express typescript auth node.js javascript decorators
 ---
 
 # Authentication
diff --git a/docs/docs/cache.md b/docs/docs/cache.md
index abbdad9b0e4..148d17e4c34 100644
--- a/docs/docs/cache.md
+++ b/docs/docs/cache.md
@@ -1,9 +1,11 @@
 ---
-meta:
-  - name: description
-    content: Documentation over Cache management provided by Ts.ED framework. Use decorator to cache Response or returned value by a service.
-  - name: keywords
-    content: cache ts.ed express koa typescript node.js javascript decorators cache-manager class controller service
+head:
+  - - meta
+    - name: description
+      content: Documentation over Cache management provided by Ts.ED framework. Use decorator to cache Response or returned value by a service.
+  - - meta
+    - name: keywords
+      content: cache ts.ed express koa typescript node.js javascript decorators cache-manager class controller service
 ---
 
 # Cache
diff --git a/docs/docs/command.md b/docs/docs/command.md
index eec054c602d..0dfc9143dd8 100644
--- a/docs/docs/command.md
+++ b/docs/docs/command.md
@@ -1,9 +1,11 @@
 ---
-meta:
-  - name: description
-    content: Documentation over Command provided by Ts.ED framework. Use commands to build your CLI API.
-  - name: keywords
-    content: command ts.ed commander inquirer typescript node.js javascript decorators jsonschema class models
+head:
+  - - meta
+    - name: description
+      content: Documentation over Command provided by Ts.ED framework. Use commands to build your CLI API.
+  - - meta
+    - name: keywords
+      content: command ts.ed commander inquirer typescript node.js javascript decorators jsonschema class models
 ---
 
 # Command
diff --git a/docs/docs/configuration/index.md b/docs/docs/configuration/index.md
index 36dfdb35620..c4dab3563a3 100644
--- a/docs/docs/configuration/index.md
+++ b/docs/docs/configuration/index.md
@@ -1,9 +1,11 @@
 ---
-meta:
-  - name: description
-    content: Documentation over the server configuration. Ts.ED is built on top of Express/Koa and use TypeScript language.
-  - name: keywords
-    content: configuration ts.ed express typescript node.js javascript decorators mvc class models
+head:
+  - - meta
+    - name: description
+      content: Documentation over the server configuration. Ts.ED is built on top of Express/Koa and use TypeScript language.
+  - - meta
+    - name: keywords
+      content: configuration ts.ed express typescript node.js javascript decorators mvc class models
 ---
 
 # Configuration
diff --git a/docs/docs/controllers.md b/docs/docs/controllers.md
index cae62c9e2e5..eb0ea984f36 100644
--- a/docs/docs/controllers.md
+++ b/docs/docs/controllers.md
@@ -1,9 +1,11 @@
 ---
-meta:
-  - name: description
-    content: Documentation over Controllers provided by Ts.ED framework. Use controllers to build your REST API.
-  - name: keywords
-    content: controllers ts.ed express typescript node.js javascript decorators jsonschema class models
+head:
+  - - meta
+    - name: description
+      content: Documentation over Controllers provided by Ts.ED framework. Use controllers to build your REST API.
+  - - meta
+    - name: keywords
+      content: controllers ts.ed express typescript node.js javascript decorators jsonschema class models
 ---
 
 # Controllers
diff --git a/docs/docs/exceptions.md b/docs/docs/exceptions.md
index 39b1aaa89ab..ce8d16a274b 100644
--- a/docs/docs/exceptions.md
+++ b/docs/docs/exceptions.md
@@ -1,9 +1,11 @@
 ---
-meta:
-  - name: description
-    content: Documentation over Http Exceptions provided by Ts.ED framework. Use class to throw a standard Http error.
-  - name: keywords
-    content: http exceptions ts.ed express typescript node.js javascript decorators jsonschema class models
+head:
+  - - meta
+    - name: description
+      content: Documentation over Http Exceptions provided by Ts.ED framework. Use class to throw a standard Http error.
+  - - meta
+    - name: keywords
+      content: http exceptions ts.ed express typescript node.js javascript decorators jsonschema class models
 ---
 
 # Exceptions
diff --git a/docs/docs/json-mapper.md b/docs/docs/json-mapper.md
index 729a0e50d83..22856e756c3 100644
--- a/docs/docs/json-mapper.md
+++ b/docs/docs/json-mapper.md
@@ -1,9 +1,11 @@
 ---
-meta:
-  - name: description
-    content: Documentation over JsonMapper and decorators provided by Ts.ED framework. Use decorator to build your model and map data.
-  - name: keywords
-    content: class model decorators ts.ed express typescript node.js javascript jsonschema json mapper serialization deserialization
+head:
+  - - meta
+    - name: description
+      content: Documentation over JsonMapper and decorators provided by Ts.ED framework. Use decorator to build your model and map data.
+  - - meta
+    - name: keywords
+      content: class model decorators ts.ed express typescript node.js javascript jsonschema json mapper serialization deserialization
 ---
 
 # JsonMapper
diff --git a/docs/docs/logger.md b/docs/docs/logger.md
index bdee830854e..39547a380f1 100644
--- a/docs/docs/logger.md
+++ b/docs/docs/logger.md
@@ -1,9 +1,11 @@
 ---
-meta:
-  - name: description
-    content: Documentation over Logger by Ts.ED framework.
-  - name: keywords
-    content: logger decorators ts.ed express.js koa.js typescript node.js javascript
+head:
+  - - meta
+    - name: description
+      content: Documentation over Logger by Ts.ED framework.
+  - - meta
+    - name: keywords
+      content: logger decorators ts.ed express.js koa.js typescript node.js javascript
 ---
 
 # Logger
diff --git a/docs/docs/model.md b/docs/docs/model.md
index 1ac7b61fea0..525be181bd6 100644
--- a/docs/docs/model.md
+++ b/docs/docs/model.md
@@ -1,9 +1,11 @@
 ---
-meta:
-  - name: description
-    content: Documentation over Models and decorators provided by Ts.ED framework. Use decorator to build your model and JsonSchema.
-  - name: keywords
-    content: class model decorators ts.ed express typescript node.js javascript jsonschema
+head:
+  - - meta
+    - name: description
+      content: Documentation over Models and decorators provided by Ts.ED framework. Use decorator to build your model and JsonSchema.
+  - - meta
+    - name: keywords
+      content: class model decorators ts.ed express typescript node.js javascript jsonschema
 ---
 
 # Model
diff --git a/docs/docs/platform-serverless-http.md b/docs/docs/platform-serverless-http.md
index 0d9dffd503a..afb8b7b5919 100644
--- a/docs/docs/platform-serverless-http.md
+++ b/docs/docs/platform-serverless-http.md
@@ -1,9 +1,11 @@
 ---
-meta:
-  - name: description
-    content: Guide to deploy your Ts.ED application on AWS.
-  - name: keywords
-    content: ts.ed express typescript aws node.js javascript decorators
+head:
+  - - meta
+    - name: description
+      content: Guide to deploy your Ts.ED application on AWS.
+  - - meta
+    - name: keywords
+      content: ts.ed express typescript aws node.js javascript decorators
 ---
 
 # Serverless HTTP
diff --git a/docs/docs/platform-serverless.md b/docs/docs/platform-serverless.md
index ce959eab66b..d6ef094153f 100644
--- a/docs/docs/platform-serverless.md
+++ b/docs/docs/platform-serverless.md
@@ -1,9 +1,11 @@
 ---
-meta:
-  - name: description
-    content: Guide to deploy your Ts.ED application on AWS.
-  - name: keywords
-    content: ts.ed express typescript serverless aws function node.js javascript decorators
+head:
+  - - meta
+    - name: description
+      content: Guide to deploy your Ts.ED application on AWS.
+  - - meta
+    - name: keywords
+      content: ts.ed express typescript serverless aws function node.js javascript decorators
 projects:
   - title: Terraform project
     href: https://github.com/tsedio/tsed-aws-lambda
diff --git a/docs/docs/providers-lazy-loading.md b/docs/docs/providers-lazy-loading.md
index 98b7f65ec01..b84931937d3 100644
--- a/docs/docs/providers-lazy-loading.md
+++ b/docs/docs/providers-lazy-loading.md
@@ -1,9 +1,11 @@
 ---
-meta:
-  - name: description
-    content: Documentation over Providers / DI provided by Ts.ED framework. Use providers to build your backend services.
-  - name: keywords
-    content: providers di ioc ts.ed express typescript node.js javascript decorators jsonschema class models
+head:
+  - - meta
+    - name: description
+      content: Documentation over Providers / DI provided by Ts.ED framework. Use providers to build your backend services.
+  - - meta
+    - name: keywords
+      content: providers di ioc ts.ed express typescript node.js javascript decorators jsonschema class models
 ---
 
 # Lazy-loading provider
diff --git a/docs/docs/providers.md b/docs/docs/providers.md
index b6d13e75dd9..0aaaaab9d99 100644
--- a/docs/docs/providers.md
+++ b/docs/docs/providers.md
@@ -1,9 +1,11 @@
 ---
-meta:
-  - name: description
-    content: Documentation over Providers / DI provided by Ts.ED framework. Use providers to build your backend services.
-  - name: keywords
-    content: providers di ioc ts.ed express typescript node.js javascript decorators jsonschema class models
+head:
+  - - meta
+    - name: description
+      content: Documentation over Providers / DI provided by Ts.ED framework. Use providers to build your backend services.
+  - - meta
+    - name: keywords
+      content: providers di ioc ts.ed express typescript node.js javascript decorators jsonschema class models
 ---
 
 # DI & Providers
diff --git a/docs/docs/response-filter.md b/docs/docs/response-filter.md
index 49c93ec9afd..292ba5cc986 100644
--- a/docs/docs/response-filter.md
+++ b/docs/docs/response-filter.md
@@ -1,9 +1,11 @@
 ---
-meta:
-  - name: description
-    content: Documentation over response filters provided by Ts.ED framework. Use class to transform data before returning it to your consumer.
-  - name: keywords
-    content: response filter ts.ed express typescript node.js javascript decorators jsonschema class models
+head:
+  - - meta
+    - name: description
+      content: Documentation over response filters provided by Ts.ED framework. Use class to transform data before returning it to your consumer.
+  - - meta
+    - name: keywords
+      content: response filter ts.ed express typescript node.js javascript decorators jsonschema class models
 ---
 
 # Response Filter
diff --git a/docs/docs/serve-files.md b/docs/docs/serve-files.md
index 7089fa82009..22d2e987940 100644
--- a/docs/docs/serve-files.md
+++ b/docs/docs/serve-files.md
@@ -1,9 +1,11 @@
 ---
-meta:
-  - name: description
-    content: Serve statics files with Ts.ED by using decorators. Ts.ED is built on top of Express/Koa and use TypeScript language.
-  - name: keywords
-    content: ts.ed express typescript statics files node.js javascript decorators
+head:
+  - - meta
+    - name: description
+      content: Serve statics files with Ts.ED by using decorators. Ts.ED is built on top of Express/Koa and use TypeScript language.
+  - - meta
+    - name: keywords
+      content: ts.ed express typescript statics files node.js javascript decorators
 ---
 
 # Serve files
diff --git a/docs/docs/templating.md b/docs/docs/templating.md
index 7139e4da96c..34bb49e3110 100644
--- a/docs/docs/templating.md
+++ b/docs/docs/templating.md
@@ -1,9 +1,11 @@
 ---
-meta:
-  - name: description
-    content: Use template engine with Ts.ED by using decorators. Ts.ED is built on top of Express/Koa and uses TypeScript language.
-  - name: keywords
-    content: template engine tsed-engines ts.ed express typescript node.js javascript decorators
+head:
+  - - meta
+    - name: description
+      content: Use template engine with Ts.ED by using decorators. Ts.ED is built on top of Express/Koa and uses TypeScript language.
+  - - meta
+    - name: keywords
+      content: template engine tsed-engines ts.ed express typescript node.js javascript decorators
 ---
 
 # Templating
diff --git a/docs/docs/upload-files.md b/docs/docs/upload-files.md
index a4745138af3..c31426d34e2 100644
--- a/docs/docs/upload-files.md
+++ b/docs/docs/upload-files.md
@@ -1,9 +1,11 @@
 ---
-meta:
-  - name: description
-    content: Upload files with Ts.ED by using decorators. Ts.ED is built on top of Express/Koa and use TypeScript language.
-  - name: keywords
-    content: upload files ts.ed express typescript multer node.js javascript decorators
+head:
+  - - meta
+    - name: description
+      content: Upload files with Ts.ED by using decorators. Ts.ED is built on top of Express/Koa and use TypeScript language.
+  - - meta
+    - name: keywords
+      content: upload files ts.ed express typescript multer node.js javascript decorators
 projects:
   - title: Kit Multer
     href: https://github.com/tsedio/tsed-example-multer
diff --git a/docs/getting-started.md b/docs/getting-started.md
new file mode 100644
index 00000000000..9db526937dc
--- /dev/null
+++ b/docs/getting-started.md
@@ -0,0 +1,147 @@
+---
+projects:
+  - title: Kit basic
+    href: https://github.com/tsedio/tsed-getting-started
+    src: /tsed.png
+  - title: Kit production-ready template
+    href: https://github.com/borjapazr/express-typescript-skeleton
+    src: /tsed.png
+  - title: Kit React
+    href: https://github.com/tsedio/tsed-example-react
+    src: /react.png
+  - title: Kit Vue.js
+    href: https://github.com/tsedio/tsed-example-vuejs
+    src: /vuejs.png
+  - title: Kit Prisma
+    href: https://github.com/tsedio/tsed-example-prisma
+    src: /prisma-2.png
+  - title: Kit TypeORM
+    href: https://github.com/tsedio/tsed-example-typeorm
+    src: /typeorm.png
+  - title: Kit Mongoose
+    href: https://github.com/tsedio/tsed-example-mongoose
+    src: /mongoose.png
+  - title: Kit Socket.io
+    href: https://github.com/tsedio/tsed-example-socketio
+    src: /socketio.png
+  - title: Kit Passport.js
+    href: https://github.com/tsedio/tsed-example-passportjs
+    src: /passportjs.png
+  - title: Kit AWS
+    href: https://github.com/tsedio/tsed-example-aws
+    src: /aws.png
+  - title: Kit Azure AD
+    href: https://github.com/tsedio/tsed-example-passport-azure-ad
+    src: /azure.png
+---
+
+# Getting Started
+
+## Try it online
+
+You can try Ts.ED directly in your browser on [CodeSandbox](https://codesandbox.io/p/devbox/tsed-mongoose-example-omkbm).
+
+## Installation
+
+To get started, you can either scaffold the project with the Ts.ED CLI, or clone a starter project.
+
+To scaffold the project with the CLI, run the following commands. This will create a new project directory,
+and populate the directory with the initial core Ts.ED files and supporting modules, creating a conventional base structure for your project.
+Creating a new project with the CLI is recommended for first-time users.
+
+::: code-group
+
+```sh [npm]
+npx -p @tsed/cli tsed init .
+```
+
+```sh [yarn]
+yarn set version berry
+yarn dlx -p @tsed/cli tsed init .
+```
+
+```sh [pnpm]
+pnpx -p @tsed/cli tsed init .
+```
+
+```sh [bun]
+bnx -p @tsed/cli tsed init .
+```
+
+:::
+
+You will be greeted with a few simple questions:
+
+<<< @/introduction/snippets/init.ansi
+
+::: tip
+By default, it's recommended to select the following options: Express, Ts.ED (convention), Swagger, Jest and Eslint + prettier.
+:::
+
+When all options are selected, the CLI will generate all files.
+When it's done, run one of this command:
+
+::: code-group
+
+```sh [npm]
+npm start
+```
+
+```sh [yarn]
+yarn start
+```
+
+```sh [pnpm]
+pnpm start
+```
+
+```sh [bun]
+bun start
+```
+
+:::
+
+<<< @/introduction/snippets/start.ansi
+
+## Update dependencies
+
+::: warning
+If you have to upgrade Ts.ED dependencies, keep in mind this point:
+
+It's really important to keep the same version for all `@tsed/*` (excepted @tsed/logger) packages.
+To prevent errors, fix the version for each Ts.ED packages:
+
+```json
+{
+  "dependencies": {
+    "@tsed/common": "7.53.0",
+    "@tsed/di": "7.53.0",
+    "@tsed/core": "7.53.0",
+    "@tsed/exceptions": "7.53.0",
+    "@tsed/platform-express": "7.53.0",
+    "@tsed/swagger": "7.53.0"
+  }
+}
+```
+
+:::
+
+## Project examples
+
+Alternatively, you can check out one of these projects:
+
+<Projects type="projects" />
+
+If none of previous solutions are satisfying maybe you are in these cases:
+
+- [I want to migrate my application from Ts.ED v6](/introduction/migrate-from-v6)
+- [I want to migrate my application from Express.js](/introduction/migrate-from-express)
+
+## What's next?
+
+Now you can follow one of these links to develop your new application:
+
+- [Create your first controller](/introduction/create-your-first-controller.md)
+- [Change server configuration](/docs/configuration/index.md)
+- [Load configuration from files](/docs/configuration/index.md)
+- [What is the Platform API](/docs/platform-api.md)
diff --git a/docs/index.md b/docs/index.md
index d30325ef1b1..16630eb557c 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,11 +1,18 @@
 ---
 # https://vitepress.dev/reference/default-theme-home-page
 layout: home
+head:
+  - - meta
+    - name: description
+      content: Ts.ED is a modern Node.js framework built with TypeScript. It offers a flexible structure with a fast learning curve, specifically designed to improve the developer experience. Ts.ED provides numerous decorators and guidelines to make your code more readable and less error-prone. It supports various platforms and tools, including Node.js/Bun.js, Express.js/Koa.js, CLI, and serverless architectures (e.g., AWS).
+  - - meta
+    - name: keywords
+      content: ts.ed framework express koa aws cli di rest graphql typescript node.js bun.js javascript native ESM decorators jsonschema class models providers pipes middlewares testing developer
 
 hero:
   name: "Ts.ED"
-  text: "A TypeScript Framework on top of Express/Koa.js."
-  tagline: "Build your awesome server-side application"
+  text: "A modern framework written in TypeScript"
+  tagline: "A flexible framework with a fast learning curve, designed to enhance the developer experience"
   actions:
     - theme: brand
       text: What is Ts.ED?
@@ -17,25 +24,29 @@ hero:
       text: Become sponsor
       link: https://github.com/sponsors/Romakita
 
+testimonial:
+  title: "What is Ts.ED?"
+  description: Ts.ED offers a flexible structure with a fast learning curve, specifically designed to improve the developer experience. It provides numerous decorators and guidelines to make your code more readable and less error-prone. Ts.ED supports various platforms and tools, including Node.js/Bun.js, Express.js/Koa.js, CLI, and serverless architectures (e.g., AWS).
+
 features:
-  - title: Rest API
+  - title: Multi-platform
     icon: <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-server"><rect width="20" height="8" x="2" y="2" rx="2" ry="2"/><rect width="20" height="8" x="2" y="14" rx="2" ry="2"/><line x1="6" x2="6.01" y1="6" y2="6"/><line x1="6" x2="6.01" y1="18" y2="18"/></svg>
-    details: Create your Rest API easily and create different version paths of your API compliant with <a class="home-link" href="/tutorials/swagger.html">OpenSpec</a> and <a class="home-link" href="/docs/model.html">JsonSchema</a>.
+    details: Easily build your server-side application using Express.js, Koa.js, CLI, or serverless platforms (e.g., AWS). It supports both Node.js and Bun.js runtimes. Learn more <a class="home-link" capabilities" href="/introduction/capabilities.html">about Ts.ED capabilities</a>.
   - title: Configuration
     icon: <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-bolt"><path d="M21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16z"/><circle cx="12" cy="12" r="4"/></svg>
-    details: Don't waste your time with configuration, the server is preconfigured to start quickly! Try our <a class="home-link" href="/getting-started/#installation">CLI</a>.
+    details: Stop wasting time on configuration—your application comes preconfigured for a fast start! Try our <a class="home-link" href="/introduction/getting-started.html">CLI</a>.
   - title: Plugins
     icon: <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-unplug"><path d="m19 5 3-3"/><path d="m2 22 3-3"/><path d="M6.3 20.3a2.4 2.4 0 0 0 3.4 0L12 18l-6-6-2.3 2.3a2.4 2.4 0 0 0 0 3.4Z"/><path d="M7.5 13.5 10 11"/><path d="M10.5 16.5 13 14"/><path d="m12 6 6 6 2.3-2.3a2.4 2.4 0 0 0 0-3.4l-2.6-2.6a2.4 2.4 0 0 0-3.4 0Z"/></svg>
-    details: Choose between different plugins to create your own stack.
+    details: Explore a variety of <a href="/plugins/index.html">plugins</a> to customize your application and build the perfect stack tailored to your needs. You can even create your own plugins to extend functionality further.
   - title: Class based
     icon: <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-gem"><path d="M6 3h12l4 6-10 13L2 9Z"/><path d="M11 3 8 9l4 13 4-13-3-6"/><path d="M2 9h20"/></svg>
-    details: Define class as <a class="home-link" href="/docs/controllers.html">Controller</a>, <a class="home-link" href="/docs/model.html">Model</a>, <a class="home-link" href="/docs/providers.html">Providers</a> (DI), <a class="home-link" href="/docs/pipes.html">Pipes</a>, <a class="home-link" href="/docs/middlewares.html">Middlewares</a>, etc...
+    details: Define classes as <a class='home-link' href='/docs/controllers.html'>Controllers</a>, <a class='home-link' href='/docs/model.html'>Models</a>, <a class='home-link' href='/docs/providers.html'>Providers (DI)</a>, <a class='home-link' href='/docs/pipes.html'>Pipes</a>, and more, with JSON Schema and OpenAPI at the core of the framework.
   - title: Decorators
     icon: <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-paintbrush"><path d="m14.622 17.897-10.68-2.913"/><path d="M18.376 2.622a1 1 0 1 1 3.002 3.002L17.36 9.643a.5.5 0 0 0 0 .707l.944.944a2.41 2.41 0 0 1 0 3.408l-.944.944a.5.5 0 0 1-.707 0L8.354 7.348a.5.5 0 0 1 0-.707l.944-.944a2.41 2.41 0 0 1 3.408 0l.944.944a.5.5 0 0 0 .707 0z"/><path d="M9 8c-1.804 2.71-3.97 3.46-6.583 3.948a.507.507 0 0 0-.302.819l7.32 8.883a1 1 0 0 0 1.185.204C12.735 20.405 16 16.792 16 15"/></svg>
-    details: A lot of decorators are provided to structure your code and define routes and methods.
+    details: Leverage a wide range of <a href='/introduction/create-your-first-controller.html'>decorators</a> to structure your code, define routes, and implement methods with ease.
   - title: Testing
     icon: <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-flask-conical"><path d="M10 2v7.527a2 2 0 0 1-.211.896L4.72 20.55a1 1 0 0 0 .9 1.45h12.76a1 1 0 0 0 .9-1.45l-5.069-10.127A2 2 0 0 1 14 9.527V2"/><path d="M8.5 2h7"/><path d="M7 16h10"/></svg>
-    details: To test or not to test? isn't a question. Ts.ED embeds some features to test your code! <a class="home-link" href="/docs/testing.html">See more</a>.
+    details: Testing is not optional—it's essential! Ts.ED includes built-in features to make testing your code simple and efficient. <a class='home-link' href='/docs/testing.html'>Learn more about testing tools embed by Ts.ED</a>.
 frameworks:
   - title: Node.js
     href: https://nodejs.org/
@@ -189,27 +200,3 @@ partners:
     src: /partners/schnell.svg
     class: "max-w-[120px]"
 ---
-
-<script setup>
-import HomeContainer from "@tsed/vitepress-theme/organisms/home/HomeContainer.vue";
-import { VPTeamMembers } from "vitepress/theme";
-import team from "./team.json";
-
-const members = team.map((member) => {
-   return {
-     avatar: member.src,
-     name: member.title + " - " + member.job,
-     title: member.role,
-     links: [
-        { icon: "github", link: "https://github.com/" + member.github },
-        member.twitter && { icon: "twitter", link: "https://x.com/" + member.twitter }
-     ].filter(Boolean)
-   };
-});
-</script>
-
-<HomeContainer animate class="mx-0 px-0">
-   <div class="text-2xl sm:text-5xl text-center pb-5 mt-20">Team members</div>
-
-   <VPTeamMembers size="small" :members="members" />
-</HomeContainer>
diff --git a/docs/introduction/create-your-first-controller.md b/docs/introduction/create-your-first-controller.md
index 242f0c4d13e..f1d79859ab4 100644
--- a/docs/introduction/create-your-first-controller.md
+++ b/docs/introduction/create-your-first-controller.md
@@ -2,11 +2,13 @@
 next:
   text: Controllers
   link: /docs/controllers
-meta:
-  - name: description
-    content: Create your first controller. Ts.ED is built on top of Express and uses TypeScript language.
-  - name: keywords
-    content: controller getting started ts.ed express typescript node.js javascript decorators mvc class models
+head:
+  - - meta
+    - name: description
+      content: Create your first controller. Ts.ED is built on top of Express and uses TypeScript language.
+  - - meta
+    - name: keywords
+      content: controller getting started ts.ed express typescript node.js javascript decorators mvc class models
 ---
 
 # Create your first controller
diff --git a/docs/introduction/getting-started.md b/docs/introduction/getting-started.md
index bb8e7f116d2..9db526937dc 100644
--- a/docs/introduction/getting-started.md
+++ b/docs/introduction/getting-started.md
@@ -141,7 +141,7 @@ If none of previous solutions are satisfying maybe you are in these cases:
 
 Now you can follow one of these links to develop your new application:
 
-[//]: # "- [Create your first controller](/getting-started/create-your-first-controller.md)"
-[//]: # "- [Change server configuration](/docs/configuration.md)"
-[//]: # "- [Load configuration from files](/docs/configuration.md)"
-[//]: # "- [What is the Platform API](/docs/platform-api.md)"
+- [Create your first controller](/introduction/create-your-first-controller.md)
+- [Change server configuration](/docs/configuration/index.md)
+- [Load configuration from files](/docs/configuration/index.md)
+- [What is the Platform API](/docs/platform-api.md)
diff --git a/docs/introduction/migrate-from-v7.md b/docs/introduction/migrate-from-v7.md
index e23c1ccdf92..c5b5bd594cc 100644
--- a/docs/introduction/migrate-from-v7.md
+++ b/docs/introduction/migrate-from-v7.md
@@ -1,9 +1,11 @@
 ---
-meta:
-  - name: description
-    content: Migrate Ts.ED application from v7 to v8. Ts.ED is built on top of Express and uses TypeScript language.
-  - name: keywords
-    content: migration getting started ts.ed express typescript node.js javascript decorators mvc class models
+head:
+  - - meta
+    - name: description
+      content: Migrate Ts.ED application from v7 to v8. Ts.ED is built on top of Express and uses TypeScript language.
+  - - meta
+    - name: keywords
+      content: migration getting started ts.ed express typescript node.js javascript decorators mvc class models
 ---
 
 # Migrate from v7 to v8
diff --git a/docs/more/team.md b/docs/more/team.md
index 08452fd454f..e628a49c5da 100644
--- a/docs/more/team.md
+++ b/docs/more/team.md
@@ -13,8 +13,8 @@ import team from '../team.json';
 const members = team.map((member) => {
    return {
      avatar: member.src,
-     name: member.title + ' - ' + member.job,
-     title: member.role,
+     name: member.title,
+     title: member.role + ' - ' + member.job,
      links: [
         { icon: 'github', link: 'https://github.com/' + member.github },
         member.twitter && { icon: 'twitter', link: 'https://x.com/' + member.twitter }
diff --git a/docs/package.json b/docs/package.json
index 30c2f733dc8..4924ca73b9a 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -3,12 +3,13 @@
   "version": "8.0.4",
   "type": "module",
   "scripts": {
-    "docs:dev": "vitepress dev .",
-    "docs:build": "vitepress build .",
-    "docs:preview": "vitepress preview ."
+    "docs:dev": "yarn build:api:summary && vitepress dev .",
+    "docs:build": "yarn build:api:summary && vitepress build .",
+    "docs:preview": "vitepress preview .",
+    "build:api:summary": "node ./.vitepress/scripts/api-summary.js"
   },
   "dependencies": {
-    "@tsed/vitepress-theme": "1.4.0",
+    "@tsed/vitepress-theme": "1.5.2",
     "@vueuse/core": "10.11.0",
     "axios": "1.7.7",
     "lodash": "4.17.21",
diff --git a/docs/plugins/index.md b/docs/plugins/index.md
index 836ef6669d7..216b9332eb9 100644
--- a/docs/plugins/index.md
+++ b/docs/plugins/index.md
@@ -1,10 +1,12 @@
 ---
 layout: page
-meta:
-  - name: description
-    content: Discover our list of plugins to extends your Ts.ED project. Created by the Ts.ED team and community.
-  - name: keywords
-    content: Ts.ED nodejs express typescript javascript es6 decorators mvc model ioc service model middleware socket.io swagger typeorm mongoose ajv
+head:
+  - - meta
+    - name: description
+      content: Discover our list of plugins to extends your Ts.ED project. Created by the Ts.ED team and community.
+  - - meta
+    - name: keywords
+      content: Ts.ED nodejs express typescript javascript es6 decorators mvc model ioc service model middleware socket.io swagger typeorm mongoose ajv
 ---
 
 <Warehouse />
diff --git a/docs/yarn.lock b/docs/yarn.lock
index eee3f50e73b..d8a1a870e24 100644
--- a/docs/yarn.lock
+++ b/docs/yarn.lock
@@ -734,7 +734,7 @@ __metadata:
   version: 0.0.0-use.local
   resolution: "@tsed/docs-new@workspace:."
   dependencies:
-    "@tsed/vitepress-theme": "npm:1.4.0"
+    "@tsed/vitepress-theme": "npm:1.5.2"
     "@vueuse/core": "npm:10.11.0"
     autoprefixer: "npm:^10.4.19"
     axios: "npm:1.7.7"
@@ -746,14 +746,14 @@ __metadata:
   languageName: unknown
   linkType: soft
 
-"@tsed/vitepress-theme@npm:1.4.0":
-  version: 1.4.0
-  resolution: "@tsed/vitepress-theme@npm:1.4.0"
+"@tsed/vitepress-theme@npm:1.5.2":
+  version: 1.5.2
+  resolution: "@tsed/vitepress-theme@npm:1.5.2"
   dependencies:
     "@vueuse/core": "npm:10.11.0"
     axios: "npm:1.7.7"
     lucide-vue-next: "npm:^0.436.0"
-  checksum: 10/4b42f36e7513ae6c85ef6433d269f0d48510a4d3c0d1a1a51bfdfd254716039cd9a405140b479f1025b95335003c1f75ad5ec819648627e9294599102cdf93ac
+  checksum: 10/04ce26cf6599b36ca9d28d6162740468ac37d0a0f68679fe982c31ee5ebe926dd9c50734111fa3aba8c1212839963017681e1c2122a592961cad775d6b47edf9
   languageName: node
   linkType: hard
 
diff --git a/readme.md b/readme.md
index f49eb6a53b7..a475423abd3 100644
--- a/readme.md
+++ b/readme.md
@@ -28,12 +28,15 @@
 
 <hr />
 
-> A Node.js and TypeScript Framework on top of Express. It provides a lot of decorators and guidelines to write your code.
-
 ## What it is
 
-Ts.ED is a Node.js and TypeScript Framework on top of Express/Koa.js. Ts.ED is a framework on top of Express/Koa to write your application with TypeScript (or ES6).
-It provides a lot of decorators and guideline to make your code more readable and less error-prone.
+Ts.ED is a modern Node.js framework built with TypeScript. It offers a flexible structure with a fast learning curve, specifically designed to improve the developer experience. Ts.ED provides numerous decorators and guidelines to make your code more readable and less error-prone. It supports various platforms and tools, including Node.js/Bun.js, Express.js/Koa.js, CLI, and serverless architectures (e.g., AWS).
+
+- Multi-platform: Easily build your server-side application using Express.js, Koa.js, CLI, or serverless platforms (e.g., AWS). It supports both Node.js and Bun.js runtimes. Learn more <a class="home-link" href="https://tsed.dev/introduction/capabilities.html">here</a>.
+- Configuration: Stop wasting time on configuration—your application comes preconfigured for a fast start! Try our <a class="home-link" href="https://tsed.dev/introduction/getting-started.html">CLI</a>.
+- Decorators: Use a wide range of decorators to structure your code, define routes, and implement methods with ease. Learn more <a class="home-link" href="https://tsed.dev/introduction/decorators.html">here</a>.
+- Class-based: Define classes as <a class='home-link' href='http://tsed.dev/docs/controllers.html'>Controllers</a>, <a class='home-link' href='http://tsed.dev/docs/model.html'>Models</a>, <a class='home-link' href='http://tsed.dev/docs/providers.html'>Providers (DI)</a>, <a class='home-link' href='http://tsed.dev/docs/pipes.html'>Pipes</a>, and more, with JSON Schema and OpenAPI at the core of the framework.
+- Testing: Testing is not optional—it's essential! Ts.ED includes built-in features to make testing your code simple and efficient. Learn more <a class="home-link" href="https://tsed.dev/docs/testing.html">here</a>.
 
 ## Features
 
diff --git a/team.json b/team.json
index 93ccf6ad412..73321a9440f 100644
--- a/team.json
+++ b/team.json
@@ -91,8 +91,8 @@
     "country": "Germany",
     "city": "Cologne",
     "role": "Contributor"
-  }
-    {
+  },
+  {
     "title": "Xavier Jamito",
     "job": "Developer",
     "src": "https://avatars.githubusercontent.com/u/17645632?v=4",