From 5299cf1b408b546609a85428384a5c1b26b230b7 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/.vitepress/config.mts                    |   2 +-
 docs/.vitepress/theme/index.ts                |  10 +-
 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                                 |  25 +--
 .../create-your-first-controller.md           |  12 +-
 docs/introduction/getting-started.md          |   8 +-
 docs/introduction/migrate-from-v7.md          |  12 +-
 docs/plugins/index.md                         |  12 +-
 readme.md                                     |  11 +-
 28 files changed, 331 insertions(+), 128 deletions(-)
 create mode 100644 docs/getting-started.md

diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
index 867340ca81a..90c75223bcd 100644
--- a/docs/.vitepress/config.mts
+++ b/docs/.vitepress/config.mts
@@ -8,7 +8,7 @@ import {getSidebar} from "./api.js";
 export default defineConfig({
   title: "Ts.ED",
   lastUpdated: true,
-
+  description: "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).",
   sitemap: {
     hostname: "https://tsed.io"
   },
diff --git a/docs/.vitepress/theme/index.ts b/docs/.vitepress/theme/index.ts
index c7f17922b83..863ac1a1d85 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 HomePartners from "@tsed/vitepress-theme/organisms/home/HomePartners.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 type {Theme} from "vitepress";
+import {h} from "vue";
 import "./style.css";
 
 export default {
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..b4c081aa3c5
--- /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](/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)
diff --git a/docs/index.md b/docs/index.md
index d30325ef1b1..150b2a9a3d3 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 express koa aws cli di rest graphql typescript node.js bun.js javascript native ESM decorators jsonschema class models
 
 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?
@@ -18,24 +25,24 @@ hero:
       link: https://github.com/sponsors/Romakita
 
 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" href="/introduction/capabilities.html">here</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</a>.
 frameworks:
   - title: Node.js
     href: https://nodejs.org/
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..b4c081aa3c5 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](/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)
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/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/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