diff --git a/.github/workflows/package.yml b/.github/workflows/package.yml
index 3ba8a23..a20fb5f 100644
--- a/.github/workflows/package.yml
+++ b/.github/workflows/package.yml
@@ -1,13 +1,27 @@
 name: Node.js CI
 
+# Triggers:
+#   - push to main          → publish_stage publishes :stage (internal)
+#   - push tag v*           → release_package publishes :latest + :vX.Y.Z
+#   - PR to main/development → build job only (no publish)
+#   - workflow_dispatch     → manual button to refresh :stage on demand
+#
+# Stage deploys (gofr-dev/gofr's website-stage.yml) pull :stage, so
+# every merge to website main automatically refreshes what stage shows.
+# Prod deploys (website-prod.yml) build inline from this source rather
+# than pulling :latest, so prod is always fresh on every framework
+# release tag regardless of when the website was last tagged.
 on:
   push:
+    branches:
+      - main
     tags:
       - 'v*'
   pull_request:
     branches:
       - main
       - development
+  workflow_dispatch:
 
 jobs:
   build:
@@ -24,6 +38,62 @@ jobs:
           yarn install
           yarn build
 
+  # Internal :stage artifact. Published on every push to main + via
+  # workflow_dispatch. Each run refreshes data so :stage bakes in
+  # current GoFr release / roadmap / contributor state. Stage deploys
+  # in gofr-dev/gofr pull this image — pulling is cheaper than
+  # rebuilding the website from source on every push to gofr's
+  # development branch.
+  publish_stage:
+    if: |
+      (github.event_name == 'push' && github.ref == 'refs/heads/main') ||
+      github.event_name == 'workflow_dispatch'
+    needs: build
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Use Node.js 18.x
+        uses: actions/setup-node@v4
+        with:
+          node-version: 18.x
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: Refresh data from GitHub (snapshot fallback on failure)
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: yarn refresh-data
+        continue-on-error: true
+
+      - name: Log in to the Container registry
+        uses: docker/login-action@v1
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build and push Docker image (:stage)
+        uses: docker/build-push-action@v4
+        with:
+          push: true
+          context: .
+          file: Dockerfile
+          tags: ghcr.io/gofr-dev/website:stage
+
+  # Public :latest artifact. Published on tag v* push as a versioned
+  # release + the rolling :latest pointer. Prod deploys do NOT pull
+  # this — they build inline — but it's kept as an external artifact
+  # and a rollback target.
   release_package:
     if: ${{ startsWith(github.ref, 'refs/tags/v')}}
     needs: build
@@ -36,6 +106,39 @@ jobs:
     steps:
       - name: Checkout Code
         uses: actions/checkout@v4
+        # Full history is needed by utils/generate-doc-mtimes.mjs which
+        # reads `git log` per source file to compute the visible
+        # "Last updated" byline. A shallow clone would give every doc
+        # the same boot timestamp.
+        with:
+          fetch-depth: 0
+
+      - name: Use Node.js 18.x
+        uses: actions/setup-node@v4
+        with:
+          node-version: 18.x
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+
+      # Pull fresh data from GitHub at deploy time — releases, roadmap
+      # milestones, team profiles + contributor list, and per-doc git
+      # mtimes. The fetch scripts each have a snapshot fallback: on a
+      # rate-limited or transient failure they keep the previously-
+      # committed JSON rather than emitting an empty file.
+      #
+      # `continue-on-error: true` makes this step non-blocking — even
+      # in the worst case (every API call failed) the build proceeds
+      # with the committed snapshots, never an empty website.
+      #
+      # Auth uses the workflow's built-in GITHUB_TOKEN (1000 req/hr),
+      # which is enough for our ~150-request refresh and avoids the
+      # 60/hr unauthenticated cliff.
+      - name: Refresh data from GitHub (snapshot fallback on failure)
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: yarn refresh-data
+        continue-on-error: true
 
       - name: Log in to the Container registry
         uses: docker/login-action@v1
@@ -47,7 +150,7 @@ jobs:
       - name: Extract Release Tag
         run: echo "RELEASE_VERSION=${GITHUB_REF#refs/*/}" >> $GITHUB_ENV
 
-      - name: Build and push Docker image
+      - name: Build and push Docker image (:latest + :v*)
         uses: docker/build-push-action@v4
         with:
           push: true
diff --git a/Dockerfile b/Dockerfile
index 9aaf7f8..fff000c 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -7,6 +7,7 @@ WORKDIR /app
 
 COPY src src/.
 COPY utils utils/.
+COPY public public/.
 COPY jsconfig.json .
 COPY next.config.mjs .
 COPY package.json .
diff --git a/next.config.mjs b/next.config.mjs
index 85fa37c..6ff04dc 100644
--- a/next.config.mjs
+++ b/next.config.mjs
@@ -6,14 +6,82 @@ import withSearch from './src/markdoc/search.mjs'
 /** @type {import('next').NextConfig} */
 const nextConfig = {
   output: 'export',
+  // `output: 'export'` disables Next's image optimisation API
+  // (/_next/image). Without `images.unoptimized = true`, every
+  // <Image> tag emits a /_next/image?url=... src that 404s in
+  // production and renders as a browser broken-image icon. Setting
+  // it once here means we don't need to remember `unoptimized` on
+  // every <Image> usage. PNG/JPG sizes are managed at the source.
+  images: { unoptimized: true },
   pageExtensions: ['js', 'jsx', 'md', 'ts', 'tsx'],
   webpack(config) {
     config.module.rules.unshift({
       test: /\.md$/,
       use: [
         createLoader(function (source) {
+          // Inject metadataBase so Open Graph and Twitter image URLs
+          // resolve to gofr.dev in production builds. The frontmatter
+          // `nextjs.metadata` block layers title/description on top.
+          //
+          // We also auto-derive page-level `openGraph` and `twitter`
+          // title/description from the frontmatter's top-level title and
+          // description. Without this, every Markdoc page inherits the
+          // root layout's openGraph.title / twitter.title — meaning every
+          // social share preview shows the home page's card. The author of
+          // a doc can still override by setting `nextjs.metadata.openGraph`
+          // or `nextjs.metadata.twitter` explicitly in frontmatter.
+          //
+          // Derive the route from the resource path (e.g.
+          // `<repo>/src/app/docs/guides/deploying-to-kubernetes/page.md` →
+          // `/docs/guides/deploying-to-kubernetes`). We inject this as
+          // `alternates.canonical` so every Markdoc page emits a unique
+          // <link rel="canonical">. Next's metadata API does NOT
+          // auto-derive canonical from metadataBase + pathname; it must
+          // be set explicitly. The page can override by providing
+          // `nextjs.metadata.alternates.canonical` in frontmatter.
+          const resourcePath = (this.resourcePath || '').replace(/\\/g, '/')
+          const appIdx = resourcePath.indexOf('/src/app/')
+          let __canonical = '/'
+          if (appIdx !== -1) {
+            const rel = resourcePath.slice(appIdx + '/src/app/'.length)
+            // Strip trailing /page.md
+            const stripped = rel.replace(/\/page\.md$/, '')
+            __canonical = '/' + stripped
+            if (__canonical === '/') __canonical = '/'
+          }
           return (
-            source + '\nexport const metadata = frontmatter.nextjs?.metadata;'
+            source +
+            `
+const __pageMeta = frontmatter.nextjs?.metadata || {};
+const __pageTitle = typeof __pageMeta.title === 'string' ? __pageMeta.title : undefined;
+const __pageDesc = typeof __pageMeta.description === 'string' ? __pageMeta.description : undefined;
+const __og = {
+  ...(__pageTitle ? { title: __pageTitle } : {}),
+  ...(__pageDesc ? { description: __pageDesc } : {}),
+  ...(__pageMeta.openGraph || {}),
+};
+const __tw = {
+  ...(__pageTitle ? { title: __pageTitle } : {}),
+  ...(__pageDesc ? { description: __pageDesc } : {}),
+  ...(__pageMeta.twitter || {}),
+};
+const __derivedCanonical = ${JSON.stringify(__canonical)};
+const __alternates = {
+  canonical: __derivedCanonical,
+  ...(__pageMeta.alternates || {}),
+};
+// Only emit openGraph / twitter when the page actually carries
+// per-page values. If we always emitted an object, Next's metadata
+// merge would replace the parent layout's openGraph wholesale and
+// strip its title/description for pages with no frontmatter.
+export const metadata = {
+  metadataBase: new URL("https://gofr.dev"),
+  ...__pageMeta,
+  alternates: __alternates,
+  ...(Object.keys(__og).length ? { openGraph: { type: 'article', ...__og } } : {}),
+  ...(Object.keys(__tw).length ? { twitter: { card: 'summary_large_image', ...__tw } } : {}),
+};
+`
           )
         }),
       ],
diff --git a/package-lock.json b/package-lock.json
index af7ca40..dc31266 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -26,7 +26,7 @@
         "copy-to-clipboard": "^3.3.3",
         "fast-glob": "^3.3.3",
         "flexsearch": "^0.7.31",
-        "js-yaml": "^4.1.0",
+        "js-yaml": "^4.1.1",
         "next": "13.4.16",
         "next-themes": "^0.2.1",
         "prism-react-renderer": "^2.0.6",
@@ -60,7 +60,6 @@
       "resolved": "https://registry.npmjs.org/@algolia/abtesting/-/abtesting-1.4.0.tgz",
       "integrity": "sha512-N0blWT/C0KOZ/OJ9GXBX66odJZlrYjMj3M+01y8ob1mjBFnBaBo7gOCyHBDQy60+H4pJXp3pSGlJOqJIueBH+A==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@algolia/client-common": "5.38.0",
         "@algolia/requester-browser-xhr": "5.38.0",
@@ -108,7 +107,6 @@
       "resolved": "https://registry.npmjs.org/@algolia/client-abtesting/-/client-abtesting-5.38.0.tgz",
       "integrity": "sha512-15d6zv8vtj2l9pnnp/EH7Rhq3/snCCHRz56NnX6xIUPrbJl5gCsIYXAz8C2IEkwOpoDb0r5G6ArY2gKdVMNezw==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@algolia/client-common": "5.38.0",
         "@algolia/requester-browser-xhr": "5.38.0",
@@ -124,7 +122,6 @@
       "resolved": "https://registry.npmjs.org/@algolia/client-analytics/-/client-analytics-5.38.0.tgz",
       "integrity": "sha512-jJIbYAhYvTG3+gEAP5Q5Dp6PFJfUR+atz5rsqm5KjAKK+faLFdHJbM2IbOo0xdyGd+SH259MzfQKLJ9mZZ27dQ==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@algolia/client-common": "5.38.0",
         "@algolia/requester-browser-xhr": "5.38.0",
@@ -140,7 +137,6 @@
       "resolved": "https://registry.npmjs.org/@algolia/client-common/-/client-common-5.38.0.tgz",
       "integrity": "sha512-aMCXzVPGJTeQnVU3Sdf30TfMN2+QyWcjfPTCCHyqVVgjPipb6RnK40aISGoO+rlYjh9LunDsNVFLwv+JEIF8bQ==",
       "license": "MIT",
-      "peer": true,
       "engines": {
         "node": ">= 14.0.0"
       }
@@ -150,7 +146,6 @@
       "resolved": "https://registry.npmjs.org/@algolia/client-insights/-/client-insights-5.38.0.tgz",
       "integrity": "sha512-4c3FbpMiJX+VcaAj0rYaQdTLS/CkrdOn4hW+5y1plPov7KC7iSHai/VBbirmHuAfW1hVPCIh1w/4erKKTKuo+Q==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@algolia/client-common": "5.38.0",
         "@algolia/requester-browser-xhr": "5.38.0",
@@ -166,7 +161,6 @@
       "resolved": "https://registry.npmjs.org/@algolia/client-personalization/-/client-personalization-5.38.0.tgz",
       "integrity": "sha512-FzLs6c8TBL4FSgNfnH2NL7O33ktecGiaKO4ZFG51QYORUzD5d6YwB9UBteaIYu/sgFoEdY57diYU4vyBH8R6iA==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@algolia/client-common": "5.38.0",
         "@algolia/requester-browser-xhr": "5.38.0",
@@ -182,7 +176,6 @@
       "resolved": "https://registry.npmjs.org/@algolia/client-query-suggestions/-/client-query-suggestions-5.38.0.tgz",
       "integrity": "sha512-7apiahlgZLvOqrh0+hAYAp/UWjqz6AfSJrCwnsoQNzgIT09dLSPIKREelkuQeUrKy38vHWWpSQE3M0zWSp/YrA==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@algolia/client-common": "5.38.0",
         "@algolia/requester-browser-xhr": "5.38.0",
@@ -214,7 +207,6 @@
       "resolved": "https://registry.npmjs.org/@algolia/ingestion/-/ingestion-1.38.0.tgz",
       "integrity": "sha512-qGSUGgceJHGyJLZ06bFLwVe2Tpf9KwabmoBjFvFscVmMmU5scKya6voCYd9bdX7V0Xy1qya9MGbmTm4zlLuveQ==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@algolia/client-common": "5.38.0",
         "@algolia/requester-browser-xhr": "5.38.0",
@@ -230,7 +222,6 @@
       "resolved": "https://registry.npmjs.org/@algolia/monitoring/-/monitoring-1.38.0.tgz",
       "integrity": "sha512-VnCtAUcHirvv/dDHg9jK1Z5oo4QOC5FKDxe40x8qloru2qDcjueT34jiAsB0gRos3VWf9v4iPSYTqMIFOcADpQ==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@algolia/client-common": "5.38.0",
         "@algolia/requester-browser-xhr": "5.38.0",
@@ -246,7 +237,6 @@
       "resolved": "https://registry.npmjs.org/@algolia/recommend/-/recommend-5.38.0.tgz",
       "integrity": "sha512-fqgeU9GqxQorFUeGP4et1MyY28ccf9PCeciHwDPSbPYYiTqBItHdUIiytsNpjC5Dnc0RWtuXWCltLwSw9wN/bQ==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@algolia/client-common": "5.38.0",
         "@algolia/requester-browser-xhr": "5.38.0",
@@ -262,7 +252,6 @@
       "resolved": "https://registry.npmjs.org/@algolia/requester-browser-xhr/-/requester-browser-xhr-5.38.0.tgz",
       "integrity": "sha512-nAUKbv4YQIXbpPi02AQvSPisD5FDDbT8XeYSh9HFoYP0Z3IpBLLDg7R4ahPvzd7gGsVKgEbXzRPWESXSji5yIg==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@algolia/client-common": "5.38.0"
       },
@@ -275,7 +264,6 @@
       "resolved": "https://registry.npmjs.org/@algolia/requester-fetch/-/requester-fetch-5.38.0.tgz",
       "integrity": "sha512-bkuAHaadC6OxJd3SVyQQnU1oJ9G/zdCqua7fwr1tJDrA/v7KzeS5np4/m6BuRUpTgVgFZHSewGnMcgj9DLBoaQ==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@algolia/client-common": "5.38.0"
       },
@@ -288,7 +276,6 @@
       "resolved": "https://registry.npmjs.org/@algolia/requester-node-http/-/requester-node-http-5.38.0.tgz",
       "integrity": "sha512-yHDKZTnMPR3/4bY0CVC1/uRnnbAaJ+pctRuX7G/HflBkKOrnUBDEGtQQHzEfMz2FHZ/tbCL+Q9r6mvwTSGp8nw==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@algolia/client-common": "5.38.0"
       },
@@ -579,6 +566,7 @@
       "version": "11.11.4",
       "resolved": "https://registry.npmjs.org/@emotion/react/-/react-11.11.4.tgz",
       "integrity": "sha512-t8AjMlF0gHpvvxk5mAtCqR4vmxiGHCeJBaQO6gncUSdklELOgtwjerNY2yuJNfwnc6vi16U/+uMF+afIawJ9iw==",
+      "peer": true,
       "dependencies": {
         "@babel/runtime": "^7.18.3",
         "@emotion/babel-plugin": "^11.11.0",
@@ -627,6 +615,7 @@
       "version": "11.11.5",
       "resolved": "https://registry.npmjs.org/@emotion/styled/-/styled-11.11.5.tgz",
       "integrity": "sha512-/ZjjnaNKvuMPxcIiUkf/9SHoG4Q196DRl1w82hQ3WCsjo1IUR8uaGWrC6a87CrYAW0Kb/pK7hk8BnLgLRi9KoQ==",
+      "peer": true,
       "dependencies": {
         "@babel/runtime": "^7.18.3",
         "@emotion/babel-plugin": "^11.11.0",
@@ -857,6 +846,7 @@
       "version": "0.3.0",
       "resolved": "https://registry.npmjs.org/@markdoc/markdoc/-/markdoc-0.3.0.tgz",
       "integrity": "sha512-QWCF8krIIw52ulflfnoff0yG1eKl9CCGA3KAiOjHyYtHNzSEouFh8lO52nAaO3qV2Ctj1GTB8TTb2rTfvISQfA==",
+      "peer": true,
       "engines": {
         "node": ">=14.7.0"
       },
@@ -930,6 +920,7 @@
       "resolved": "https://registry.npmjs.org/@mui/material/-/material-5.18.0.tgz",
       "integrity": "sha512-bbH/HaJZpFtXGvWg3TsBWG4eyt3gah3E7nCNU8GLyRjVoWcA91Vm/T+sjHfUcwgJSw9iLtucfHBoq+qW/T30aA==",
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "@babel/runtime": "^7.23.9",
         "@mui/core-downloads-tracker": "^5.18.0",
@@ -1505,6 +1496,7 @@
       "version": "18.3.1",
       "resolved": "https://registry.npmjs.org/@types/react/-/react-18.3.1.tgz",
       "integrity": "sha512-V0kuGBX3+prX+DQ/7r2qsv1NsdfnCLnTgnRJ1pYnxykBhGMz+qj+box5lq7XsO5mtZsBqpjwwTu/7wszPfMBcw==",
+      "peer": true,
       "dependencies": {
         "@types/prop-types": "*",
         "csstype": "^3.0.2"
@@ -1655,6 +1647,7 @@
       "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.14.0.tgz",
       "integrity": "sha512-cl669nCJTZBsL97OF4kUQm5g5hC2uihk0NxY3WENAC0TYdILVkAyHymAntgxGkl7K+t0cXIrH5siy5S4XkFycA==",
       "dev": true,
+      "peer": true,
       "bin": {
         "acorn": "bin/acorn"
       },
@@ -2123,6 +2116,7 @@
           "url": "https://github.com/sponsors/ai"
         }
       ],
+      "peer": true,
       "dependencies": {
         "caniuse-lite": "^1.0.30001517",
         "electron-to-chromium": "^1.4.477",
@@ -2898,6 +2892,7 @@
       "resolved": "https://registry.npmjs.org/eslint/-/eslint-8.45.0.tgz",
       "integrity": "sha512-pd8KSxiQpdYRfYa9Wufvdoct3ZPQQuVuU5O6scNgMuOMYuxvH0IGaYK0wUFjo4UYYQQCUndlXiMbnxopwvvTiw==",
       "dev": true,
+      "peer": true,
       "dependencies": {
         "@eslint-community/eslint-utils": "^4.2.0",
         "@eslint-community/regexpp": "^4.4.0",
@@ -3049,6 +3044,7 @@
       "resolved": "https://registry.npmjs.org/eslint-plugin-import/-/eslint-plugin-import-2.31.0.tgz",
       "integrity": "sha512-ixmkI62Rbc2/w8Vfxyh1jQRTdRTF52VxwRVHl/ykPAmqG+Nb7/kNn+byLP0LxPgI7zWA16Jt82SybJInmMia3A==",
       "dev": true,
+      "peer": true,
       "dependencies": {
         "@rtsao/scc": "^1.1.0",
         "array-includes": "^3.1.8",
@@ -4394,9 +4390,10 @@
       "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ=="
     },
     "node_modules/js-yaml": {
-      "version": "4.1.0",
-      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz",
-      "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==",
+      "version": "4.1.1",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.1.tgz",
+      "integrity": "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==",
+      "license": "MIT",
       "dependencies": {
         "argparse": "^2.0.1"
       },
@@ -4697,6 +4694,7 @@
       "resolved": "https://registry.npmjs.org/next/-/next-13.4.16.tgz",
       "integrity": "sha512-1xaA/5DrfpPu0eV31Iro7JfPeqO8uxQWb1zYNTe+KDKdzqkAGapLcDYHMLNKXKB7lHjZ7LfKUOf9dyuzcibrhA==",
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "@next/env": "13.4.16",
         "@swc/helpers": "0.5.1",
@@ -5157,6 +5155,7 @@
         }
       ],
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "nanoid": "^3.3.11",
         "picocolors": "^1.1.1",
@@ -5323,6 +5322,7 @@
       "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.0.3.tgz",
       "integrity": "sha512-L/4pUDMxcNa8R/EthV08Zt42WBO4h1rarVtK0K+QJG0X187OLo7l699jWw0GKuwzkPQ//jMFA/8Xm6Fh3J/DAg==",
       "dev": true,
+      "peer": true,
       "bin": {
         "prettier": "bin/prettier.cjs"
       },
@@ -5512,6 +5512,7 @@
       "version": "18.2.0",
       "resolved": "https://registry.npmjs.org/react/-/react-18.2.0.tgz",
       "integrity": "sha512-/3IjMdb2L9QbBdWiW5e3P2/npwMBaU9mHCSCUzNln0ZCYbcfTsGbTJrU/kGemdH2IWmB2ioZ+zkxtmq6g09fGQ==",
+      "peer": true,
       "dependencies": {
         "loose-envify": "^1.1.0"
       },
@@ -5523,6 +5524,7 @@
       "version": "18.2.0",
       "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-18.2.0.tgz",
       "integrity": "sha512-6IMTriUmvsjHUjNtEDudZfuDQUoWXVxKHhlEGSk81n4YFS+r/Kl99wXiwlVXtPBtJenozv2P+hxDsw9eA7Xo6g==",
+      "peer": true,
       "dependencies": {
         "loose-envify": "^1.1.0",
         "scheduler": "^0.23.0"
@@ -6405,6 +6407,7 @@
       "resolved": "https://registry.npmjs.org/tailwindcss/-/tailwindcss-3.4.17.tgz",
       "integrity": "sha512-w33E2aCvSDP0tW9RZuNXadXlkHXqFzSkQew/aIa2i/Sj8fThxwovwlXHSPXTbAHwEIhBFXAedUhP2tueAKP8Og==",
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "@alloc/quick-lru": "^5.2.0",
         "arg": "^5.0.2",
diff --git a/package.json b/package.json
index 29fb41a..6eb0e9f 100644
--- a/package.json
+++ b/package.json
@@ -4,9 +4,11 @@
   "private": true,
   "scripts": {
     "dev": "next dev",
+    "prebuild": "node utils/fetch-github-stars.mjs && node utils/generate-changelog-rss.mjs && node utils/generate-llms-full.mjs",
     "build": "next build",
     "start": "next start",
-    "lint": "next lint"
+    "lint": "next lint",
+    "refresh-data": "node utils/fetch-releases.mjs && node utils/fetch-roadmap.mjs && node utils/fetch-team.mjs && node utils/fetch-github-stars.mjs && node utils/generate-doc-mtimes.mjs && node utils/generate-changelog-rss.mjs && node utils/generate-llms-full.mjs"
   },
   "browserslist": "defaults, not ie <= 11",
   "dependencies": {
diff --git a/public/.well-known/security.txt b/public/.well-known/security.txt
new file mode 100644
index 0000000..d186cb4
--- /dev/null
+++ b/public/.well-known/security.txt
@@ -0,0 +1,7 @@
+# Industry-standard discoverable security contact (RFC 9116).
+# Reachable at https://gofr.dev/.well-known/security.txt
+Contact: mailto:connect@gofr.dev
+Contact: https://github.com/gofr-dev/gofr/security/advisories/new
+Preferred-Languages: en
+Canonical: https://gofr.dev/.well-known/security.txt
+Policy: https://github.com/gofr-dev/gofr/blob/main/SECURITY.md
diff --git a/public/AGENTS.md b/public/AGENTS.md
new file mode 100644
index 0000000..0dcedcc
--- /dev/null
+++ b/public/AGENTS.md
@@ -0,0 +1,101 @@
+# GoFr — guide for AI coding assistants
+
+For Claude Code, Cursor, Aider, Codex, etc. Hand
+[https://gofr.dev/AGENTS.md](https://gofr.dev/AGENTS.md) to your assistant
+when working on a GoFr project. It points at the specific docs you'll
+actually need rather than inlining everything.
+
+GoFr is an opinionated Go framework for microservices. Apache 2.0.
+Requires Go 1.24+. Repo: <https://github.com/gofr-dev/gofr>.
+
+## Core rules an assistant must know
+
+1. **One handler signature** for HTTP / gRPC / GraphQL / WebSocket / SSE / cron / CLI:
+   `func(c *gofr.Context) (any, error)`. Return value → `{"data": ...}`. Return error → error response.
+2. **Path params use `{name}`**, not `:name`. `app.GET("/users/{id}", h)`.
+3. **`c.PathParam("id")`** for path; **`c.Param("q")`** for query; **`c.Bind(&v)`** for body.
+4. **Don't manually wire OpenTelemetry, Prometheus, or structured logging.** `gofr.New()` does it.
+5. **Pass `*gofr.Context`** (not `context.Background()`) to every downstream call so trace propagation and cancellation work.
+6. **Configuration comes from `configs/.env`** via `c.Config.Get(key)`. No hardcoded ports / hosts / secrets.
+7. **No ORM bundled.** Use plain SQL via `c.SQL`, or pair with `sqlc`/`gorm` yourself.
+8. **Middleware is standard `net/http`**: `func(http.Handler) http.Handler`, registered with `app.UseMiddleware(...)`.
+9. **Health is auto-exposed** at `/.well-known/health` and `/.well-known/alive`. Don't hand-roll `/healthz`.
+10. **Don't `panic()` for control flow.** Return errors.
+
+## Minimal app
+
+```go
+package main
+
+import "gofr.dev/pkg/gofr"
+
+func main() {
+    app := gofr.New()
+    app.GET("/hello", func(c *gofr.Context) (any, error) {
+        return "Hello, world", nil
+    })
+    app.Run()
+}
+```
+
+## Migrations (schema + seed data, versioned)
+
+GoFr has a built-in migration runner — use it instead of `golang-migrate` / `goose`. Works for SQL, Redis, Mongo, Cassandra, ClickHouse, DGraph, SurrealDB.
+
+**Before writing a migration, fetch the full reference:** <https://gofr.dev/docs/advanced-guide/handling-data-migrations>. Runnable shape: <https://github.com/gofr-dev/gofr/tree/main/examples/using-migrations>.
+
+Five rules to keep in your head so you don't have to re-fetch on every change:
+
+1. Files live in `migrations/<unix-ts>_<name>.go`. Versions are `int64`, monotonic. Use `date +%s` for new ones.
+2. `migrations/all.go` exports `All() map[int64]migration.Migrate`. Wire with `a.Migrate(migrations.All())` once in `main.go`.
+3. Each migration is `migration.Migrate{ UP: func(d migration.Datasource) error { ... } }`. Inside `UP`, act on `d.SQL`, `d.Redis`, `d.MongoDB`, `d.Cassandra`, `d.Clickhouse`, `d.DGraph`, `d.SurrealDB`, `d.Logger`.
+4. Each migration runs **exactly once** per environment — don't add idempotent guards. There is **no down migration**; rollback = new forward migration.
+5. One purpose per file. Don't combine "create table + backfill + drop column" in one `UP`.
+
+## Where to look (fetch only what you need)
+
+Each link is a self-contained doc page. Fetch lazily.
+
+- Quick start: <https://gofr.dev/docs/quick-start/introduction>
+- Configuration: <https://gofr.dev/docs/quick-start/configuration>
+- Routing + REST handlers: <https://gofr.dev/docs/quick-start/add-rest-handlers>
+- Context reference (the central abstraction): <https://gofr.dev/docs/references/context>
+- Configs reference (every env var): <https://gofr.dev/docs/references/configs>
+- Testing patterns + mocks: <https://gofr.dev/docs/references/testing>
+- Observability (auto-wired): <https://gofr.dev/docs/quick-start/observability>
+- Custom OTel spans: <https://gofr.dev/docs/advanced-guide/custom-spans-in-tracing>
+- Custom Prometheus metrics: <https://gofr.dev/docs/advanced-guide/publishing-custom-metrics>
+- Datasources index (MySQL, Postgres, Mongo, Redis, Cassandra, ClickHouse, etc.): <https://gofr.dev/docs/datasources/getting-started>
+- Pub/Sub (Kafka, NATS, GCP, MQTT, SQS, Azure): <https://gofr.dev/docs/advanced-guide/using-publisher-subscriber>
+- gRPC: <https://gofr.dev/docs/advanced-guide/grpc>
+- GraphQL: <https://gofr.dev/docs/advanced-guide/graphql>
+- WebSockets: <https://gofr.dev/docs/advanced-guide/websocket>
+- Cron: <https://gofr.dev/docs/advanced-guide/using-cron>
+- Service-to-service HTTP w/ circuit breaker: <https://gofr.dev/docs/advanced-guide/http-communication>
+- Auth (Basic / API key / OAuth-JWT): <https://gofr.dev/docs/advanced-guide/authentication>
+- RBAC (config-driven): <https://gofr.dev/docs/advanced-guide/rbac>
+- Migrations (SQL + NoSQL, versioned): <https://gofr.dev/docs/advanced-guide/handling-data-migrations>
+- File storage (local / S3 / GCS / Azure / FTP / SFTP): <https://gofr.dev/docs/advanced-guide/handling-file>
+- Startup hooks: <https://gofr.dev/docs/advanced-guide/startup-hooks>
+- Errors: <https://gofr.dev/docs/advanced-guide/gofr-errors>
+- Custom DB drivers: <https://gofr.dev/docs/advanced-guide/injecting-databases-drivers>
+
+## Migrating to GoFr
+
+Each migration page has the full mapping table for that source framework — fetch only the one that matches:
+
+- From Gin: <https://gofr.dev/migrate/from-gin>
+- From Fiber: <https://gofr.dev/migrate/from-fiber>
+- From Echo: handler shape similar to Gin; see <https://gofr.dev/comparison/gofr-vs-echo>
+- From Chi: see <https://gofr.dev/comparison/gofr-vs-chi>
+- From Express (Node.js): <https://gofr.dev/migrate/from-express>
+- From Flask (Python): <https://gofr.dev/migrate/from-flask>
+- From Spring Boot (Java): <https://gofr.dev/migrate/from-spring-boot>
+
+## Other entry points
+
+- Examples (runnable projects): <https://github.com/gofr-dev/gofr/tree/main/examples>
+- Full docs index: <https://gofr.dev/docs>
+- Concatenated full docs (one plaintext file): <https://gofr.dev/llms-full.txt>
+- Curated link index: <https://gofr.dev/llms.txt>
+- Changelog: <https://gofr.dev/changelog>
diff --git a/public/changelog.xml b/public/changelog.xml
new file mode 100644
index 0000000..77cedbe
--- /dev/null
+++ b/public/changelog.xml
@@ -0,0 +1,2500 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+  <channel>
+    <title>GoFr Releases</title>
+    <link>https://gofr.dev/changelog</link>
+    <atom:link href="https://gofr.dev/changelog.xml" rel="self" type="application/rss+xml"/>
+    <description>Release notes for GoFr — an opinionated Go framework for production microservices.</description>
+    <language>en-us</language>
+    <lastBuildDate>Fri, 01 May 2026 15:50:13 GMT</lastBuildDate>
+    <item>
+      <title>GoFr v1.56.4</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.56.4</link>
+      <guid isPermaLink="false">v1.56.4</guid>
+      <pubDate>Wed, 29 Apr 2026 16:16:02 GMT</pubDate>
+      <description><![CDATA[# Release v1.56.4
+
+## 🛠️ Fixes
+
+- **Kafka Stale Admin Connection** — Kafka subscribers got permanently stuck on `"kafka client not connected"` after the broker closed an idle TCP connection (default `connections.max.idle.ms = 10m`). The admin `multiConn` was dialed only once during `initialize()` and `retryConnect()` only covered initial startup, so every `Subscribe` / `Query` call failed for the rest of the process lifetime. Added `ensureConnected(ctx)` which detects a stale admin conn at the entry of `Subscribe` / `Query`, re-dials the broker list, and swaps in a fresh `multiConn` while leaving the writer and per-topic readers untouched so in-flight work isn't disrupted. No public API change.
+
+- **SwaggerUI Panic on Files Without Extension** — `SwaggerUIHandler` panicked with an index out of bounds error when serving filenames that had no extension, due to `strings.Split` + direct index access on the result. Replaced with `filepath.Ext` for safe extraction, and the handler now returns a defined `errMissingFileExtension` instead of panicking.]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.56.3</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.56.3</link>
+      <guid isPermaLink="false">v1.56.3</guid>
+      <pubDate>Tue, 21 Apr 2026 12:29:25 GMT</pubDate>
+      <description><![CDATA[# Release v1.56.3
+
+
+## 🛠️Fixes
+                                                                                                                                                                                     
+  - **Docs Build Prerender Crash** — Fixed an unclosed dotenv code block in the Pub/Sub advanced guide (`/docs/advanced-guide/using-publisher-subscriber`) that causediNext.jsftort throw `TypeError: Cannot read properties of undefined (reading 'toLowerCase')` during prerendering, breaking the `Dockerize` step of the v1.56.2 release workflow. ]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.56.2</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.56.2</link>
+      <guid isPermaLink="false">v1.56.2</guid>
+      <pubDate>Tue, 21 Apr 2026 11:35:07 GMT</pubDate>
+      <description><![CDATA[ # Release v1.56.2
+                                                                                                                                                                                     
+  ## 🛠️Fixes
+
+                                             
+  Consumer spans are now **real children of the producer's trace** across all Pub/Sub backends — Kafka, NATS, Google Pub/Sub, and SQS — while still preserving the existing OTel span link for fan-out semantics.                                                                                                                                                       
+                              
+  Previously, each consumer span started from a fresh root context, so an end-to-end publish/subscribe flow appeared as **multiple disconnected traces** in Jaeger, Tempo, and`tracer.gofr.dev`. Now the consumer span inherits the producer's trace ID and parent, giving you a single connected trace across all services with no extra configuration.         
+                                                                                                                                                                                                                                                          
+  - **Fan-out preserved** — span link is still attached for tools that surface fan-out semantics
+  - **Applies to**: Kafka, NATS, Google Pub/Sub, SQS            ]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.56.1</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.56.1</link>
+      <guid isPermaLink="false">v1.56.1</guid>
+      <pubDate>Thu, 09 Apr 2026 15:11:19 GMT</pubDate>
+      <description><![CDATA[## 🛠️ Fixes
+
+  - **Redis Streams PubSub CPU Busy-Spin** — When the message buffer was full, `subscribeToStream` looped at 100% CPU with no backoff because `consumeStreamMessages` returned immediately on zero capacity. Added a
+  `time.After` backoff using the existing `subscribeRetryInterval`, following the same pattern used in the Subscribe connection-wait loop.
+
+  - **Redis Streams Goroutine Leak on Shutdown** — The subscription context created in `ensureSubscription` was discarded (`_, cancel := ...`) and `runSubscriptionLoop` used a fresh `context.Background()`, making
+  goroutines impossible to cancel. The cancelable context is now propagated through the full call chain, and `Close()` no longer holds the write lock while waiting for goroutines (which previously caused a
+  guaranteed 5-second deadlock on every shutdown).
+
+  - **Redis Streams Reconnection Failure** — `resubscribeAll` was silently a no-op for streams — it canceled a context nobody held and never started a new goroutine. It now properly waits for old goroutines to exit
+   and starts new ones with fresh contexts, preserving the consumer name across resubscribes to maintain PEL ownership and prevent message loss.]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.56.0</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.56.0</link>
+      <guid isPermaLink="false">v1.56.0</guid>
+      <pubDate>Tue, 07 Apr 2026 11:57:02 GMT</pubDate>
+      <description><![CDATA[# Release v1.56.0
+
+## 🚀 Features
+
+🔹 **CORS Multiple Origins Support**
+
+GoFr's CORS middleware now supports **multiple allowed origins**, enabling fine-grained access control for applications serving multiple frontends or admin panels.
+- **Comma-Separated Origins**: Configure multiple origins via the `ACCESS_CONTROL_ALLOW_ORIGIN` environment variable
+- **Dynamic Origin Matching**: On each request, the `Origin` header is matched against the allowed set and only the matched origin is returned in the response (per HTTP spec)
+- **Correct Caching**: Adds `Vary: Origin` header when a specific origin is matched, ensuring proxies and CDNs cache responses correctly
+- **Fully Backward-Compatible**: Single origin and wildcard (`*`) work exactly as before
+
+**Configuration Example**
+```env
+# Single origin (existing behavior)
+ACCESS_CONTROL_ALLOW_ORIGIN=https://app.example.com
+
+# Multiple origins (new)
+ACCESS_CONTROL_ALLOW_ORIGIN=https://app.example.com,https://admin.example.com
+```
+
+## 🔧 Enhancements
+
+🔹 **Selective Migration Record Tracking**
+
+Migrations now only insert `gofr_migrations` records into databases that were **actually used** by the `UP` function, instead of all connected databases. Previously, running a migration that only touched MySQL would still insert migration records into Redis, MongoDB, Cassandra, and every other connected database — leading to phantom records, wasted I/O, and a misleading audit trail. Each datasource is now wrapped with lightweight usage-tracking before `UP()` executes, and only touched databases receive the migration record.
+
+## 🛠️ Fixes
+
+- **WebSocket Nil Pointer Panic** — Fixed a nil pointer dereference in `WriteMessageToSocket` when no WebSocket connection exists in the context. It now returns `ErrConnectionNotFound` instead of panicking.
+
+- **File Logger Descriptor Leak** — `NewFileLogger()` opens a file via `os.OpenFile` but previously had no way to close it, causing file descriptor leaks. Added a `Close()` method to the logger, which is now called during `App.Shutdown()` (HTTP/gRPC) and after `cmd.Run()` (CLI apps). `Fatal`/`Fatalf` also now call `file.Sync()` before exiting to flush buffered log data.
+
+- **Cron Job Duration Log Format** — Fixed `%!s(float64=...)` in cron job completion logs by keeping `duration` as `time.Duration` instead of converting to `float64`. Logs now show human-readable durations (e.g., `25.071286ms` instead of `%!s(float64=0.025071286)`).
+
+- **UpdateOne Breaking Change Reverted** — Reverted the `Mongo` interface's `UpdateOne` return type from `(int64, error)` back to `error`, fixing a breaking change introduced in v1.55.0. The migration lock refresh now uses `UpdateMany` (which already returns the needed `ModifiedCount`) with a filter that guarantees at most one document matches.
+
+- **Dependency Updates** — Consolidated minor dependency updates and bumped `github.com/go-jose/go-jose/v4` for security improvements.
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.55.0</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.55.0</link>
+      <guid isPermaLink="false">v1.55.0</guid>
+      <pubDate>Sat, 14 Mar 2026 20:39:44 GMT</pubDate>
+      <description><![CDATA[# Release v1.55.0
+
+## 🚀 Features
+
+### Native GraphQL Support
+GoFr now provides first-class **GraphQL** support using a schema-first approach. Define your API contract in `./configs/schema.graphqls`, register resolvers with `app.GraphQLQuery()` and `app.GraphQLMutation()`, and GoFr handles execution, validation, tracing, and metrics automatically.
+  - **Single Endpoint**: All operations served at `POST /graphql`
+  - **Interactive Playground**: Auto-hosted at `/.well-known/graphql/ui`
+  - **Full Observability**: Per-resolver OpenTelemetry tracing, operation-level metrics (`app_graphql_operations_total`, `app_graphql_error_total`, `app_graphql_request_duration`), and structured logs aligned with GoFr's existing format
+  - **Operation Name Extraction**: Automatically parses resolver names from the query AST for meaningful metric labels, even for anonymous operations
+  - **Grafana Dashboard**: GraphQL panels added to the standard GoFr dashboard with Response Time SLA, Request/Error Count, and Latency breakdowns by operation and type
+
+### gRPC Rate Limiter
+Built-in rate limiter interceptors for gRPC using a token bucket algorithm, supporting both unary and streaming RPCs.
+  - **Per-IP Rate Limiting**: Each client IP gets its own rate limit bucket
+  - **Shared or Separate Budgets**: Use a single store for combined limits or independent configs per call type
+  - **Prometheus Metrics**: Track violations via `app_grpc_rate_limit_exceeded_total` counter
+  - Returns `RESOURCE_EXHAUSTED` with `retry-after` metadata on limit exceeded
+
+### GCS Metadata Upload and Signed URL Generation
+Google Cloud Storage now supports cloud-specific operations beyond the standard filesystem interface.
+  - **`CreateWithOptions`**: Upload files with custom `Content-Type`, `Content-Disposition`, and arbitrary metadata
+  - **`GenerateSignedURL`**: Create time-limited, pre-authenticated download URLs
+  - **`file.AsCloud()`**: Safe type assertion helper to check cloud support
+
+## 🔧 Enhancements
+
+### NATS OpenTelemetry Span Links
+Added span link support for NATS JetStream PubSub operations, providing distributed tracing visibility into publish, subscribe, and commit operations.
+
+### gRPC Observability Improvements
+Client-side errors (e.g., `InvalidArgument`, `NotFound`, `ResourceExhausted`) are no longer logged at ERROR level — only server-side errors are. This reduces log noise in production.
+
+## 🛠️ Fixes
+
+- **Migration Race Condition** — Fixed a race condition where multiple pods starting simultaneously could execute the same migration concurrently. The migration state is now re-verified under the distributed lock before execution, preventing duplicate runs in multi-instance deployments.
+
+- **Zipkin Deprecation Warning** — `TRACE_EXPORTER=zipkin` now logs an actionable deprecation warning with migration instructions to OTLP (Zipkin supports OTLP natively since v2.24+).
+
+- **CI Workflow Updates** — Bumped Docker GitHub Actions (`setup-buildx-action`, `login-action`) from v3 to v4 in website deployment workflows.]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.54.6</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.54.6</link>
+      <guid isPermaLink="false">v1.54.6</guid>
+      <pubDate>Wed, 11 Mar 2026 06:17:01 GMT</pubDate>
+      <description><![CDATA[# Release v1.54.6
+
+## 🛠️ Fixes
+
+- ### PubSub Migration Conflict Resolution 
+Resolved an issue where the PubSub Migrator, particularly with Redis Streams, incorrectly reported migration versions based on historical data on the message bus.
+  - **Decoupled Versioning**: Made PubSub non-authoritative for migration state by removing it from the version chain. Migration tracking is now strictly confined to primary data stores that support atomicity and locking.
+  - **PubSub Still Available**: The PubSub client remains fully accessible in the `migration.Datasource` object for use in migration `UP` functions (e.g., `d.PubSub.CreateTopic()`).]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.54.5</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.54.5</link>
+      <guid isPermaLink="false">v1.54.5</guid>
+      <pubDate>Fri, 27 Feb 2026 13:32:05 GMT</pubDate>
+      <description><![CDATA[# Release v1.54.5
+
+## 🚀 Enhancements
+
+### 🔹 Google Pub/Sub Span Links for Tracing
+GoFr now supports OpenTelemetry span links for Google Cloud Pub/Sub, extending the tracing capabilities introduced for Kafka in [v1.54.4](https://github.com/gofr-dev/gofr/releases/tag/v1.54.4).
+- **End-to-End Traceability**: Connects producer and consumer spans across asynchronous Google Pub/Sub messaging, enabling complete request lifecycle visualization.
+- **Context Propagation**: Automatically injects and extracts trace context through Pub/Sub message attributes using the standard OpenTelemetry propagator.
+- **Semantic Conventions**: Follows OpenTelemetry messaging semantic conventions for consistent, standards-compliant spans and links.
+
+### 🔹 SQS Span Links for Tracing
+Added OpenTelemetry span links for AWS SQS, completing pub/sub tracing support across all major message brokers.
+- **AWS Observability**: Connects producer and consumer spans for SQS messages, providing full distributed tracing for AWS-based event-driven architectures.
+- **Attribute Propagation**: Leverages SQS message attributes for trace context propagation, enabling seamless correlation across services.
+- **Consistent Tracing**: Aligns with the same span link patterns used for Kafka and Google Pub/Sub for a unified observability experience.
+
+### 🔹 Oracle Migration Locks Management
+Extended migration locks support to Oracle datasources, building on the SQL & Redis locking introduced in [v1.54.3](https://github.com/gofr-dev/gofr/releases/tag/v1.54.3).
+- **Safe Concurrent Deployments**: In multi-instance deployments (e.g., Kubernetes), only one instance executes Oracle migrations at a time, preventing race conditions.
+- **Automatic Lock Lifecycle**: Manages lock acquisition, expiry-based cleanup, periodic refresh, and safe release with full PL/SQL-based error handling.
+- **Data Integrity**: Prevents corrupted migration states during parallel deployments against Oracle databases.
+
+## 🛠️ Fixes
+
+- ### Static File Path Traversal Prevention
+Resolved a security issue in the static file handler where sibling directory names could bypass the restricted file check.
+ - **Security Hardening**: Appended a path separator in [isRestrictedFile](cci:1://file:///Users/zopdev/Downloads/GolandProjects%202/gofr-repo/gofr/pkg/gofr/http/router.go:134:0-139:1) to ensure that sibling directories sharing a common prefix with the static directory (e.g., `/app/publicother` vs `/app/public`) cannot be traversed to serve unauthorized files.
+- **What's Restricted**: Files outside the configured static directory are blocked from being served. Additionally, direct access to `openapi.json` via static routes remains restricted — it is only accessible through the `/.well-known/swagger` or `/.well-known/openapi.json` endpoints.
+
+### 🔹 Kafka Subscribe Data Race
+Fixed a data race condition in the Kafka `Subscribe` method that could surface under concurrent access.
+- **Concurrency Safety**: Ensures thread-safe subscription handling, preventing unpredictable behavior in high-concurrency environments.
+
+### 🔹 Config Parsing Silent Failures
+Resolved an issue where invalid or missing configuration values would fail silently, making it difficult to diagnose misconfiguration issues.
+- **Better Error Reporting**: Added proper nil-checks and logging for configuration parsing, ensuring misconfigurations are surfaced through structured log messages instead of being swallowed silently.
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.54.4</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.54.4</link>
+      <guid isPermaLink="false">v1.54.4</guid>
+      <pubDate>Sat, 21 Feb 2026 12:45:31 GMT</pubDate>
+      <description><![CDATA[# Release v1.54.4
+
+## 🚀 Enhancements
+
+### 🔹 Kafka Span Links for Pub/Sub Tracing
+GoFr now supports OpenTelemetry span links for Kafka, significantly improving observability in event-driven systems.
+- **Improved Traceability**: Connects producer and consumer spans even in asynchronous messaging patterns, providing a complete picture of the request lifecycle.
+- **Enhanced Observability**: Users can now visualize the relationship between messages, making it easier to debug complex microservices interactions.
+- **Semantic Conventions**: Follows OpenTelemetry messaging semantic conventions for consistent spans and links.
+
+### 🔹 Metrics Export for Cron Jobs
+Introduced native support for exporting metrics for background tasks managed through Cron Jobs.
+- **Performance Monitoring**: Automatically tracks execution duration and success/failure counts for scheduled tasks.
+- **Better Visibility**: Allows developers to monitor the health and performance of background workers using the same telemetry stack as their HTTP services.
+- **Customizable**: Leverages GoFr's internal metrics provider for seamless integration with Prometheus or other exporters.
+
+## 🛠️ Fixes
+
+### 🔹 HTTP Server Auto-detection
+Resolved an issue where the HTTP server wouldn't start if only a static directory was auto-detected without any explicit route registration.
+- **Robust Static Hosting**: Ensures that applications serving only static content boot correctly and serve assets as expected.
+
+### 🔹 Reduced HTTP Shutdown Noise
+Optimized the server shutdown sequence to eliminate unnecessary log noise and warnings during graceful termination.
+- **Cleaner Logs**: Provides a more streamlined and less cluttered logging experience during application restarts and deployments.]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.54.3</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.54.3</link>
+      <guid isPermaLink="false">v1.54.3</guid>
+      <pubDate>Fri, 06 Feb 2026 11:20:14 GMT</pubDate>
+      <description><![CDATA[# Release v1.54.3
+
+## 🚀 Enhancements
+
+### 🔹 Migration Locking for SQL & Redis
+GoFr now implements automatic migration locking for SQL and Redis datasources.
+- **Automatic Coordination**: In multi-instance deployments (such as Kubernetes), instances effectively coordinate to ensure only one instance executes migrations at a time.
+- **Data Integrity**: This mechanism effectively prevents race conditions and corrupted migration states during parallel deployments.
+
+## 🛠️ Fixes
+
+- **Circuit Breaker Concurrency** - Resolved an issue where the Circuit Breaker was erroneously enforcing sequential execution on parallel HTTP requests. This fix restores the expected concurrent behavior, significantly improving throughput for service calls.
+
+- **Datasource Resource Management** - Fixed goroutine leaks that occurred during the shutdown process for SQL and Redis datasources. This ensures proper resource cleanup and cleaner application termination.
+
+- **Migration Version Consistency** - Fixed a bug where the last migration version was not being correctly fetched across the entire chain of datasources. This ensures accurate migration state tracking, particularly in multi-datasource configurations.]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.54.2</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.54.2</link>
+      <guid isPermaLink="false">v1.54.2</guid>
+      <pubDate>Sat, 31 Jan 2026 13:45:05 GMT</pubDate>
+      <description><![CDATA[# Release v1.54.2
+
+## 🚀 Enhancement
+
+### 🔹 Smart HTTP Server Activation
+GoFr now intelligently manages its internal server lifecycle, conditionally booting the HTTP stack only when relevant components are registered.
+- **Resource Efficiency**: Drastically reduces memory and CPU overhead for gRPC-only services or background workers by keeping dormant server components inactive.
+- **Automated Discovery**: Dynamically identifies the need for an HTTP server based on registered routes, static files, or custom handlers.
+- **Streamlined Footprint**: Prevents unnecessary port occupancy and improves application startup time for specialized services.
+
+## 🛠️ Fixes
+
+- **Panic Prevention in DB Metrics**: Added essential nil checks in the database operations logic to prevent potential panics during telemetry collection.
+
+- **Migration Version Chaining**: Fixed the chaining logic for fetching the last migration version to ensure consistency across complex deployments using multiple datasources.
+
+-  **Docker Compose Port Mappings**: Resolved incorrect port assignments for Redis and MySQL in the `http-server` example, streamlining the local development environment.
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.54.1</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.54.1</link>
+      <guid isPermaLink="false">v1.54.1</guid>
+      <pubDate>Tue, 27 Jan 2026 05:43:56 GMT</pubDate>
+      <description><![CDATA[# Release v1.54.1
+
+## 🚀 Features
+
+### 🔹 gRPC Authentication Middleware
+Introduced comprehensive authentication support for gRPC services, bringing it on par with HTTP services.
+- **Supported Methods**: Basic Authentication, API Key Authentication, and OAuth.
+- **Seamless Integration**: Easily enable authentication for gRPC unary and streaming handlers.
+- **Unified Auth Interface**: Leverages the existing authentication logic for consistency across protocols. Refer : 
+
+### 🔹 Standard OTEL Tracing for gRPC
+Enabled standard OpenTelemetry tracing for gRPC services.
+- **Automatic Instrumentation**: Automatically captures spans for gRPC requests and responses.
+- **Better Observability**: Provides detailed insights into gRPC service performance and call chains.
+
+## 🛠️ Fixes
+
+### 🔹 EventHub Consumer Group Fix
+- Resolved an issue where consumer groups were not being correctly interpreted in the EventHub datasource, ensuring reliable message consumption.
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.54.0</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.54.0</link>
+      <guid isPermaLink="false">v1.54.0</guid>
+      <pubDate>Sun, 18 Jan 2026 07:02:33 GMT</pubDate>
+      <description><![CDATA[# **v1.54.0**
+
+## :rocket: Features
+
+:small_blue_diamond: **Server-Side Rate Limiter Middleware**
+
+GoFr now includes a built-in **Rate Limiter Middleware** to protect your APIs from abuse and ensure fair resource distribution.
+- **Token Bucket Algorithm**: Implements smooth rate limiting with configurable burst capacity.
+- **Per-IP Rate Limiting**: Support for independent limits per client IP with trusted proxy support (`X-Forwarded-For`, `X-Real-IP`).
+- **Observability**: Automatically tracks rate limit violations with the `app_http_rate_limit_exceeded_total` metric.
+- **Exemptions**: Built-in health check endpoints (`/.well-known/alive`, `/.well-known/health`) are automatically exempt.
+
+**Usage Example**
+```go
+    app.UseMiddleware(middleware.RateLimiter(middleware.RateLimiterConfig{
+        RequestsPerSecond: 10,
+        Burst:             20,
+        PerIP:             true,
+    }, app.Metrics()))
+```
+
+## 🛠️ Fixes
+
+:small_blue_diamond: **Circuit Breaker & Health Check Refinement**
+
+Improved the reliability of the Circuit Breaker and Health Check mechanisms:
+- **Custom Health Endpoints**: Fixed an issue where custom health endpoints were not consistently used by the circuit breaker for recovery checks.
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.53.0</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.53.0</link>
+      <guid isPermaLink="false">v1.53.0</guid>
+      <pubDate>Sat, 10 Jan 2026 10:03:16 GMT</pubDate>
+      <description><![CDATA[# **Release v1.53.0**
+
+## 🚀 Features
+
+🔹 **Amazon SQS PubSub Support**
+
+GoFr now supports **Amazon SQS** as a messaging backend, enabling seamless integration with AWS Simple Queue Service for building resilient, distributed microservices.
+
+- Supports both **Publishing** and **Subscribing** to SQS standard queues
+- **Configurable Behavior**:
+  - Support for custom message attributes
+  - Configurable visibility timeouts and wait times
+  - Support for standard queues
+
+#### **Usage Example**
+
+To use Amazon SQS, import the driver and add it to your application:
+
+```go
+import (
+    "gofr.dev/pkg/gofr"
+    "gofr.dev/pkg/gofr/datasource/pubsub/sqs"
+)
+
+func main() {
+    app := gofr.New()
+
+    app.AddPubSub(sqs.New(&sqs.Config{
+        Region:          "us-east-1",
+        AccessKeyID:     "your-access-key-id",     // optional if using IAM roles
+        SecretAccessKey: "your-secret-access-key", // optional if using IAM roles
+        // Endpoint:     "http://localhost:4566", // optional: for LocalStack
+    }))
+
+    app.Subscribe("my-queue", func(ctx *gofr.Context) error {
+        // Process message
+        return nil
+    })
+
+    app.Run()
+}
+```
+
+## 🚀 Enhancements
+
+🔹 **Metrics for HTTP Service Resilience**
+
+Enhanced observability for inter-service communication by adding dedicated metrics for resilience patterns.
+- New metric `app_http_retry_count`: Tracks the total number of retries performed for each downstream service
+- New metric `app_http_circuit_breaker_state`: A gauge tracking the current state (0 for Closed, 1 for Open) of the circuit breaker
+- **Updated Grafana Dashboards**: Included new panels to visualize retry events and circuit breaker transitions, providing immediate insights into service stability and failure patterns. You can refer : https://github.com/gofr-dev/gofr/tree/main/examples/http-server/docker/provisioning/dashboards/gofr-dashboard
+
+🔹 **Configurable Metrics Server**
+
+Added the ability to **disable the internal metrics server** by setting the `METRICS_PORT` environment variable to `0`. This provides greater flexibility for users who prefer to handle metrics collection through external agents or in environments where a separate metrics port is not required.
+
+## 🛠️ Fixes
+
+🔹 **Zip Slip Vulnerability Protection**
+
+Improved the security of the `file/zip` package by implementing protection against **Zip Slip** (path traversal) attacks.
+- Automatically validates file paths during extraction to ensure they remain within the target directory
+- Rejects zip entries containing absolute paths or parent directory traversal sequences (`..`)
+- Ensures safe handling of compressed files from untrusted sources
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.52.0</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.52.0</link>
+      <guid isPermaLink="false">v1.52.0</guid>
+      <pubDate>Fri, 02 Jan 2026 13:45:04 GMT</pubDate>
+      <description><![CDATA[# **Release v1.52.0**
+
+## 🚀 Features
+
+🔹 **Redis PubSub Support**
+
+GoFr now supports **Redis PubSub** as a messaging backend, providing seamless integration with Redis for publish-subscribe patterns in microservices.
+
+- Supports both **Redis Channels** (traditional PubSub) and **Redis Streams** modes
+- Configurable via `REDIS_PUBSUB_MODE` environment variable (defaults to `streams`)
+- **Redis Streams** features:
+  - Consumer groups for load balancing and message distribution
+  - Automatic consumer group creation with `MKSTREAM` support
+  - Configurable PEL (Pending Entry List) ratio for balancing pending vs new messages (default: 0.7, i.e., 70% PEL, 30% new messages)
+  - Stream length management with `MaxLen` configuration
+  - Automatic message acknowledgment handling
+- **Redis Channels** features:
+  - Traditional PubSub channel support for simple messaging patterns
+  - Automatic channel creation on first publish/subscribe
+- Separate database support via `REDIS_PUBSUB_DB` to prevent keyspace collisions (defaults to database 15)
+- Configurable buffer size, query timeout, and query limits
+- Automatic connection monitoring and resubscription on reconnection
+- Full observability with metrics, logging, and distributed tracing
+- Graceful error handling with permanent failure detection
+
+---
+
+## 🚀 Enhancements
+
+🔹 **HTTP Router Path Normalization**
+
+Router now **normalizes paths before routing** to handle edge cases with double slashes and malformed paths.
+
+- Automatically cleans and normalizes request paths using `path.Clean()`
+- Handles empty paths, double slashes, and trailing slashes consistently
+- Ensures proper routing behavior regardless of path formatting in requests
+- Improves compatibility with various HTTP clients and reverse proxies
+
+---
+
+## 🛠️ Fixes
+
+🔹 **JSON Encoding Error Handling for NaN Values**
+
+Fixed a bug where `math.NaN()` values in responses caused incorrect error handling. The responder now properly handles JSON encoding failures by:
+
+- Detecting encoding errors before writing response headers
+- Returning appropriate `500 Internal Server Error` status code for encoding failures
+
+🔹 **Grafana Dashboard Configuration**
+
+Fixed Grafana dashboard configuration to ensure proper metrics visualization and monitoring capabilities.]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.51.0</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.51.0</link>
+      <guid isPermaLink="false">v1.51.0</guid>
+      <pubDate>Sat, 27 Dec 2025 10:02:47 GMT</pubDate>
+      <description><![CDATA[# Release v1.51.0
+
+## 🚀 Features
+
+### 🔐 Role-Based Access Control (RBAC)
+
+GoFr introduces a **config-driven RBAC middleware** for enforcing authorization across HTTP APIs without adding role or permission logic inside handlers.
+
+---
+
+### Key Highlights
+
+* Authorization defined entirely via **JSON/YAML configuration**
+* **Permission-based model**
+
+  * Roles define permissions
+  * Endpoints require permissions
+* **Header-based and JWT-based role extraction**
+
+  * JWT-based RBAC supported via GoFr OAuth
+  * JWT takes precedence when both are configured
+* **Role inheritance** support
+* **Exact permission matching** (no wildcards)
+* **Gorilla/mux-compatible route matching**
+
+  * Supports path variables and constraints
+* **Safe-by-default enforcement**
+
+  * Only routes defined in RBAC config are enforced
+
+---
+
+### Usage
+
+Enable RBAC using default config paths:
+
+```go
+app := gofr.New()
+app.EnableRBAC()
+```
+
+Or specify a custom RBAC config file:
+
+```go
+app.EnableRBAC("configs/rbac.json")
+```
+
+---
+
+### JWT Integration
+
+RBAC integrates with GoFr OAuth for JWT-based authorization:
+
+```go
+app.EnableOAuth("https://auth.example.com/.well-known/jwks.json", 10)
+app.EnableRBAC("configs/rbac.json")
+```
+
+Roles are extracted from JWT claims using configurable claim paths.
+
+---
+
+### Observability
+
+* Debug logs include route matching and authorization decision details.
+* **Roles are excluded** from traces  to avoid PII leakage.
+
+
+📚 **Documentation**
+Refer to the RBAC documentation for configuration details and advanced usage.
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.50.2</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.50.2</link>
+      <guid isPermaLink="false">v1.50.2</guid>
+      <pubDate>Sun, 21 Dec 2025 17:05:13 GMT</pubDate>
+      <description><![CDATA[# **Release v1.50.2**
+
+## 🚀 Enhancements
+
+🔹 **HTTP Connection Pool Configuration**
+
+GoFr now supports **configurable HTTP connection pool settings** to optimize performance for high-frequency HTTP requests in microservices.
+
+New `ConnectionPoolConfig` option for `AddHTTPService()` method
+
+Configurable settings:
+
+-  `MaxIdleConns`: Maximum idle connections across all hosts (default: 100)
+-  `MaxIdleConnsPerHost`: Maximum idle connections per host (default: 2, recommended: 10-20)
+-  `IdleConnTimeout`: Connection keep-alive duration (default: 90 seconds)
+- Addresses the limitation where Go's default `MaxIdleConnsPerHost: 2` is insufficient for microservices
+-  **Important**: `ConnectionPoolConfig` must be applied first when using multiple options  
+
+
+🔹 **OpenTSDB Metrics Support**
+
+Added metrics instrumentation for OpenTSDB operations to provide better observability.
+
+New metrics:
+-  `app_opentsdb_operation_duration`: Duration of OpenTSDB operations in milliseconds
+-  `app_opentsdb_operation_total`: Total OpenTSDB operations
+- Enables monitoring and alerting on OpenTSDB data operations
+
+---
+  
+
+## 🛠️ Fixes
+
+🔹 **Panic Recovery for OnStart Hooks**
+Added panic recovery mechanism for `OnStart` hooks to prevent entire application crash. If a hook panics, the error is logged and the application continues with other hooks, improving application stability and resilience.
+
+🔹 **GCS Provider Name for Observability**
+Added provider name "GCS" to Google Cloud Storage file store for improved logging and metrics identification. Previously it used common logging semantics "COMMON" shared across file storage providers leading to improper visibilty of the underlying file storage being used,
+
+🔹 **Zipkin Trace Exporter Error Handling**
+Fixed error logging for successful trace exports (2xx status codes). Zipkin exporter now correctly ignores `201` status codes and other `2xx` responses, reducing noise in error logs for successful operations.]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.50.1</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.50.1</link>
+      <guid isPermaLink="false">v1.50.1</guid>
+      <pubDate>Sun, 14 Dec 2025 13:55:15 GMT</pubDate>
+      <description><![CDATA[# **Release v1.50.1**
+
+## 🚀 Enhancements
+
+🔹  **TLS / SSL Support for Database Connections**
+
+GoFr now supports  **secure TLS/SSL connections**  for relational databases(MySQL / MariaDB/PostgreSQL), improving security and compliance for production deployments.
+
+-   New configuration  `DB_SSL_MODE`  with supported modes:
+    
+    -   `disable`,  `preferred`,  `require`,  `skip-verify`,  `verify-ca`,  `verify-full`
+        
+-   New environment variables for TLS configuration:
+    
+    -   `DB_TLS_CA_CERT`
+        
+    -   `DB_TLS_CLIENT_CERT`
+        
+    -   `DB_TLS_CLIENT_KEY`
+        
+-   `verify-ca`  and  `verify-full`  modes enforce  **CA certificate validation**
+    
+-   **Mutual TLS (mTLS)**  supported via client certificate & key
+- Refer [Documentation : Tracing In GoFr](https://gofr.dev/docs/quick-start/observability#tracing) for more info.
+----------
+
+🔹  **Custom Authentication Headers for Tracing Exporters**
+
+GoFr now allows configuring  **custom authentication headers**  for OpenTelemetry exporters, enabling better compatibility with hosted observability platforms.
+
+Key Highlights:
+
+-   New configuration:  `TRACER_HEADERS`
+    
+    -   Accepts  **comma-separated key=value pairs**
+        
+    -   Example:  `X-Api-Key=secret,Authorization=Bearer token`
+        
+-   `TRACER_HEADERS`  takes priority over the existing  `TRACER_AUTH_KEY`
+-  Refer [Documentation : Connecting MySQL](https://gofr.dev/docs/quick-start/connecting-mysql) for more info.
+
+## 🛠️ Fixes
+
+🔹  **Mock HTTP Services Deduplication in Tests**
+
+Fixed an issue where registering multiple mock HTTP services could result in  **deduplication**, causing missing mocks and lost expectations during tests.
+
+Fix Details:
+
+-   Each service registered via  `WithMockHTTPService(...)`  now receives a  **distinct mock instance**
+    
+-   Expectations must be set per service using: `mocks.HTTPServices["serviceName"]`
+        
+- Refer [Documentation : Testing in GoFr](https://gofr.dev/docs/references/testing) for more info.]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.50.0</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.50.0</link>
+      <guid isPermaLink="false">v1.50.0</guid>
+      <pubDate>Sat, 06 Dec 2025 07:16:16 GMT</pubDate>
+      <description><![CDATA[# **Release v1.50.0**
+
+## 🚀Features
+
+🔹  **Azure File Storage Support — New File-Store Provider**
+
+GoFr now introduces  **native Azure File Storage integration**  through a new provider at  
+`gofr.dev/pkg/gofr/datasource/file/azure`.
+
+Key Highlights:
+
+-   Supports configuration via  **AccountName**,  **AccountKey**, and  **ShareName**  (optional:  **Endpoint**)
+-   Automatic  **connection retry loop**  with connection-status logging
+-   **Native directory support**  —  `Chdir`,  `ReadDir`, and  `Stat`  behave like a real filesystem
+-   **Automatic parent-directory creation**  for nested file paths
+-   Built-in  **content-type detection**  based on extension (`json`,  `txt`,  `csv`,  `xml`,  `html`,  `pdf`, etc.)
+-   One file share  **per file-store instance**  (explicitly documented)
+-   Complete documentation & examples added under  [Official File Handling in GoFr Documentation](https://gofr.dev/docs/advanced-guide/handling-file/page.md)
+
+### **Example**
+
+```go
+// Create Azure File Storage filesystem
+fs, err := azure.New(&azure.Config{
+    AccountName: "mystorageaccount",
+    AccountKey:  "myaccountkey",
+    ShareName:   "myshare",
+    // Endpoint is optional, defaults to https://{AccountName}.file.core.windows.net
+    // Endpoint: "https://custom-endpoint.file.core.windows.net",
+})
+
+if err != nil {
+    app.Logger().Fatalf("Failed to initialize Azure File Storage: %v", err)
+}
+
+app.AddFileStore(fs)
+
+app.Run()
+```
+
+🔹  **CLI Improvements**
+
+-   More helpful  `ErrCommandNotFound`  message showing the  **invalid command entered**
+-   Better help formatting with  **aligned command–description columns**
+-   Enhanced behavior for no-command scenarios: prints help + clearer messaging if added.
+    
+
+
+## Bug Fixes 
+
+- **Basic Auth Header Normalization**
+Authorization header now correctly uses  **"Basic "** instead of **"basic "** adhering to RFC standard for Basic Authorization Headers.]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.49.0</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.49.0</link>
+      <guid isPermaLink="false">v1.49.0</guid>
+      <pubDate>Fri, 28 Nov 2025 16:14:37 GMT</pubDate>
+      <description><![CDATA[# **Release v1.49.0**
+
+## 🚀 New Features
+
+🔹 **DB Resolver for MySQL Read/Write Splitting**
+
+GoFr introduces a powerful, production-ready **DBResolver** module that enables automatic **read/write splitting** between a primary database and multiple replicas.
+
+**Key Highlights:**
+
+* Automatic routing based on **HTTP methods**:
+
+  * Writes (`POST`, `PUT`, `PATCH`, `DELETE`) → **Primary**
+  * Reads (`GET`, `HEAD`, `OPTIONS`) → **Replicas**
+* Route-based overrides using `PrimaryRoutes` for strongly consistent paths
+* Pluggable read-balancing strategies:
+
+  * **Round-robin**
+  * **Random**
+* Built-in **circuit breaker** for tracking replica failures & recovery
+* Full integration through `dbresolver.InitDBResolver()`
+* Unlocks **horizontal scaling** for read-heavy services
+* Significantly reduces read latency
+* Ensures high resilience with automatic failover to primary when replicas are down
+
+**Additional Details:**
+
+**Installation**
+
+```bash
+go get gofr.dev/pkg/gofr/datasource/dbresolver@latest
+```
+
+**Initializing DBResolver**
+
+```go
+import (
+    "gofr.dev/pkg/gofr"
+    "gofr.dev/pkg/gofr/datasource/dbresolver"
+)
+
+func main() {
+    a := gofr.New()
+
+    err := dbresolver.InitDBResolver(a, &dbresolver.Config{
+        Strategy:     dbresolver.StrategyRoundRobin,
+        ReadFallback: true,     // fallback to primary if all replicas fail
+        MaxFailures:  3,        // mark replica down after 3 failures
+        TimeoutSec:   30,       // cooldown before retrying
+        PrimaryRoutes: []string{
+            "/admin",
+            "/api/payments/*",
+        },
+        Replicas: []dbresolver.ReplicaCredential{
+            {Host: "localhost:3307", User: "replica_user1", Password: "pass1"},
+            {Host: "replica2.example.com:3308", User: "replica_user2", Password: "pass2"},
+            {Host: "replica3.example.com:3309", User: "replica_user3", Password: "pass3"},
+        },
+    })
+
+    if err != nil {
+        a.Logger().Errorf("failed to initialize db resolver: %v", err)
+    }
+
+    a.Run()
+}
+```
+
+**Read Endpoint (Auto → Replica)**
+
+```go
+a.GET("/customers", func(c *gofr.Context) (any, error) {
+    var out []Customer
+    c.SQL.Select(c, &out, "SELECT id, name FROM customers")
+    return out, nil
+})
+```
+
+**Write Endpoint (Auto → Primary)**
+
+```go
+a.POST("/customers", func(c *gofr.Context) (any, error) {
+    var cust Customer
+    c.Bind(&cust)
+
+    _, err := c.SQL.Exec("INSERT INTO customers (name) VALUES (?)", cust.Name)
+    return cust, err
+})
+```
+
+**Forced Primary Route**
+
+```go
+a.GET("/admin/customers", func(c *gofr.Context) (any, error) {
+    var out []Customer
+    c.SQL.Select(c, &out, "SELECT id, name FROM customers")
+    return out, nil
+})
+```
+
+
+🔹 **XML Responses (response.XML)**
+
+GoFr now supports **raw XML responses** without JSON encoding by using `response.XML`.
+
+**Key Highlights:**
+
+* Writes raw XML bytes directly to the client
+* Default `Content-Type = application/xml`
+* Perfect for legacy and enterprise XML-based systems
+
+**Example:**
+
+```go
+app.GET("/legacy/xml", func(ctx *gofr.Context) (any, error) {
+    content := []byte(`<Response status="ok"><Message>Hello</Message></Response>`)
+    return response.XML{Content: content}, nil
+})
+```
+
+**XML Output**
+
+```xml
+<Response status="ok"><Message>Hello</Message></Response>
+```
+
+## 📦 Improvements
+
+🔹 **Responder Improvements**
+
+* Special response types (`Raw`, `File`, `Template`, `XML`, `Redirect`) now follow a unified handling flow
+* Avoids incorrect `206 Partial Content` responses
+* Ensures default JSON `Content-Type`
+
+🔹 **DBResolver Pooling Controls**
+
+Replica pools now scale relative to primary pools. Defaults:
+
+* Primary: `DB_MAX_IDLE_CONNECTION=2` → Replicas default to `8`
+* Primary: `DB_MAX_OPEN_CONNECTION=20` → Replicas default to `40`
+
+Optional overrides:
+
+```env
+DB_REPLICA_MAX_IDLE_CAP=100
+DB_REPLICA_MIN_IDLE=5
+DB_REPLICA_DEFAULT_IDLE=15
+DB_REPLICA_MAX_OPEN_CAP=500
+DB_REPLICA_MIN_OPEN=20
+DB_REPLICA_DEFAULT_OPEN=150
+```
+
+## 🐛 Bug Fixes & Small Changes
+
+🔹 **Authentication Timing Attack Protection**
+
+* API Key and Basic Auth now use consistent time comparisons
+
+
+Refer : **GoFr Official Documentation**
+[https://gofr.dev/docs](https://gofr.dev/docs)]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.48.0</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.48.0</link>
+      <guid isPermaLink="false">v1.48.0</guid>
+      <pubDate>Fri, 21 Nov 2025 17:36:33 GMT</pubDate>
+      <description><![CDATA[# **Release v1.48.0**
+
+## 🚀 New Features
+
+🔹  **Unified Token-Bucket Rate Limiter for HTTP Clients**
+
+GoFr introduces a brand-new, pluggable  **rate limiter**  that works across all HTTP client calls.
+
+Key Highlights:
+-   Supports  **in-memory**  and  **Redis-backed**  stores
+-   Simple drop-in integration via  `RateLimiterConfig`  or  `AddOption`
+-   Integer-only token bucket with  **burst**  support
+-   Background cleanup for local buckets
+-   Customizable request grouping using  `KeyFunc`
+    
+
+Why this matters:
+-   Ensures  **consistent throttling**  across all downstream HTTP services
+-   Distributed apps can now safely rate-limit using  **Redis**
+    
+
+Additional Details :
+-   Default limit:  **60 req/min**, burst  **10**
+-   Returns  **RateLimitError (429)**  with  `RetryAfter`  for easy handling.
+    
+
+## 📦 Improvements
+
+🔹  **HTTP Client Enhancements with Rate Limiting**
+
+-   Rate limiter now acts as an  **HTTP wrapper**, intercepting all Get/Post/Put/Delete calls (including header variants)
+    
+-  Service key normalization improved via default keying (`scheme://host`)
+    
+-   Cleaner validation through  `RateLimiterConfig.Validate()`  with automatic sane defaults
+    
+
+🔹  **SQL Operation Normalization**
+
+-   SQL operation detection now always returns  **UPPERCASE**  keywords. Improves reliability for middleware and query inspection logic.
+    
+
+🔹  **OAuth Token URL Validation Cleanup**
+
+-   Switched to  **shared scheme constants**  (`http`  /  `https`). Reduces duplicated literals and improves code clarity
+
+
+## 🐛 Bug Fixes & Small Changes
+
+🔹  **Consistent SQL Operation Detection**
+
+-   `getOperationType()`  now normalizes to  **uppercase**, preventing case-sensitivity issues across modules
+    
+
+🔹  **Documentation Updates**
+
+-  **HTTP communication guide**  adds all details to add rate-limiter in your registered HTTP Services. Added examples for:
+    -   In-memory usage
+    -   Redis-backed multi-instance usage
+    -   Custom keying functions
+-  Added Documentation to setup gRPC Streaming Services/Clients using GoFr.
+
+Refer : [GoFr Official Documentation](https://gofr.dev/docs)]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.47.1</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.47.1</link>
+      <guid isPermaLink="false">v1.47.1</guid>
+      <pubDate>Tue, 18 Nov 2025 11:46:54 GMT</pubDate>
+      <description><![CDATA[# **Release v1.47.1**
+
+## 📊 Enhancements
+
+🔹  **Unified Datasource Histogram Buckets**
+
+GoFr now uses a shared  `getDefaultDatasourceBuckets()`  across  **SQL**,  **Redis**, and other datasources.
+Benefits:
+
+-   Standardized buckets from  **0.05ms → 30s**  
+-   Consistent observability across datasources
+-   Improved monitoring fidelity in Prometheus/Grafana
+-   Easier cross-datasource latency comparison
+    
+
+🔹  **ArangoDB v2.1.6 Compatibility & API Upgrade**
+
+Updated GoFr’s ArangoDB datasource to align with the latest  `github.com/arangodb/go-driver/v2 v2.1.6`  driver.  This upgrade ensures smooth integration with modern ArangoDB clusters and removes legacy API inconsistencies.
+
+Key Highlights:
+
+-   Migrated collection creation to **CreateCollectionV2**  /  **CreateCollectionWithOptionsV2**
+-   Ensures correct handling of  **edge**  and  **document**  collection types
+
+
+## 🛠️ Bug Fixes
+
+### **ArangoDB Database Creation – No More False Failures**
+
+Previously, calling  `CreateDatabase()`  on an existing DB caused unnecessary user-visible errors.
+Fix Summary:
+
+-   Added an existence check before creating databases
+-   Prevents duplicate-create errors
+-   Ensures smooth provisioning flows during app startup or migrations
+    
+###  **ArangoDB Collection Type Handling Corrected**
+
+Edge collections were previously misconfigured due to missing or incorrect Type assignment.
+Fix Summary - 
+-   Explicit  `Type`  handling added for  **edge vs document**  collections
+-   Ensures correct metadata and relationship behavior
+-   Updated tests to validate collection-type correctness]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.47.0</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.47.0</link>
+      <guid isPermaLink="false">v1.47.0</guid>
+      <pubDate>Fri, 07 Nov 2025 16:56:09 GMT</pubDate>
+      <description><![CDATA[# Release v1.47.0
+
+## ✨ Features  
+
+#### 🔹 GCS File System Integration  
+
+Introduced **Google Cloud Storage (GCS) File System** as a new implementation of the GoFr `FileSystem` interface.  This enables seamless integration with GCS while maintaining consistent behavior across existing backends like S3, FTP, and SFTP.
+
+**Supported Methods:**
+
+```go
+type FileSystem interface {
+    Create(name string) (File, error)
+    Mkdir(name string, perm os.FileMode) error
+    MkdirAll(path string, perm os.FileMode) error
+    Open(name string) (File, error)
+    OpenFile(name string, flag int, perm os.FileMode) (File, error)
+    Remove(name string) error
+    RemoveAll(path string) error
+    Rename(oldname string, newname string) error
+    ReadDir(dir string) ([]FileInfo, error)
+    Stat(name string) (FileInfo, error)
+    ChDir(dirname string) error
+    Getwd() (string, error)
+}
+```
+-   Consistent and unified interface for GCS, S3, FTP, and SFTP file operations.
+-   Plug-and-play compatibility with GoFr’s file abstraction layer.
+-   Production-ready with proper error wrapping, retries, and structured logging.
+-   Simplifies backend switching without changing application logic.
+    
+
+For detailed usage, visit 👉  [GoFr Docs — GCS File System](https://gofr.dev/docs/advanced-guide/handling-file)
+
+----------
+
+### 🛠️ Bug Fixes
+
+#### Remote Logger — Improper JSON Log Formatting
+Previously, ANSI color codes and non-ASCII characters appeared in JSON logs, breaking downstream log parsers.
+
+**Example of affected log output:**
+
+```json
+{"level":"DEBUG","time":"2025-09-17T17:54:30.625115633Z","message":"\u001b[38;5;8m5460fd91feac021fd633b5989abdeb26 \u001b[38;5;34m200   \u001b[0m     5855\u001b[38;5;8mµs\u001b[0m GET https://myurl","gofrVersion":"v1.45.0"}
+
+```
+
+**Fix Summary:**
+
+-   Removed ANSI color codes and non-ASCII characters from JSON logs.
+-   Preserved terminal log colors for local debugging.
+-   Ensured all remote JSON logs are now ASCII-safe and parseable by log processors (ELK, Loki, Cloud Logging, etc.).
+    
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.46.3</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.46.3</link>
+      <guid isPermaLink="false">v1.46.3</guid>
+      <pubDate>Fri, 17 Oct 2025 14:17:15 GMT</pubDate>
+      <description><![CDATA[# Release v1.46.3
+
+
+## Enhancements
+
+### **Custom Content-Type Support**: 
+GoFr now allows respective custom content types in HTTP responses and only sets it as JSON when not explicitly present. This enhancement provides developers with greater flexibility in controlling response formats, enabling support for various content types like XML, plain text, or custom formats while maintaining JSON as the sensible default.
+
+## Fixes
+
+-   **Fixed Remote Log Level Fatal Exit Issue**: Resolved a critical bug where changing to fatal level at remote log level was causing the application to exit unexpectedly. This fix ensures that remote logging operations no longer trigger unintended application termination, improving stability and reliability in production environments.]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.46.2</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.46.2</link>
+      <guid isPermaLink="false">v1.46.2</guid>
+      <pubDate>Fri, 10 Oct 2025 14:25:33 GMT</pubDate>
+      <description><![CDATA[## Release v1.46.2
+
+**GoFr core package now has 81% test coverage!**  🎉  
+This milestone boosts stability, reliability, and makes contributions safer and easier.
+
+-  Faster CI and more maintainable code
+    
+-   🔜 Upcoming: CLI to make your life easier.
+    
+
+**GoFr — Opinionated, Performant, Observable**  https://gofr.dev
+
+ 
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.46.1</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.46.1</link>
+      <guid isPermaLink="false">v1.46.1</guid>
+      <pubDate>Tue, 07 Oct 2025 06:25:18 GMT</pubDate>
+      <description><![CDATA[## Release v1.46.1
+
+
+### 🚀 Enhanced Telemetry Service
+
+We’ve enhanced GoFr’s  **telemetry**  to provide better insights into framework usage and runtime behavior.  This improvement enables more accurate tracking of key runtime data to help us optimize performance and stability in future releases.
+
+Telemetry is  **enabled by default**  and can be disabled anytime by setting:
+
+```bash
+export GOFR_TELEMETRY=false
+```
+ 
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.46.0</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.46.0</link>
+      <guid isPermaLink="false">v1.46.0</guid>
+      <pubDate>Fri, 26 Sep 2025 17:10:55 GMT</pubDate>
+      <description><![CDATA[## Release v1.46.0
+
+### ✨ Features
+
+🔹  **OracleDB Migration Support**
+
+-   Added  **OracleDB migrations with transaction support**.
+-   Enables safe schema evolution with  **begin/commit/rollback**  semantics for Oracle-specific migrations.
+    
+
+###  🛠️ Bug Fixes
+
+- **Custom Metrics Naming with OpenTelemetry**
+Previously, all custom metrics were forced to include a  `_total`  suffix, causing incorrect or duplicate metric names due to internal upgradation of OTEL Package. Now, Metrics can be defined without the mandatory suffix and behave as originally intended.
+    
+
+- **EventHub Subscription Fix**
+Previously, EventHub subscribers were unable to consume events published in the system. Now, Subscribers can successfully receive and process published events.
+
+### ✨ Developer Experience
+
+- **Docker Setup for HTTP Server Example**
+Improved the  **Docker setup**  for the demo  `http-server`. You can now explore and run it easily at:  
+    👉  [`gofr/examples/http-server`](https://github.com/gofr-dev/gofr/tree/development/examples/http-server)
+ 
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.45.0</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.45.0</link>
+      <guid isPermaLink="false">v1.45.0</guid>
+      <pubDate>Fri, 12 Sep 2025 14:01:09 GMT</pubDate>
+      <description><![CDATA[## Release v1.45.0
+
+### ✨ Features
+
+🔹  **DynamoDB Key-Value Store Support**
+
+-   Added full  **DynamoDB support**  as a GoFr KVStore implementation.   
+-   Features include: health checks, connection lifecycle management, JSON helper utilities, structured logging, OpenTelemetry tracing, and mock support for testing.
+    
+   - Import the gofr's external driver for DynamoDB:
+		```shell=
+		go get gofr.dev/pkg/gofr/datasource/kv-store/dynamodb@latest
+		```
+		**How to use DynamoDB in GoFr**:
+
+		```go
+		db := dynamodb.New(dynamodb.Configs{
+		    Table:            "gofr-kv-store",
+		    Region:           "us-east-1",
+		    Endpoint:         "http://localhost:8000", // For local dev
+		    PartitionKeyName: "pk",
+		})
+		```
+
+		For full documentation, checkout 👉  [gofr.dev/docs](https://gofr.dev/docs)]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.44.2</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.44.2</link>
+      <guid isPermaLink="false">v1.44.2</guid>
+      <pubDate>Mon, 08 Sep 2025 14:14:25 GMT</pubDate>
+      <description><![CDATA[# Release v1.44.2
+
+## 🚀 Enhancements
+
+### 🔹 Go Version Update
+
+-   Upgraded  **Go to v1.25.0**  across all modules and workflows.
+    
+
+### 🔹 Remote Logger Optimization
+
+- Remote Logger produced excessive logs and wasn’t thread-safe. As an enhancement now all the successive remote logger calls will automatically shift to debug, reducing log noise.
+
+## 🛠️ Bug Fixes
+
+- ### Config Loading System
+
+Previously, File-based configs overwrote system environment variables. Now, System env vars always take precedence, with refactored loading logic and better error handling.
+    
+
+- ### WebSocket Implementation
+Previously, context retrieval was unreliable, methods weren’t fully thread-safe, and errors like  _broken pipe_  caused crashes. This has been fixed. Websocket has context-based connection handling, thread-safe methods (Read/Write/Deadline), improved error handling, concurrency-safe tests, and cleaner startup/shutdown.
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.44.1</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.44.1</link>
+      <guid isPermaLink="false">v1.44.1</guid>
+      <pubDate>Mon, 01 Sep 2025 11:00:58 GMT</pubDate>
+      <description><![CDATA[# Release v1.441.
+
+## 🚀 Enhancement
+
+### 🔹 Client Cancellation Handling 
+
+-   GoFr now returns  **HTTP 499 “Client Closed Request”**  when a request is canceled (`context.Canceled`) and logs it at  **ERROR**  level.
+
+
+## 🛠️ Fixes
+
+- ### Request Timeout Handling 
+
+    Previously, `500` status codes were received for context errors. GoFr now correctly returns  **HTTP 504 “Gateway Timeout”**  when a request exceeds its deadline (`context.DeadlineExceeded`) and logs it at  **ERROR**  level.
+
+
+    
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.44.0</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.44.0</link>
+      <guid isPermaLink="false">v1.44.0</guid>
+      <pubDate>Thu, 21 Aug 2025 12:40:56 GMT</pubDate>
+      <description><![CDATA[# v1.44.0
+
+## 🚀 Features
+
+### 🔹 Correlation ID Access in GoFr Context
+
+GoFr now allows users to easily  **access the correlation ID**  via  `gofr.Context`.
+
+-   Retrieve correlation ID anywhere in your application using:
+    
+    ```go
+    ctx.GetCorrelationID()
+    ```
+----------
+
+### 🔹 Couchbase Support
+
+GoFr now supports injecting  **Couchbase**  as a datasource.  Any driver implementing the following interface can be added via  `app.AddCouchbase()`  and accessed across the application using  `gofr.Context`.
+
+#### 🧩 Supported Couchbase Interface:
+
+```go
+type Couchbase interface {
+    Get(ctx context.Context, key string, result any) error
+    Insert(ctx context.Context, key string, document, result any) error
+    Upsert(ctx context.Context, key string, document any, result any) error
+    Remove(ctx context.Context, key string) error
+    Query(ctx context.Context, statement string, params map[string]any, result any) error
+    AnalyticsQuery(ctx context.Context, statement string, params map[string]any, result any) error
+}
+
+```
+
+#### ✅ Example Usage:
+
+```go
+a := gofr.New()
+
+a.AddCouchbase(couchbase.New(&couchbase.Config{
+    Host:     "localhost",
+    User:     "Administrator",
+    Password: "password",
+    Bucket:   "test-bucket",
+}))
+
+```
+
+📚  **Documentation**:  [Couchbase Setup Guide](https://gofr.dev/docs)
+
+----------
+
+### 🔹 OracleDB Support
+
+GoFr now supports injecting  **OracleDB**  as a relational datasource via a clean and extensible interface.  
+
+#### 🧩 Supported Oracle Interface:
+
+```go
+type Oracle interface {
+    Exec(ctx context.Context, query string, args ...any) error
+    Select(ctx context.Context, dest any, query string, args ...any) error
+}
+```
+
+This approach makes it easy to inject any compatible Oracle driver while maintaining flexibility to use multiple databases within your GoFr application.
+    
+
+#### ✅ Example – Add OracleDB in GoFr
+
+```go
+app.AddOracle(oracle.New(oracle.Config{
+    Host:     "localhost",
+    Port:     1521,
+    Username: "system",
+    Password: "YourPasswordHere",
+    Service:  "FREEPDB1",
+}))
+```
+
+📚  **Documentation & Setup Guide**:  [Oracle](https://gofr.dev/docs)
+
+----------
+
+## 🛠️ Fixes
+
+-   Removed the  **unnecessary SQL initialization**  when no  `DB_*`  environment variables are defined. Prevents failure logs:  `connection to failed: host name is empty`
+- Fixed issue where metrics showed  **infinite DB calls**  for every query.]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.43.0</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.43.0</link>
+      <guid isPermaLink="false">v1.43.0</guid>
+      <pubDate>Tue, 05 Aug 2025 16:05:43 GMT</pubDate>
+      <description><![CDATA[## v1.43.0
+
+### 🚀 Features
+
+1.  **Startup Hooks Support (`OnStart`)**
+   
+GoFr now allows registering  **synchronous startup jobs**  using the  `OnStart`  method.
+
+This enables actions like:
+
+-   Warming up Redis or in-memory caches
+    
+-   Seeding databases
+    
+-   Validating configuration before traffic is served
+    
+The method receives a fully initialized  `*gofr.Context`  with access to SQL, Redis, and Logger instances. If any hook fails, the app will  **gracefully shut down**  with clear logs.
+
+🛠️  **Example usage:**
+
+```go
+a.OnStart(func(ctx *gofr.Context) error {
+    return ctx.Redis.Set(ctx, "key", "value", 0).Err()
+})
+```
+
+This ensures critical setup steps are completed  **before your app starts accepting traffic**.
+
+
+### 🛠️ Fixes
+
+1.  **PubSub Migrator Chain Fix**
+    
+Previously incorrect migration state visibility was seen when PubSub was connected. This has been resolved. Now it retrieves correct version from PubSub and continues chain to next migrator. Handles query failures without skipping downstream migrators
+    
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.42.5</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.42.5</link>
+      <guid isPermaLink="false">v1.42.5</guid>
+      <pubDate>Fri, 01 Aug 2025 11:01:15 GMT</pubDate>
+      <description><![CDATA[# v1.42.5 
+
+## 🚀 Enhancements
+
+### 🔹 ScyllaDB Migrator Support
+
+GoFr now includes native support for **ScyllaDB** migrations.
+
+#### 🧩 Supported Migration Interface:
+```go
+type ScyllaDB interface {
+    Query(dest any, stmt string, values ...any) error
+    QueryWithCtx(ctx context.Context, dest any, stmt string, values ...any) error
+
+    Exec(stmt string, values ...any) error
+    ExecWithCtx(ctx context.Context, stmt string, values ...any) error
+
+    ExecCAS(dest any, stmt string, values ...any) (bool, error)
+
+    NewBatch(name string, batchType int) error
+    NewBatchWithCtx(ctx context.Context, name string, batchType int) error
+
+    BatchQuery(name, stmt string, values ...any) error
+    BatchQueryWithCtx(ctx context.Context, name, stmt string, values ...any) error
+
+    ExecuteBatchWithCtx(ctx context.Context, name string) error
+}
+```
+
+
+### 🔹 OpenTSDB Migrator Support
+
+Support for  **OpenTSDB**  migration operations, enable you to pre-seed metrics and manage annotations.
+
+#### ✅ Key Features:
+-   Versioned JSON-based migration files
+    
+-   Integrated directly into GoFr's migration interface
+    
+
+#### 🧩 Supported Migration Interface:
+
+```go
+type OpenTSDB interface {
+    // PutDataPoints can be used for seeding initial metrics during migration
+    PutDataPoints(ctx context.Context, data any, queryParam string, res any) error
+
+    // PostAnnotation creates or updates an annotation in OpenTSDB using the 'POST /api/annotation' endpoint.
+    PostAnnotation(ctx context.Context, annotation any, res any) error
+
+    // PutAnnotation creates or replaces an annotation in OpenTSDB using the 'PUT /api/annotation' endpoint.
+    PutAnnotation(ctx context.Context, annotation any, res any) error
+
+    // DeleteAnnotation removes an annotation from OpenTSDB using the 'DELETE /api/annotation' endpoint.
+    DeleteAnnotation(ctx context.Context, annotation any, res any) error
+}
+```
+
+----------
+
+📚  **Documentation**  
+See  [gofr.dev/migrations](https://gofr.dev/migrations)  for full examples, best practices, and schema layouts for ScyllaDB and OpenTSDB migrations.
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.42.4</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.42.4</link>
+      <guid isPermaLink="false">v1.42.4</guid>
+      <pubDate>Fri, 25 Jul 2025 14:19:51 GMT</pubDate>
+      <description><![CDATA[## **v1.42.4**
+
+### **🛠️ Improvements**
+
+1. **Elasticsearch Migrator for Versioned Changes**
+
+   GoFr now includes a dedicated **Elasticsearch migrator** under `pkg/migration` for managing version-controlled changes like index creation, mapping updates, and analyzer definitions.
+   **Key Features:**
+
+   * Seamless integration with GoFr’s internal **migrator interface**.
+   * Uses Elasticsearch’s **REST API** for all operations.
+   * Maintains migration state for reliable deployments.
+
+   Refer to [gofr.dev/migrations](https://gofr.dev/docs/advanced-guide/handling-data-migrations) for more details and examples.
+
+### **🐞 Bug Fixes**
+
+1. **Fixed Panic in Context Logging in GoFr CMD Apps**
+
+   A bug that caused a panic when using `ctx.Warnf` instead of `ctx.Logger.Warnf` has been fixed.
+
+   **Behavior Before:**
+   
+   Calling `ctx.Warnf` in GoFr CMD Apps resulted in:
+
+   ```
+   panic: runtime error: invalid memory address or nil pointer dereference
+   ```
+
+   **Now:**
+   
+   `ctx.Warnf` functions correctly and logs without causing runtime crashes.]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.42.3</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.42.3</link>
+      <guid isPermaLink="false">v1.42.3</guid>
+      <pubDate>Wed, 09 Jul 2025 07:29:40 GMT</pubDate>
+      <description><![CDATA[# v1.42.3 
+
+----------------------
+
+## 🛡️ Security Fix
+- Resolved weak RSA key generation in `mock_oauth_server.go`.
+- Previously, a 1024-bit RSA key was being generated in the mock OAuth server (rsa.GenerateKey).
+- Increased the key size to 2048 bits, aligning with modern cryptographic standards and addressing [CodeQL alert #73](https://github.com/gofr-dev/gofr/security/code-scanning/73).
+
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.42.2</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.42.2</link>
+      <guid isPermaLink="false">v1.42.2</guid>
+      <pubDate>Fri, 04 Jul 2025 13:59:35 GMT</pubDate>
+      <description><![CDATA[## v1.42.2
+
+### 🛠️ Improvements
+
+#### 1.  **Versioned Migrations Support Extended to NATS and EventHub**
+
+Following up on versioned migration support for Kafka, MQTT, and Google PubSub in the previous release, GoFr now officially adds:
+
+- **NATS**
+- **Azure EventHub**
+
+Both now support  **versioned migrations**, allowing event streaming systems to be schema-evolvable and compatible with data migration needs.
+
+#### 2.  **Cleaner AuthConfig APIs for External Services**
+
+You can now configure external services like  `catfact.ninja`  using streamlined constructors:
+
+**Old Way:**
+
+```go
+app.AddHTTPService("cat-facts", "https://catfact.ninja",
+    &service.APIKeyConfig{APIKey: "some-random-key"},
+    &service.BasicAuthConfig{UserName: "gofr", Password: "gofr"})
+``` 
+
+**New Way:**
+
+```go
+app.AddHTTPService("cat-facts", "https://catfact.ninja",
+    service.NewAPIKeyConfig("some-random-key"),
+    service.NewBasicAuthConfig("username", "password"),
+    )
+``` 
+
+ `NewBasicAuthConfig(username, password)`:
+
+-   Trims values   
+-   Validates presence of both fields  
+-   Ensures  **password is base64 encoded**, preventing unsafe plaintext usage 
+-   Returns  **clear errors**  for invalid formats
+    
+
+ `NewAPIKeyConfig(apiKey)`:
+
+-   Simplified usage  
+-   Validated internally
+-   Adds cleaner abstraction with automatic header injection
+    
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.42.1</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.42.1</link>
+      <guid isPermaLink="false">v1.42.1</guid>
+      <pubDate>Fri, 27 Jun 2025 12:42:48 GMT</pubDate>
+      <description><![CDATA[# v1.42.1
+
+## 🛠️ Improvements
+
+### 1. **`NewOAuthConfig()` for Safer OAuth Setup**
+
+GoFr now includes a dedicated constructor to validate OAuth configurations for interservice HTTP calls, ensuring secure and consistent authentication setup. Refer to the [official documentation](https://gofr.dev/docs/advanced-guide/http-authentication#adding-o-auth-authentication-to-http-services) to know more :
+
+```go
+NewOAuthConfig(
+	clientID,  // string: OAuth2 client ID (required)
+	secret,    // string: OAuth2 client secret (required)
+	tokenURL,  // string: Token exchange endpoint (required & validated)
+	scopes,    // []string: Optional OAuth2 scopes
+	params,    // url.Values: Optional additional endpoint parameters
+	authStyle, // oauth2.AuthStyle: Credential passing style (header/body/auto)
+)
+```
+
+#### 🔍 Why this matters:
+
+* Prevents common misconfigurations like missing `tokenURL`, which previously caused vague errors such as:
+
+  ```
+  Post "": unsupported protocol scheme ""
+  ```
+* Performs validation on required fields and returns clear error messages.
+* Encourages safe and standardized OAuth client setup.
+
+#### ✅ Example Usage:
+
+```go
+config, err := NewOAuthConfig(
+	"my-client-id",                       // clientID
+	"my-client-secret",                   // secret
+	"https://provider.com/oauth/token",  // tokenURL
+	[]string{"read", "write"},           // scopes
+	nil,                                  // params
+	oauth2.AuthStyleAutoDetect,          // authStyle
+)
+
+if err != nil {
+	log.Fatal(err)
+}
+```
+
+Refer to the [official documentation](https://gofr.dev/docs/advanced-guide/http-authentication#adding-o-auth-authentication-to-http-services) to know more.
+
+
+
+### 2. **Configurable `AuthStyle` in OAuth**
+
+The `AuthStyle` field in OAuth2 configuration is now configurable by the user.
+
+#### 🔧 Behavior:
+
+* Previously hardcoded to `oauth2.AuthStyleInHeader`
+* Now allows values such as:
+
+  * `oauth2.AuthStyleAutoDetect` (default)
+  * `oauth2.AuthStyleInHeader`
+  * `oauth2.AuthStyleInParams`
+
+This makes GoFr's OAuth integration more flexible and compatible with diverse OAuth providers.
+
+---
+
+### 3. **Versioned Migrations in Kafka, MQTT, and Google PubSub**
+
+GoFr now supports **versioned migrations** for the following data sources:
+
+* ✅ **Kafka**
+* ✅ **MQTT**
+* ✅ **Google PubSub**
+
+#### 🧩 Additional Config (MQTT only):
+
+To support retained message fetching for versioned migrations in MQTT, enable:
+
+```
+MQTT_RETRIEVE_RETAINED=true
+```
+By default, this is set to `false` to maintain backward compatibility. When set to true, this actually retains the latest message for each topics in the connected MQTT host, hence aiding in versioned migrations.
+
+
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.42.0</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.42.0</link>
+      <guid isPermaLink="false">v1.42.0</guid>
+      <pubDate>Fri, 20 Jun 2025 04:50:59 GMT</pubDate>
+      <description><![CDATA[# v1.42.0
+
+## 🚀 Features
+
+### 1.  **CockroachDB Support**
+
+GoFr now supports  **CockroachDB**, a distributed cloud-native SQL database.
+Developers can now configure GoFr services to connect to CockroachDB using simple environment variables.
+
+#### 🔧 Configuration:
+```
+DB_DIALECT=cockroachdb
+DB_HOST=localhost
+DB_PORT=26257
+DB_USER=root
+DB_PASSWORD=your-password
+DB_NAME=defaultdb
+DB_SSL_MODE=require
+``` 
+For more details, refer to the  [SQL usage guide](/advanced-guide/dealing-with-sql/).
+
+## 🛠️ Improvements
+
+### 1.  **gRPC Reflection Toggle via Config**
+
+GoFr now supports enabling/disabling  **gRPC server reflection**  using a simple config flag:
+```
+GRPC_ENABLE_REFLECTION=true
+``` 
+
+#### 🔍 When to enable:
+
+-   **Development & Debugging**: Use with tools like grpcurl, Postman, or Evans.
+    
+-   **Internal Networks**: Safe in private, trusted environments.
+    
+-   **CI/CD Pipelines**: Ideal for service discovery in automated setups.
+    
+
+This allows dynamic inspection of gRPC services while maintaining control over exposure.
+
+
+## 🛠️ Fixes
+
+### 1.  **Supabase Healthcheck Issue Resolved**
+
+Resolved an issue where Supabase-backed services were not responding properly to health checks due to incorrect handling of internal pings.
+
+
+### 2.  **Fixed Data Race in Metrics Gauges**
+
+Addressed a  **concurrency bug** where the internal  `float64Gauge`  map was accessed without synchronization. Proper locking is now in place around map access to avoid data races during concurrent  `SetGauge`  and metric reads.
+
+### 3.  **App Name & Version Initialization Bug**
+
+Fixed a configuration issue where  `AppName`  and  `AppVersion`  were incorrectly defaulting to  `gofr-app`  and  `dev`, even when explicitly provided by the user. These values now correctly reflect user-specified configuration during startup.
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.41.0</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.41.0</link>
+      <guid isPermaLink="false">v1.41.0</guid>
+      <pubDate>Thu, 12 Jun 2025 18:05:20 GMT</pubDate>
+      <description><![CDATA[# v1.41.0
+
+## 🔧 Improvements
+
+
+### 1.  **New HTTP Error Type:  `ErrorRecordNotFound`**
+
+A new standardized error type  `http.ErrorRecordNotFound`  has been introduced to gracefully handle scenarios where  **no records are found**  in the database.
+
+####  Example:
+
+```go
+return  nil, http.ErrorRecordNotFound{
+    Message: "User not found with the given ID",
+}
+```
+
+This improves semantic clarity and enables better client-side handling for empty-query results.
+
+### 2.  **Improved Cron Job Observability**
+
+All  **cron jobs**  in GoFr now come with  **built-in logger and tracing support**.
+
+-   Logs from scheduled tasks are now clearly visible.
+    
+-   Each recurring job run is automatically  **tagged with a unique trace ID**, making it easier to trace, debug, and monitor scheduled executions across your system.
+    
+
+This ensures better observability for background tasks without requiring additional instrumentation.
+
+## 🐛 Fixes
+
+### 1.  **Supabase Connection Issue Resolved**
+
+Previously,  **Supabase connections were not initializing correctly**  in GoFr due to a missing dialect registration. Supabase-backed services will now  **connect without issues**—no manual fixes required.
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.40.1</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.40.1</link>
+      <guid isPermaLink="false">v1.40.1</guid>
+      <pubDate>Fri, 06 Jun 2025 06:26:14 GMT</pubDate>
+      <description><![CDATA[# v1.40.1
+
+
+## 🔧 Dependency Updates
+
+Upgraded all externalized datasource dependencies to their latest stable versions for improved performance, security, and compatibility across supported services.
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.40.0</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.40.0</link>
+      <guid isPermaLink="false">v1.40.0</guid>
+      <pubDate>Fri, 23 May 2025 12:07:26 GMT</pubDate>
+      <description><![CDATA[
+# v1.40.0
+
+## 🚀 Features
+
+### **Support for Supabase Database**
+
+Users can now connect their GoFr services to a  **Supabase**  database using environment variables. This feature supports both  **direct**  and  **pooled**  connections, enabling secure and scalable Postgres usage via Supabase.
+
+#### 🔧 Environment Variable Setup:
+```bash
+DB_DIALECT=supabase
+DB_HOST=db.[PROJECT_REF].supabase.co  # Optional, derived from PROJECT_REF
+DB_USER=postgres                      # Or database user name
+DB_PASSWORD=password
+DB_NAME=postgres                      # Or your database name
+DB_PORT=5432                          # Optional, defaults based on connection type
+DB_SSL_MODE=require                   # Optional, forced to "require" for Supabase
+
+# Supabase-specific configs
+SUPABASE_PROJECT_REF=your_project_ref
+SUPABASE_CONNECTION_TYPE=direct       # Options: direct, session, transaction
+SUPABASE_REGION=us-east-1             # Required for pooled connections
+
+# Alternatively, can provide full connection string
+DATABASE_URL=postgresql://postgres:password@db.your_project_ref.supabase.co:5432/postgres
+``` 
+
+----
+
+### **Inter-Service WebSocket Communication**
+
+GoFr now supports  **Inter-Service WebSocket Communication**, enabling services to exchange real-time messages over WebSocket connections. Ideal for microservices needing live updates or event-driven communication.
+
+#### 🔑  Key Methods:
+
+-   `AddWSService`: Register a persistent WebSocket connection to another service with optional auto-reconnect.
+    
+-   `WriteMessageToService`: Send messages to any registered service.
+    
+
+#### ✅ Example Usage:
+
+```go
+func main(){
+
+	app := gofr.New()
+
+	err := app.AddWSService("notification-service", "ws://notifications.example.com/ws", nil, true, 5*time.Second) 
+	if err != nil {
+	    app.Logger.Errorf("Failed to add WebSocket service: %v", err) 
+	    return 
+	}
+
+	app.POST("/send-notification", func(ctx *gofr.Context) (any, error) {
+	    message := map[string]string{ 
+		    "title": "New Message", 
+		    "content": 	"You have a new notification!",
+	    }
+
+	    err := ctx.WriteMessageToService("notification-service", message)
+	    if err != nil { 
+		    return  nil, err
+	    } 
+	    
+		return  "Notification sent successfully!", nil 
+		})
+
+	app.Run()
+}
+``` 
+
+This enables resilient, real-time service communication with minimal configuration.
+
+
+## 🔧 Improvements
+
+### 1.  **New HTTP Error Type:  `ServiceUnavailable`**
+
+A new standardized error type  `ErrorServiceUnavailable`  has been introduced for representing service unavailability due to dependency issues like database failures or third-party service outages.
+
+#### ⚙️ Use Case Example:
+
+```go
+err := http.ErrorServiceUnavailable{
+    Dependency: "PostgreSQL",
+    ErrorMessage: "Connection timeout",
+}
+``` 
+This improvement enhances observability and clarity when dealing with critical external failures.
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.39.1</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.39.1</link>
+      <guid isPermaLink="false">v1.39.1</guid>
+      <pubDate>Thu, 15 May 2025 12:56:14 GMT</pubDate>
+      <description><![CDATA[# v1.39.1
+
+## 🛠 Improvements
+
+1. **Disable Logs for Health & Alive Probes**
+
+	Logging for health check routes (`/.well-known/health` and `/.well-known/alive`) can now be disabled to reduce log clutter in environments with frequent probe calls (e.g., Kubernetes).
+
+	Set the following environment variable:
+
+	```bash
+	LOG_DISABLE_PROBES=true
+	```
+
+2. **TraceID Now Included in Context-Based Logging**
+
+	Logs emitted using `ctx.Logger()` now automatically include the request `traceID`. This enhances traceability across services and allows easier debugging in distributed systems.
+
+	Example log before:
+
+	```json
+	{"message": "User created", "level": "INFO"}
+	```
+
+	After:
+
+	```json
+	{"message": "User created", "trace_id": "3ac9f5e7c12e...", "level": "INFO"}
+	```
+
+	No additional configuration needed—this is now built-in.
+
+3. **Enhanced ArangoDB Query Options Support**
+
+	You can now pass advanced query and subquery options when executing AQL queries via GoFr’s ArangoDB client.
+
+	```go
+	options := map[string]any{
+	    "count":     true,
+	    "batchSize": 100,
+	    "options": map[string]any{
+	        "fullCount": true,
+	        "profile":   2,
+	    },
+	}
+	```
+
+	Supported keys include (but are not limited to):
+
+	- **QueryOptions:**
+
+		* `count`, `batchSize`, `ttl`, `cache`, `memoryLimit`
+
+	- **QuerySubOptions (under `options` key):**
+
+		* `fullCount`, `allowRetry`, `stream`, `optimizer`, `profile`, `maxRuntime`, `skipInaccessibleCollections`, and more
+
+	**Example usage:**
+
+	```go
+	err := ctx.ArangoDB.Query(ctx, "myDatabase", query, bindVars, &results, options)
+	```
+
+	This update gives you full control over AQL query execution for performance tuning, streaming, profiling, and more. 
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.39.0</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.39.0</link>
+      <guid isPermaLink="false">v1.39.0</guid>
+      <pubDate>Thu, 08 May 2025 16:19:25 GMT</pubDate>
+      <description><![CDATA[# v1.39.0
+
+## 🚀 Features
+
+### gRPC Streaming Support  
+GoFr now supports all gRPC streaming types, unlocking full duplex communication capabilities:
+- **Server-side streaming**  
+- **Client-side streaming**  c
+- **Bidirectional streaming**  
+Auto-generated handlers for streaming methods with built-in metrics and tracing support for all streaming calls
+
+> **Note:** Requires `gofr-cli v0.7.0` or higher.  
+> Refer to the [examples](https://github.com/gofr-dev/gofr/tree/main/examples/grpc-streaming) to explore usage patterns.
+
+
+
+### Redirect Support in HTTP Handlers  
+Handlers can now trigger client redirects by returning a `response.Redirect` object:
+
+```go
+import (
+    "gofr.dev/pkg/gofr"
+    "gofr.dev/pkg/gofr/http/response"
+)
+
+func main() {
+    app := gofr.New()
+
+    app.GET("/old-page", func(ctx *gofr.Context) (any, error) {
+        return response.Redirect{URL: "https://example.com/new-page"}, nil
+    })
+
+    app.Run()
+}
+```
+Use this for SEO-friendly permanent or temporary redirects from legacy URLs.
+
+##  🛠 Improvements
+
+### 1. TLS Support for Redis
+
+Redis connections in GoFr can now be secured using TLS. This enhancement enables secure communication in production and enterprise deployments. Configuration is done via environment variables:
+
+| Environment Variable     | Description                                                     |
+| ------------------------ | --------------------------------------------------------------- |
+| `REDIS_TLS_ENABLED`      | Set to `"true"` to enable TLS support                           |
+| `REDIS_TLS_CA_CERT_PATH` | File path to the CA certificate to verify Redis server identity |
+| `REDIS_TLS_CERT_PATH`    | File path to the client certificate (for mTLS connections)      |
+| `REDIS_TLS_KEY_PATH`     | File path to the client private key (for mTLS connections)      |
+
+
+
+
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.38.0</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.38.0</link>
+      <guid isPermaLink="false">v1.38.0</guid>
+      <pubDate>Thu, 24 Apr 2025 15:41:51 GMT</pubDate>
+      <description><![CDATA[# **Release - v1.38.0**
+
+## 🚀  **Features**
+
+### **Elasticsearch Integration Support**
+
+-   GoFr now supports  **Elasticsearch**  as a pluggable data source with a standard interface for document indexing, searching, and cluster management.
+    
+-   Developers can inject any compatible Elasticsearch client that implements the following interface:
+    
+    ```go
+    type Elasticsearch interface {
+        Connect()
+        CreateIndex(ctx context.Context, index string, settings map[string]any) error 
+        DeleteIndex(ctx context.Context, index string) error 
+        IndexDocument(ctx context.Context, index, id string, document any) error 
+        GetDocument(ctx context.Context, index, id string) (map[string]any, error)
+        UpdateDocument(ctx context.Context, index, id string, update map[string]any) error 
+        DeleteDocument(ctx context.Context, index, id string) error 
+        Search(ctx context.Context, indices []string, query map[string]any) (map[string]any, error)
+        Bulk(ctx context.Context, operations []map[string]any) (map[string]any, error)
+        HealthChecker
+    }
+    ``` 
+    
+-   Official GoFr-compatible driver is available via:
+    
+    ```
+    go get gofr.dev/pkg/gofr/datasource/elasticsearch@latest
+    ```
+    
+-   Example usage in your  `main.go`:
+    
+    ```go
+    func main (){
+		    app := gofr.New()
+		    
+			es := elasticsearch.New(elasticsearch.Config{
+		        Addresses: []string{"http://localhost:9200"},
+		        Username: "elastic",
+		        Password: "changeme",
+		    })
+    
+		    app.AddElasticsearch(es)
+		    
+			app.Run ()
+    }
+    ``` 
+- Checkout our [official documentation](https://gofr.dev/docs/datasources/getting-started) for more details.    
+
+ 
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.37.1</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.37.1</link>
+      <guid isPermaLink="false">v1.37.1</guid>
+      <pubDate>Wed, 16 Apr 2025 04:13:04 GMT</pubDate>
+      <description><![CDATA[# **Release - v1.37.1**
+
+## 🚀 **Improvements**
+
+### **Extended Error Responses (RFC 9457-style)**
+
+-   GoFr now supports extended error responses following the [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457.html) specification.
+    
+-   Developers can implement the new `ResponseMarshaler` interface to enrich error responses with custom fields beyond the standard error message and status code.
+	```go
+	type ResponseMarshaler interface {
+	    Response() map[string]any
+	}
+	```
+- Example:
+
+	```go
+	type ValidationError struct {
+	    Field string 
+	    Message string 
+	    Code int 
+	} 
+
+	func  (e ValidationError) Error() string { 
+		return e.Message 
+	} 
+
+	func  (e ValidationError) StatusCode() int { 
+		return e.Code 
+	} 
+
+	func  (e ValidationError) Response() map[string]any { 
+		return  map[string]any{ 
+			"field":   e.Field, 
+			"type": "validation_error", 
+			"details": "Invalid input format",
+	    }
+	}
+	``` 
+
+	> ⚠️ **Note:**  The `message` field is automatically populated from the `Error()` method. Custom fields with the name "message" in the `Response()` map should not be used as they will be ignored in favor of the `Error()` value.
+
+	This feature allows more descriptive and structured error responses, ideal for client-side validation, API debugging, and frontend integration.
+
+## 🛠 **Fixes**
+
+
+### **1. WebSocket: Fixed Concurrent Write Panic**
+
+-   WebSocket writes are now thread-safe. Previously, concurrent calls to `WriteMessageToSocket()` caused race conditions and panics. Writes are now internally synchronized.
+    
+
+### **2. NATS: Synchronous Connection Setup**
+
+-   NATS connections are now established synchronously to prevent `errJetStreamNotConfigured` errors when calling `jetStream()` immediately after `Connect()`.
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.37.0</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.37.0</link>
+      <guid isPermaLink="false">v1.37.0</guid>
+      <pubDate>Tue, 08 Apr 2025 14:29:59 GMT</pubDate>
+      <description><![CDATA[
+##  🚀 **Features**  
+
+
+### **1. Dgraph Migration Support**
+
+-   Added native migration capabilities for Dgraph through new methods, enabling precise schema evolution:
+	```go
+	// Apply or update the complete Dgraph schema 
+	ApplySchema(ctx context.Context, schema string) error
+	// Atomically create or update a field definition
+	AddOrUpdateField(ctx context.Context, fieldName, fieldType, directives string) error  
+	// Permanently remove a field/predicate and its associated data 
+	DropField(ctx context.Context, fieldName string) error	 
+	``` 
+-   Refer to  the [official documentation](https://gofr.dev/docs/datasources/dgraph) for full usage details.
+    
+## 🛠 **Improvements**  
+
+
+### **1. gRPC Server Configuration via  `AddGRPCServerOptions`**
+-   GoFr now allows configuring advanced gRPC  `ServerOptions`.
+-   Example: Enabling TLS and setting a connection timeout
+    
+    ```go
+    creds, _ := credentials.NewServerTLSFromFile("server-cert.pem", "server-key.pem")
+    
+    app.AddGRPCServerOptions(
+        grpc.Creds(creds),
+        grpc.ConnectionTimeout(10*time.Second),
+    )
+    ``` 
+- Refer to the [official documentation](https://gofr.dev/docs/advanced-guide/grpc) to know more.
+    
+### **2. Add Custom Unary Interceptors**
+    
+   ```go
+  app.AddGRPCUnaryInterceptors(authInterceptor)
+  ```
+- GoFr already logs, traces and sends default metrics for all gRPC calls. No external interceptor for such features is necessary. Custom server-side  `UnaryServerInterceptors` can now be registered easily for use cases like:
+    
+    -   Authentication
+    -   Request validation
+   
+ - For guidance on how to define Server UnaryInterceptors that can be added in your GoFr's gRPC server, check out the [official documentation](https://gofr.dev/docs/advanced-guide/grpc).
+
+### **3. Advanced gRPC Client DialOptions Support**
+
+-   Clients can now be customized extensively via  `grpc.DialOptions`.
+     This allows to add gRPC services with :
+          -   Secure TLS communication
+          -   Load-balanced connections
+          -   Retry logic
+          -   Context-aware metadata injection (useful for tracing and auth)
+        
+
+    ```go
+    const serviceConfig = `{
+      "loadBalancingPolicy": "round_robin",
+      "methodConfig": [{
+        "name": [{"service": "HelloService"}],
+        "retryPolicy": {
+          "maxAttempts": 4,
+          "initialBackoff": "0.1s",
+          "maxBackoff": "1s",
+          "backoffMultiplier": 2.0,
+          "retryableStatusCodes": ["UNAVAILABLE", "RESOURCE_EXHAUSTED"]
+        }
+      }]
+    }` 
+    
+	// Metadata interceptor to add client ID to each request
+    func  MetadataUnaryInterceptor(ctx context.Context, method string, req, reply any,
+        cc *grpc.ClientConn, invoker grpc.UnaryInvoker, opts ...grpc.CallOption,
+    ) error {
+        md := metadata.Pairs("client-id", "f1b1a372-02f5-4065-9ccf-113d34a3d5ed")
+        
+        ctx = metadata.NewOutgoingContext(ctx, md) 
+	
+	    return invoker(ctx, method, req, reply, cc, opts...)
+    } 
+	
+	func  main() {
+        app := gofr.New()
+    
+        creds, err := credentials.NewClientTLSFromFile("cert.pem", "") if err != nil {
+            app.Logger().Errorf("TLS error: %v", err) return }
+    
+        grpcClient, err := client.NewHelloServiceGoFrClient(
+            app.Config.Get("GRPC_SERVER_HOST"),
+            app.Metrics(),
+            grpc.WithTransportCredentials(creds),
+            grpc.WithDefaultServiceConfig(serviceConfig),
+            grpc.WithChainUnaryInterceptor(MetadataUnaryInterceptor),
+        ) 
+	
+		if err != nil {
+            app.Logger().Errorf("Failed to create client: %v", err) return 
+        }
+    
+        handler := NewGreetHandler(grpcClient)
+        
+        app.GET("/hello", handler.Hello)
+        
+        app.Run()
+    }
+    ```
+     - Refer to the [official documentation](https://gofr.dev/docs/advanced-guide/grpc) to know more.
+         
+## 🛠 **Fixes**  
+
+### **1. SurrealDB  `Update`  Method: Unexpected Behavior Fixed** 
+- Regardless of the input, the  `Update`  method previously inserted an unexpected hardcoded key-value pair. The method now correctly updates  **only  the intended fields** as passed by the caller.
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.36.0</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.36.0</link>
+      <guid isPermaLink="false">v1.36.0</guid>
+      <pubDate>Tue, 25 Mar 2025 15:02:17 GMT</pubDate>
+      <description><![CDATA[# **Release - v1.36.0**  
+
+##  🚀 **Features**  
+
+### **1. SurrealDB Migration Support**  
+- Added support for database migration operations in SurrealDB.  
+- Supported methods include:  
+	```go
+	// Creates a new namespace in SurrealDB.
+	CreateNamespace(ctx context.Context, namespace string) error  
+	// Creates a new database in SurrealDB.
+	CreateDatabase(ctx context.Context, database string) error 
+	// Deletes a namespace from SurrealDB.
+	DropNamespace(ctx context.Context, namespace string) error
+	// Deletes a database from SurrealDB.  
+	DropDatabase(ctx context.Context, database string) error  
+	``` 
+- Refer to our [official documentation](https://gofr.dev/docs/datasources/surrealdb) to know more.
+
+## 🛠 **Improvements**  
+
+### **1. Default Metrics for SurrealDB Data Source**  
+- Introduced default metric collection for SurrealDB at the specified `METRICS_PORT`, enabling better observability and performance monitoring.  
+
+### **2. JWT Claim Validations**  
+- `EnableOAuth` now takes an additional JWT validation options as `jwt.ParserOption`, allowing fine-grained control over claim validation. 
+- Example :
+	```go
+	app.EnableOAuth(
+		"http://jwks-endpoint",
+		20,
+		jwt.WithExpirationRequired(), // to enforce presence of exp claim in every token
+		jwt.WithAudience("https://api.example.com"),
+		jwt.WithIssuer("https://auth.example.com")
+	)
+	```
+- To know more about the different claim validation options, check out our [official documentation](https://gofr.dev/docs/advanced-guide/http-authentication#3-o-auth-2-0).
+
+## 🛠 **Fixes**  
+
+### **1. `pprof` Profiling Enhancements**  
+- Previously, the `pprof` endpoint was restricted to being enabled only when the `APP_ENV=DEBUG` environment variable was set, and it ran on the specified `HTTP_PORT`. This prevented users from loading their different environments, for e.g. stage or production configurations if we set `APP_ENV` as `DEBUG` for profiling.
+- GoFr now automatically enables `pprof` profiling on `METRICS_PORT` (default: `2121`).  
+- Profiling endpoints include :  
+  - `/debug/pprof/cmdline`  
+  - `/debug/pprof/profile`  
+  - `/debug/pprof/symbol`  
+  - `/debug/pprof/trace`  
+  - `/debug/pprof/` (index)  
+ 
+For more information on setting up and using profiling in your application, refer to our [official documentation](https://gofr.dev).
+
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.35.2</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.35.2</link>
+      <guid isPermaLink="false">v1.35.2</guid>
+      <pubDate>Tue, 18 Mar 2025 14:48:52 GMT</pubDate>
+      <description><![CDATA[# **Release - v1.35.2**
+
+# 🛠 **Improvements**
+
+### **1. Kafka TLS Enhancements**
+-   Added support for configuring Kafka with **TLS parameters**, enabling seamless integration with **Confluent Kafka SaaS** and similar ecosystems.
+ Introduced the following configuration options:
+
+    ```
+    KAFKA_TLS_CERT_FILE            : Path to the TLS certificate file.  
+    KAFKA_TLS_KEY_FILE             : Path to the TLS key file.  
+    KAFKA_TLS_CA_CERT_FILE         : Path to the TLS CA certificate file.  
+    KAFKA_TLS_INSECURE_SKIP_VERIFY : Boolean option to skip TLS certificate verification.  
+    ```
+
+    **Note:** All provided paths must be absolute. Check out our [official documentation](https://gofr.dev/docs/advanced-guide/using-publisher-subscriber#kafka) to learn more.  
+
+### **2. Static File Server Enhancements**
+    
+-  If a requested file is missing, the server attempts to serve `404.html` with a `404` status code. If `404.html` is unavailable, it returns a `404` status code.
+    
+-   If the file being accessed lacks **read permissions**, the error is logged and an appropriate  `500 Internal Server Error`  status code and response body is returned.
+
+# 🛠  **Fixes**
+
+### **1. Middleware Execution Order**
+-   Restored the original middleware execution order prior to [**Release v1.35.0**](https://github.com/gofr-dev/gofr/releases/tag/v1.35.0). Standard middlewares (`logs`, `traces`, `metrics`, `CORS`) are now executed before user-defined middlewares, ensuring consistent observability even when responses are handled early for e.g. in custom middlewares.
+- However, **WebSocket** connection upgrades necessarily take place **after all middleware processing**, maintaining compatibility with corresponding authentication flows introduced previously.
+
+
+### **2. Kafka Security Protocol Configuration Fix**
+-   Previously, SASL authentication failed in ecosystems like Confluent due to missing `security.protocol` support, causing errors like:  
+     ```
+      SASL handshake failed: EOF
+     ```
+-   Introduced `KAFKA_SECURITY_PROTOCOL` to explicitly define the security protocol for Kafka communication. Supported options include : `PLAINTEXT`, `SSL`, `SASL_PLAINTEXT`, `SASL_SSL`, ensuring seamless authentication. Check out [official documentation](https://gofr.dev/docs/advanced-guide/using-publisher-subscriber#kafka) to know more.
+   
+### 3. **Redundant WriteHeader Calls**
+-   Fixed redundant WriteHeader calls when custom middleware in the static file server set a status code, preventing log spam like:
+	   ```
+	    http: superfluous response.WriteHeader call  from gofr.dev/pkg/gofr/http/middleware.(*StatusResponseWriter).WriteHeader (logger.go:23)
+	``` 
+-   Headers are now written once—by either user-defined middleware or the framework handlers.
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.35.1</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.35.1</link>
+      <guid isPermaLink="false">v1.35.1</guid>
+      <pubDate>Tue, 11 Mar 2025 13:34:29 GMT</pubDate>
+      <description><![CDATA[
+# **Release v1.35.1**
+ 
+# 🛠  **Improvements**
+
+### **1. Kafka Connection & Security Enhancements**
+
+-   Added support for configuring Kafka with extra **connection and security parameters** to **seamlessly integrate** with Confluent Kafka SaaS and similar platforms.
+-   Introduced three new configuration options for **SASL authentication**:
+
+	#### 🔧 `KAFKA_SASL_MECHANISM`
+	-   SASL mechanism for authentication (e.g. `PLAIN`, `SCRAM-SHA-256`, `SCRAM-SHA-512`)
+	-   Default: `None`
+
+	#### 🔧 `KAFKA_SASL_USERNAME`
+
+	-   Username for SASL authentication
+	-   Default: `None`
+
+	#### 🔧 `KAFKA_SASL_PASSWORD`
+
+	-   Password for SASL authentication
+	-   Default: `None`
+
+### **2. Multiple Static Folders Support**
+-   **Multiple static folders** can now be registered and served at different custom endpoints.
+    
+-   Example usage:
+```go
+    package main 
+    
+    import  "gofr.dev/pkg/gofr"  
+
+	func  main() {
+        app := gofr.New()
+        app.AddStaticFiles("public", "./public")
+        app.AddStaticFiles("static", "./static")
+        app.Run()
+    }
+   ``` 
+    
+-   In this example:
+    
+    -   Files in the `public` folder are served at `host/public/*`
+    -   Files in the `static` folder are served at `host/static/*`
+  
+### **3. ArangoDB Resource Creation Enhanced**
+
+-   `CreateDB`, `CreateGraph`, and `CreateCollection`  methods in Arango, now check for existing resources before creating them. Check out our [official documentation](https://gofr.dev/docs/datasources/arangodb) to know more.
+
+# 🛠  **Fixes**
+
+### **1. Fixed Static File Server Endpoint Handling**
+-   Previously, files in the **`static`** directory were served by default at **`/static/`**. If the same directory was registered at another path, the files were being served at both endpoints, resulting in duplicate serving.
+-   This has now been fixed. If a user registers a custom endpoint using **`app.AddStaticFiles({custom-endpoint}, ./static)`**, GoFr will automatically serve the files only at the specified custom endpoint.
+-   Additionally, if any directories are re-registered within the GoFr application, the files will now be served at the **latest** registered endpoint, ensuring there’s no duplication.
+
+
+
+
+]]></description>
+    </item>
+    <item>
+      <title>GoFr v1.35.0</title>
+      <link>https://github.com/gofr-dev/gofr/releases/tag/v1.35.0</link>
+      <guid isPermaLink="false">v1.35.0</guid>
+      <pubDate>Tue, 04 Mar 2025 14:00:12 GMT</pubDate>
+      <description><![CDATA[# **Release  v1.35.0**
+
+# 🚀  **Features**
+
+### **1. Template Rendering Support**  
+
+- GoFr now supports rendering HTML templates directly from handlers using the new `response.Template` response type. 
+
+- By default, it looks for template files in the `templates` directory, automatically parsing the specified file and injecting the provided data, allowing developers to serve dynamic HTML content without requiring a separate template rendering mechanism.
+
+- #### **Usage Example:**
+	Here's how you can use template rendering in a GoFr handler:
+	```go
+	package main
+
+	import (
+		"fmt"
+		"net/http"
+
+		"gofr.dev/pkg/gofr"
+		"gofr.dev/pkg/gofr/response"
+	)
+
+	type Todo struct {
+		Title       string
+		Description string
+		Done        bool
+	}
+
+	func main() {
+		app := gofr.New()
+
+		app.GET("/todo", func(ctx *gofr.Context) (interface{}, error) {
+			data := Todo{
+				Title:       "Learn GoFr",
+				Description: "Understand how template rendering works in GoFr",
+				Done:        false,
+			}
+			return response.Template{Name: "todo.html", Data: data}, nil
+		})
+
+		app.Run()
+
+	}
+	```
+
+	#### **Example Template (templates/todo.html):**
+
+	```
+	<!DOCTYPE html>
+	<html lang="en">
+	<head>
+	    <meta charset="UTF-8">
+	    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+	    <title>Todo</title>
+	</head>
+	<body>
+	    <h1>{{ .Title }}</h1>
+	    <p>{{ .Description }}</p>
+	    <p>Status: {{ if .Done }} ✅ Completed {{ else }} ❌ Pending {{ end }}</p>
+	</body>
+	</html>
+	```
+	When a request is made to `/todo`, GoFr will render the `todo.html` template by injecting the provided `Todo` struct values.
+
+### **2. Graceful Shutdown Configuration**
+
+- A new environment variable, `SHUTDOWN_GRACE_PERIOD`, has been introduced to allow customization of the server's shutdown timeout.
+
+-   **Default:** `30s`
+-   **Purpose:** Ensures in-flight requests are served before shutdown.
+ 
+# 🛠  **Fixes & Improvements**
+
+### **1. Authentication in Websockets**  
+- Ensured proper authentication for GoFr WebSocket connections by requiring user-defined authentication or middleware to run before upgrading, as WebSockets do not inherently support authentication.
+    
+### **2.  Fixed Infinite Write Retry on Closed WebSocket** 
+- Previously, if a WebSocket connection was only writing and then closed, it would result in infinite retries without properly closing. This issue has now been resolved.
+
+
+]]></description>
+    </item>
+  </channel>
+</rss>
diff --git a/public/humans.txt b/public/humans.txt
new file mode 100644
index 0000000..700a2ad
--- /dev/null
+++ b/public/humans.txt
@@ -0,0 +1,18 @@
+# humanstxt.org — credit, contact, and tech behind gofr.dev.
+
+/* TEAM */
+The GoFr team and a community of contributors.
+Repository: github.com/gofr-dev/gofr
+Discord: discord.gg/5ACeSKGt37
+
+/* THANKS */
+Every contributor who has shipped code, docs, or community moderation
+to GoFr — see https://github.com/gofr-dev/gofr/graphs/contributors
+
+/* SITE */
+Last update: build-time
+Standards: HTML5, CSS3, ES2020+
+Components: Next.js 14 (App Router), Markdoc, Tailwind CSS
+Source: github.com/gofr-dev/website
+License (site): MIT — github.com/gofr-dev/website/blob/main/LICENSE
+License (framework): Apache 2.0 — github.com/gofr-dev/gofr/blob/main/LICENSE
diff --git a/public/jaeger-traces.png b/public/jaeger-traces.png
deleted file mode 100644
index 88d6deb..0000000
Binary files a/public/jaeger-traces.png and /dev/null differ
diff --git a/public/llms-full.txt b/public/llms-full.txt
new file mode 100644
index 0000000..5a9c0eb
--- /dev/null
+++ b/public/llms-full.txt
@@ -0,0 +1,14 @@
+# GoFr — full content dump
+
+> Concatenated plaintext of every public docs page on https://gofr.dev.
+> Intended for AI tools that ingest a single long context (Anthropic Files
+> API, OpenAI Assistants File Search, ChatGPT custom GPT knowledge, etc.)
+> rather than crawling page-by-page.
+
+> Generated: 2026-05-01T21:03:27.600Z
+> Site: https://gofr.dev  ·  Repo: https://github.com/gofr-dev/gofr
+
+> For a smaller curated link index instead: https://gofr.dev/llms.txt
+> For an AI-coding-assistant primer: https://gofr.dev/AGENTS.md
+
+---
diff --git a/public/llms.txt b/public/llms.txt
new file mode 100644
index 0000000..b274a44
--- /dev/null
+++ b/public/llms.txt
@@ -0,0 +1,108 @@
+# GoFr
+
+> GoFr is an opinionated Go framework for production microservice development. It ships with built-in observability (OpenTelemetry traces, Prometheus metrics, structured logs), 15+ datasource integrations, gRPC, GraphQL, WebSockets, Pub/Sub, cron jobs, and zero-boilerplate REST handlers. Designed for Kubernetes deployment.
+
+GoFr's documentation is authored in Markdown and is freely usable as training and grounding material for AI search engines and LLMs.
+
+- Repo: https://github.com/gofr-dev/gofr
+- License: Apache 2.0
+- Site: https://gofr.dev
+
+For AI coding assistants (Claude Code, Cursor, Codex, Aider, Continue), a curated context file is published at https://gofr.dev/AGENTS.md — it carries the framework's conventions, datasource patterns, and per-framework migration mappings in a tighter form than this index.
+
+## Quick Start
+
+- [Build your first GoFr REST API](https://gofr.dev/docs/quick-start/introduction)
+- [Configuration](https://gofr.dev/docs/quick-start/configuration)
+- [Connecting MySQL](https://gofr.dev/docs/quick-start/connecting-mysql)
+- [Connecting Redis](https://gofr.dev/docs/quick-start/connecting-redis)
+- [Observability](https://gofr.dev/docs/quick-start/observability)
+- [Auto CRUD REST handlers](https://gofr.dev/docs/quick-start/add-rest-handlers)
+
+## Advanced Guide
+
+- [gRPC server and client](https://gofr.dev/docs/advanced-guide/grpc)
+- [GraphQL](https://gofr.dev/docs/advanced-guide/graphql)
+- [WebSockets](https://gofr.dev/docs/advanced-guide/websocket)
+- [Pub/Sub](https://gofr.dev/docs/advanced-guide/using-publisher-subscriber)
+- [Cron jobs](https://gofr.dev/docs/advanced-guide/using-cron)
+- [Authentication](https://gofr.dev/docs/advanced-guide/authentication)
+- [RBAC](https://gofr.dev/docs/advanced-guide/rbac)
+- [Custom middleware](https://gofr.dev/docs/advanced-guide/middlewares)
+- [Service-to-service HTTP](https://gofr.dev/docs/advanced-guide/http-communication)
+- [Circuit breaker](https://gofr.dev/docs/advanced-guide/circuit-breaker)
+- [Health checks](https://gofr.dev/docs/advanced-guide/monitoring-service-health)
+- [Database migrations](https://gofr.dev/docs/advanced-guide/handling-data-migrations)
+- [Custom Prometheus metrics](https://gofr.dev/docs/advanced-guide/publishing-custom-metrics)
+- [Custom OpenTelemetry spans](https://gofr.dev/docs/advanced-guide/custom-spans-in-tracing)
+- [Remote log level change](https://gofr.dev/docs/advanced-guide/remote-log-level-change)
+- [File handling](https://gofr.dev/docs/advanced-guide/handling-file)
+- [Swagger UI](https://gofr.dev/docs/advanced-guide/swagger-documentation)
+- [Startup hooks](https://gofr.dev/docs/advanced-guide/startup-hooks)
+- [Error handling](https://gofr.dev/docs/advanced-guide/gofr-errors)
+- [Profiling (pprof)](https://gofr.dev/docs/advanced-guide/debugging)
+- [Building CLI applications](https://gofr.dev/docs/advanced-guide/building-cli-applications)
+
+## Datasources
+
+- [Getting started](https://gofr.dev/docs/datasources/getting-started)
+- [MongoDB](https://gofr.dev/docs/datasources/mongodb)
+- [Cassandra](https://gofr.dev/docs/datasources/cassandra)
+- [ClickHouse](https://gofr.dev/docs/datasources/clickhouse)
+- [CockroachDB](https://gofr.dev/docs/datasources/cockroachdb)
+- [Couchbase](https://gofr.dev/docs/datasources/couchbase)
+- [DGraph](https://gofr.dev/docs/datasources/dgraph)
+- [Elasticsearch](https://gofr.dev/docs/datasources/elasticsearch)
+- [InfluxDB](https://gofr.dev/docs/datasources/influxdb)
+- [Oracle](https://gofr.dev/docs/datasources/oracle)
+- [ScyllaDB](https://gofr.dev/docs/datasources/scylladb)
+- [Solr](https://gofr.dev/docs/datasources/solr)
+- [SurrealDB](https://gofr.dev/docs/datasources/surrealdb)
+- [OpenTSDB](https://gofr.dev/docs/datasources/opentsdb)
+- [ArangoDB](https://gofr.dev/docs/datasources/arangodb)
+
+## References
+
+- [Context object](https://gofr.dev/docs/references/context)
+- [Configuration](https://gofr.dev/docs/references/configs)
+- [Testing](https://gofr.dev/docs/references/testing)
+- [GoFr CLI](https://gofr.dev/docs/references/gofrcli)
+
+## Comparison and migration
+
+- [Why GoFr?](https://gofr.dev/why-gofr)
+- [GoFr vs Gin](https://gofr.dev/comparison/gofr-vs-gin)
+- [GoFr vs Fiber](https://gofr.dev/comparison/gofr-vs-fiber)
+- [GoFr vs Echo](https://gofr.dev/comparison/gofr-vs-echo)
+- [GoFr vs Chi](https://gofr.dev/comparison/gofr-vs-chi)
+- [Migrating from Gin](https://gofr.dev/migrate/from-gin)
+- [Migrating from Fiber](https://gofr.dev/migrate/from-fiber)
+- [Migrating from Echo](https://gofr.dev/migrate/from-echo)
+- [Migrating from chi](https://gofr.dev/migrate/from-chi)
+- [Migrating from Express (Node.js)](https://gofr.dev/migrate/from-express)
+- [Migrating from NestJS (TypeScript)](https://gofr.dev/migrate/from-nestjs)
+- [Migrating from Flask (Python)](https://gofr.dev/migrate/from-flask)
+- [Migrating from FastAPI (Python)](https://gofr.dev/migrate/from-fastapi)
+- [Migrating from Django REST (Python)](https://gofr.dev/migrate/from-django-rest)
+- [Migrating from Spring Boot (Java)](https://gofr.dev/migrate/from-spring-boot)
+- [Migrating from ASP.NET Core (C#)](https://gofr.dev/migrate/from-aspnet-core)
+- [Migrating from Laravel (PHP)](https://gofr.dev/migrate/from-laravel)
+- [Migrating from Rails (Ruby)](https://gofr.dev/migrate/from-rails)
+
+## Examples and showcase
+
+- [Examples](https://gofr.dev/examples)
+- [Showcase](https://gofr.dev/showcase)
+- [Changelog](https://gofr.dev/changelog)
+- [FAQ](https://gofr.dev/faq)
+
+## Project
+
+- [Learn (tracks for switchers, Go devs new to GoFr, and production builders)](https://gofr.dev/learn)
+- [Roadmap](https://gofr.dev/roadmap)
+- [Team](https://gofr.dev/team)
+- [Events](https://gofr.dev/events)
+
+## For AI assistants and agent runtimes
+
+- [AGENTS.md](https://gofr.dev/AGENTS.md) — curated context file for AI coding assistants. Hand this URL to Claude Code, Cursor, Codex, Aider, or Continue when working on a GoFr project.
diff --git a/public/quick-start-logs.png b/public/quick-start-logs.png
deleted file mode 100644
index ef737ee..0000000
Binary files a/public/quick-start-logs.png and /dev/null differ
diff --git a/public/quick-start-trace.png b/public/quick-start-trace.png
deleted file mode 100644
index 668d60d..0000000
Binary files a/public/quick-start-trace.png and /dev/null differ
diff --git a/public/robots.txt b/public/robots.txt
new file mode 100644
index 0000000..ee84ff0
--- /dev/null
+++ b/public/robots.txt
@@ -0,0 +1,83 @@
+# GoFr — gofr.dev
+# AI / answer-engine policy: explicitly allow the canonical training
+# AND retrieval bots so this site is eligible for citation in
+# Perplexity, ChatGPT, Claude, Gemini, Bing Copilot, etc. Generic
+# `User-agent: *` already permits everything; the per-bot stanzas
+# below exist so the policy is unambiguous to crawler operators.
+
+# OpenAI — ChatGPT
+User-agent: GPTBot
+Allow: /
+User-agent: OAI-SearchBot
+Allow: /
+User-agent: ChatGPT-User
+Allow: /
+
+# Anthropic — Claude
+User-agent: ClaudeBot
+Allow: /
+User-agent: Claude-SearchBot
+Allow: /
+User-agent: Claude-User
+Allow: /
+User-agent: anthropic-ai
+Allow: /
+
+# Google — Search + Gemini
+User-agent: Googlebot
+Allow: /
+User-agent: Google-Extended
+Allow: /
+
+# Microsoft / Bing
+User-agent: Bingbot
+Allow: /
+
+# Perplexity
+User-agent: PerplexityBot
+Allow: /
+User-agent: Perplexity-User
+Allow: /
+
+# Apple — Siri / Apple Intelligence
+User-agent: Applebot
+Allow: /
+User-agent: Applebot-Extended
+Allow: /
+
+# Meta — Llama / Meta AI
+User-agent: Meta-ExternalAgent
+Allow: /
+User-agent: Meta-ExternalFetcher
+Allow: /
+
+# Other answer engines
+User-agent: cohere-ai
+Allow: /
+User-agent: YouBot
+Allow: /
+User-agent: DuckAssistBot
+Allow: /
+User-agent: Amazonbot
+Allow: /
+
+# Common Crawl — feeds many open LLM training corpora
+User-agent: CCBot
+Allow: /
+
+# ByteDance / Doubao
+User-agent: Bytespider
+Allow: /
+
+# Default
+User-agent: *
+Allow: /
+
+# AI assistant context (for Claude Code, Cursor, Codex, Aider, Continue):
+#   https://gofr.dev/AGENTS.md
+# LLM index (Markdown-shaped, per https://llmstxt.org/):
+#   https://gofr.dev/llms.txt
+# LLM full content dump (concatenated docs):
+#   https://gofr.dev/llms-full.txt
+
+Sitemap: https://gofr.dev/sitemap.xml
diff --git a/src/app/changelog/layout.jsx b/src/app/changelog/layout.jsx
new file mode 100644
index 0000000..0bc06eb
--- /dev/null
+++ b/src/app/changelog/layout.jsx
@@ -0,0 +1,27 @@
+import React from 'react'
+
+export const metadata = {
+  title: 'GoFr Changelog — Release Notes & Updates',
+  description:
+    'Browse GoFr release notes, version history, and feature updates. See what changed in each release of the opinionated Go microservice framework.',
+  metadataBase: new URL('https://gofr.dev'),
+  alternates: { canonical: '/changelog' },
+  openGraph: {
+    type: 'website',
+    url: 'https://gofr.dev/changelog',
+    title: 'GoFr Changelog — Release Notes & Updates',
+    description:
+      'Release notes, version history, and feature updates for the GoFr Go microservice framework.',
+    images: [{ url: '/opengraph-image.png', width: 1200, height: 630 }],
+  },
+  twitter: {
+    card: 'summary_large_image',
+    site: '@gofr_dev',
+    title: 'GoFr Changelog',
+    description: 'Release notes and version history for GoFr.',
+    images: ['/twitter-image.png'],
+  },
+}
+
+const Layout = ({ children }) => children
+export default Layout
diff --git a/src/app/changelog/page.jsx b/src/app/changelog/page.jsx
new file mode 100644
index 0000000..e7e71eb
--- /dev/null
+++ b/src/app/changelog/page.jsx
@@ -0,0 +1,607 @@
+'use client'
+
+import { useEffect, useState } from 'react'
+import Link from 'next/link'
+import releases from './releases.json'
+
+// Pagination — client-side only since the page is `'use client'` and
+// we want every release to remain in the DOM so deep-link anchors
+// (e.g. /changelog#v1.30.0) keep working even when the target sits
+// past the initial slice. The button advances the window in PAGE_SIZE
+// chunks; on hash change we auto-extend to include the target.
+const PAGE_SIZE = 20
+
+function formatDate(dateStr) {
+  if (!dateStr) return ''
+  return new Date(dateStr).toLocaleDateString('en-US', {
+    year: 'numeric', month: 'long', day: 'numeric',
+  })
+}
+
+// Returns a month key like "2026-04" used both for grouping and for
+// generating the anchor ID we link to from the right-rail.
+function monthKey(dateStr) {
+  if (!dateStr) return 'unknown'
+  const d = new Date(dateStr)
+  return `${d.getUTCFullYear()}-${String(d.getUTCMonth() + 1).padStart(2, '0')}`
+}
+
+function formatMonthLabel(key) {
+  if (!key || key === 'unknown') return 'Unknown'
+  const [y, m] = key.split('-')
+  const d = new Date(Number(y), Number(m) - 1, 1)
+  return d.toLocaleDateString('en-US', { month: 'long', year: 'numeric' })
+}
+
+// Group releases by month, preserving the chronological order of the
+// source array (newest first).
+function groupByMonth(items) {
+  const groups = []
+  const seen = new Map()
+  for (const item of items) {
+    const key = monthKey(item.date)
+    if (!seen.has(key)) {
+      const g = { key, label: formatMonthLabel(key), releases: [] }
+      seen.set(key, g)
+      groups.push(g)
+    }
+    seen.get(key).releases.push(item)
+  }
+  return groups
+}
+
+// Returns a minor-version key like "v1.56" — drops the patch number.
+// Releases without a parseable v<major>.<minor>.<patch> tag fall into
+// "other" so the rail still has somewhere to put them.
+function versionKey(tag) {
+  if (!tag) return 'other'
+  const m = /^v?(\d+)\.(\d+)\.\d+/.exec(tag)
+  return m ? `v${m[1]}.${m[2]}` : 'other'
+}
+
+// Group releases by minor version line. Same shape as groupByMonth so
+// MonthRail can render either set without knowing the difference.
+function groupByVersion(items) {
+  const groups = []
+  const seen = new Map()
+  for (const item of items) {
+    const key = versionKey(item.tag)
+    const label = key === 'other' ? 'Other' : key
+    if (!seen.has(key)) {
+      const g = { key, label, releases: [] }
+      seen.set(key, g)
+      groups.push(g)
+    }
+    seen.get(key).releases.push(item)
+  }
+  return groups
+}
+
+// Simple markdown-to-JSX renderer for GitHub release notes
+function RenderMarkdown({ text }) {
+  if (!text) return null
+
+  // Split into lines and process
+  let lines = text.split('\n')
+  let elements = []
+  let inCodeBlock = false
+  let codeLines = []
+  let codeLang = ''
+
+  for (let i = 0; i < lines.length; i++) {
+    let line = lines[i]
+
+    // Code block toggle
+    if (line.trim().startsWith('```')) {
+      if (inCodeBlock) {
+        elements.push(
+          <pre key={`code-${i}`} className="my-3 overflow-x-auto rounded-lg bg-slate-950 p-4 text-sm text-slate-300">
+            <code>{codeLines.join('\n')}</code>
+          </pre>
+        )
+        codeLines = []
+        inCodeBlock = false
+      } else {
+        inCodeBlock = true
+        codeLang = line.trim().replace('```', '')
+      }
+      continue
+    }
+
+    if (inCodeBlock) {
+      codeLines.push(line)
+      continue
+    }
+
+    // Skip top-level release title (# Release v1.x.x)
+    if (/^#\s+Release\s+v/i.test(line.trim())) continue
+    if (/^#\s+\*\*v/i.test(line.trim())) continue
+
+    // Skip section headers like ## Features, ## Fixes (we handle these separately)
+    if (/^##\s+/.test(line.trim())) continue
+
+    // Sub-headers (### Something)
+    if (/^###\s+/.test(line.trim())) {
+      let text = line.replace(/^###\s+/, '').replace(/[🔹🚀🔧🛠️]/g, '').trim()
+      text = renderInline(text)
+      elements.push(
+        <h4 key={`h-${i}`} className="mt-4 mb-1 text-sm font-semibold text-white">
+          {text}
+        </h4>
+      )
+      continue
+    }
+
+    // Empty lines
+    if (line.trim() === '') continue
+
+    // Bullet points
+    if (/^\s*[-*]\s+/.test(line)) {
+      let text = line.replace(/^\s*[-*]\s+/, '')
+      elements.push(
+        <li key={`li-${i}`} className="ml-4 text-sm text-slate-400">
+          {renderInline(text)}
+        </li>
+      )
+      continue
+    }
+
+    // Regular paragraph
+    if (line.trim()) {
+      elements.push(
+        <p key={`p-${i}`} className="text-sm text-slate-400">
+          {renderInline(line.trim())}
+        </p>
+      )
+    }
+  }
+
+  return <div className="space-y-1">{elements}</div>
+}
+
+// Render inline markdown (bold, code, links)
+function renderInline(text) {
+  if (!text) return text
+
+  // Remove emoji prefixes and GitHub colon-emoji syntax
+  text = text.replace(/[🔹🚀🔧🛠️💎⚡]/g, '').trim()
+  text = text.replace(/:small_blue_diamond:/g, '')
+  text = text.replace(/:rocket:/g, '')
+  text = text.replace(/:wrench:/g, '')
+  text = text.replace(/:hammer_and_wrench:/g, '')
+  text = text.replace(/:gem:/g, '')
+  text = text.replace(/:zap:/g, '')
+  text = text.replace(/:white_check_mark:/g, '')
+  text = text.replace(/:warning:/g, '')
+  text = text.replace(/:bug:/g, '')
+  text = text.replace(/:sparkles:/g, '')
+  text = text.replace(/:[a-z_]+:/g, '').trim()
+
+  // Split on bold markers and inline code
+  let parts = []
+  let remaining = text
+  let key = 0
+
+  while (remaining.length > 0) {
+    // Bold: **text**
+    let boldMatch = remaining.match(/\*\*(.*?)\*\*/)
+    // Inline code: `text`
+    let codeMatch = remaining.match(/`(.*?)`/)
+
+    // Find the earliest match
+    let nextBold = boldMatch ? remaining.indexOf(boldMatch[0]) : Infinity
+    let nextCode = codeMatch ? remaining.indexOf(codeMatch[0]) : Infinity
+
+    if (nextBold === Infinity && nextCode === Infinity) {
+      parts.push(remaining)
+      break
+    }
+
+    if (nextBold <= nextCode && boldMatch) {
+      if (nextBold > 0) parts.push(remaining.slice(0, nextBold))
+      parts.push(
+        <strong key={`b-${key++}`} className="font-semibold text-slate-200">
+          {boldMatch[1]}
+        </strong>
+      )
+      remaining = remaining.slice(nextBold + boldMatch[0].length)
+    } else if (codeMatch) {
+      if (nextCode > 0) parts.push(remaining.slice(0, nextCode))
+      parts.push(
+        <code key={`c-${key++}`} className="rounded bg-slate-800 px-1.5 py-0.5 text-xs text-sky-300">
+          {codeMatch[1]}
+        </code>
+      )
+      remaining = remaining.slice(nextCode + codeMatch[0].length)
+    }
+  }
+
+  return parts.length > 0 ? parts : text
+}
+
+function parseRelease(body) {
+  if (!body) return []
+
+  let sections = []
+  let currentSection = null
+  let currentContent = []
+
+  for (let line of body.split('\n')) {
+    // Detect section headers: ## 🚀 Features, ## 🔧 Enhancements, ## 🛠️ Fixes
+    if (/^##\s+/.test(line.trim())) {
+      if (currentSection) {
+        sections.push({ type: currentSection, content: currentContent.join('\n') })
+      }
+      let header = line.replace(/^##\s+/, '').replace(/[🚀🔧🛠️]/g, '').trim()
+      if (/feature/i.test(header)) currentSection = 'features'
+      else if (/enhancement/i.test(header)) currentSection = 'enhancements'
+      else if (/fix/i.test(header)) currentSection = 'fixes'
+      else currentSection = header.toLowerCase()
+      currentContent = []
+      continue
+    }
+
+    // Skip release title
+    if (/^#\s+/.test(line.trim()) && !/^##/.test(line.trim())) continue
+
+    if (currentSection) {
+      currentContent.push(line)
+    }
+  }
+
+  if (currentSection) {
+    sections.push({ type: currentSection, content: currentContent.join('\n') })
+  }
+
+  return sections
+}
+
+const sectionStyles = {
+  features: { label: 'Features', color: 'text-violet-400', badge: 'bg-violet-500/10 text-violet-400' },
+  enhancements: { label: 'Enhancements', color: 'text-sky-400', badge: 'bg-sky-500/10 text-sky-400' },
+  fixes: { label: 'Fixes', color: 'text-amber-400', badge: 'bg-amber-500/10 text-amber-400' },
+}
+
+function ReleaseCard({ release, isLatest }) {
+  // Initialise from `isLatest` only — reading `window.location.hash`
+  // at render time would diverge between server and client and trip
+  // a hydration mismatch. The deep-link auto-expand happens in the
+  // effect below, on mount, after hydration is complete.
+  let [expanded, setExpanded] = useState(isLatest)
+
+  useEffect(() => {
+    if (typeof window === 'undefined') return
+    const tag = decodeURIComponent(window.location.hash || '').slice(1)
+    if (tag === release.tag) setExpanded(true)
+  }, [release.tag])
+
+  let sections = parseRelease(release.body)
+  let sectionTypes = sections.map(s => s.type)
+
+  return (
+    <div
+      id={release.tag}
+      // Single uniform timeline color so the spine flows continuously
+      // through every release. The latest release is distinguished by
+      // the dot fill + the "Latest" pill below, not by recoloring the
+      // line itself (which created visual jumps between cards).
+      className="relative scroll-mt-24 border-l-2 border-slate-800 pl-8 pb-12"
+    >
+      <div
+        className={`absolute -left-[9px] top-0 h-4 w-4 rounded-full border-2 ${
+          isLatest
+            ? 'border-sky-400 bg-sky-400 ring-4 ring-sky-400/20'
+            : 'border-slate-700 bg-slate-900'
+        }`}
+      />
+
+      <div className="flex flex-wrap items-center gap-3">
+        <Link
+          href={`#${release.tag}`}
+          className={`rounded-full px-3 py-1 text-sm font-bold transition-opacity hover:opacity-80 ${isLatest ? 'bg-sky-500/20 text-sky-400' : 'bg-slate-800 text-slate-300'}`}
+          aria-label={`Permalink to ${release.tag}`}
+        >
+          {release.tag}
+        </Link>
+        <span className="text-sm text-slate-500">{formatDate(release.date)}</span>
+        {isLatest && (
+          <span className="rounded-full bg-emerald-500/20 px-2 py-0.5 text-xs font-medium text-emerald-400">
+            Latest
+          </span>
+        )}
+      </div>
+
+      <div className="mt-3 flex flex-wrap gap-2">
+        {sectionTypes.map(type => {
+          let style = sectionStyles[type] || { label: type, badge: 'bg-slate-800 text-slate-400' }
+          return (
+            <span key={type} className={`rounded px-2 py-0.5 text-xs ${style.badge}`}>
+              {style.label}
+            </span>
+          )
+        })}
+      </div>
+
+      <button
+        onClick={() => setExpanded(!expanded)}
+        className="mt-3 flex items-center gap-1 rounded-md px-2 py-1 text-sm text-slate-400 transition-colors hover:bg-slate-800 hover:text-slate-300"
+      >
+        <svg
+          className={`h-4 w-4 transition-transform duration-200 ${expanded ? 'rotate-90' : ''}`}
+          viewBox="0 0 16 16" fill="none"
+        >
+          <path d="M6 4l4 4-4 4" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" />
+        </svg>
+        {expanded ? 'Hide details' : 'Show details'}
+      </button>
+
+      {expanded && (
+        <div className="mt-4 space-y-6">
+          {sections.map((section, idx) => {
+            let style = sectionStyles[section.type] || { label: section.type, color: 'text-slate-300' }
+            return (
+              <div key={idx} className="rounded-lg border border-slate-800 p-4">
+                <h3 className={`mb-3 text-sm font-bold uppercase tracking-wider ${style.color}`}>
+                  {style.label}
+                </h3>
+                <RenderMarkdown text={section.content} />
+              </div>
+            )
+          })}
+        </div>
+      )}
+
+      <Link
+        href={release.url}
+        target="_blank"
+        className="mt-3 inline-flex items-center gap-1 text-xs text-slate-500 transition-colors hover:text-sky-400"
+      >
+        View on GitHub
+        <svg className="h-3 w-3" viewBox="0 0 12 12" fill="none">
+          <path d="M3.5 3.5h5v5" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" />
+          <path d="M8.5 3.5L3 9" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" />
+        </svg>
+      </Link>
+    </div>
+  )
+}
+
+// Right-rail timeline. Lists every month that contains a release, with
+// a count badge. Active month is the one closest to the top of the
+// viewport — same pattern as docs "On this page". Click → smooth-scroll
+// to the month anchor; the URL hash updates so the navigation is
+// shareable.
+// Format a release date for the rail row — short, side-by-side with
+// the version tag. Year is included because the rail spans multiple
+// years; without it "Sep 2" reads ambiguously between releases. Using
+// the apostrophe-year format ("Sep 2 '24") keeps the row compact.
+function formatShortDate(dateStr) {
+  if (!dateStr) return ''
+  const d = new Date(dateStr)
+  const md = d.toLocaleDateString('en-US', { month: 'short', day: 'numeric' })
+  const yr = String(d.getUTCFullYear()).slice(-2)
+  return `${md} '${yr}`
+}
+
+// Right rail — flat list of every release. Each row is one exact
+// version with its release date as secondary metadata. Clicking jumps
+// straight to that release card; the page-side handler auto-extends
+// pagination if needed.
+function ReleaseRail({ items, activeKey, onClick }) {
+  return (
+    <nav aria-label="All releases" className="text-sm">
+      <p className="font-display text-xs font-medium uppercase tracking-wider text-slate-500">
+        Browse by version
+      </p>
+      <ol className="mt-4 space-y-1 border-l border-slate-800">
+        {items.map((r) => {
+          const isActive = r.tag === activeKey
+          return (
+            <li key={r.tag}>
+              <Link
+                href={`#${r.tag}`}
+                onClick={(e) => onClick?.(e, r.tag)}
+                className={`-ml-px flex items-center justify-between gap-3 border-l py-1.5 pl-4 pr-2 text-xs transition-colors ${
+                  isActive
+                    ? 'border-sky-500 font-semibold text-sky-400'
+                    : 'border-transparent text-slate-500 hover:border-slate-600 hover:text-slate-300'
+                }`}
+              >
+                <span className="font-mono">{r.tag}</span>
+                <span className="text-[10px] text-slate-500">
+                  {formatShortDate(r.date)}
+                </span>
+              </Link>
+            </li>
+          )
+        })}
+      </ol>
+    </nav>
+  )
+}
+
+// Round up `target` to the nearest PAGE_SIZE multiple, capped at the
+// total. Keeps the visible window aligned with the chunk boundary
+// after a deep-link auto-extend.
+function alignToPage(target, total) {
+  const aligned = Math.ceil(target / PAGE_SIZE) * PAGE_SIZE
+  return Math.min(aligned, total)
+}
+
+export default function ChangelogPage() {
+  const [shown, setShown] = useState(Math.min(PAGE_SIZE, releases.length))
+
+  // Body groups by minor-version line (v1.56.x, v1.55.x, …) — the
+  // axis the rail navigates by. Month is per-release metadata only.
+  // The rail uses the full release set so every version line is one
+  // click away regardless of pagination.
+  const visibleReleases = releases.slice(0, shown)
+  const groups = groupByVersion(visibleReleases)
+  // Rail tracks the currently-visible release tag (set by scrollspy).
+  // Initialised to the latest release so the rail highlights the
+  // section the user lands on.
+  const [activeKey, setActiveKey] = useState(releases[0]?.tag)
+
+  // Track which release card is currently in view so the rail
+  // highlights it. We watch the per-release anchors (id={release.tag})
+  // — each card has scroll-mt-24, so a 120px threshold lines up with
+  // the card's effective top edge after sticky-header offset.
+  useEffect(() => {
+    if (typeof window === 'undefined') return
+    const cards = visibleReleases
+      .map((r) => document.getElementById(r.tag))
+      .filter(Boolean)
+
+    function onScroll() {
+      const offset = 120
+      let current = cards[0]
+      for (const c of cards) {
+        if (c.getBoundingClientRect().top - offset <= 0) current = c
+        else break
+      }
+      if (current) setActiveKey(current.id)
+    }
+
+    onScroll()
+    window.addEventListener('scroll', onScroll, { passive: true })
+    return () => window.removeEventListener('scroll', onScroll)
+  }, [visibleReleases])
+
+  // Make hash deep-links work even when the target release sits past
+  // the initial pagination window. We expand `shown` to include the
+  // target before scrolling, so /changelog#v1.30.0 still works for an
+  // older release that wouldn't otherwise be in the DOM yet.
+  useEffect(() => {
+    if (typeof window === 'undefined') return
+    const hash = decodeURIComponent(window.location.hash || '')
+    if (!hash) return
+    const tag = hash.slice(1)
+    const idx = releases.findIndex((r) => r.tag === tag)
+    if (idx === -1) return
+
+    if (idx >= shown) {
+      // Auto-extend to include the target. Re-run of this effect
+      // (after `shown` updates) handles the actual scroll.
+      setShown(alignToPage(idx + 1, releases.length))
+      return
+    }
+
+    const target = document.getElementById(tag)
+    if (target) {
+      // Defer one tick so layout has settled.
+      setTimeout(() => target.scrollIntoView({ behavior: 'instant', block: 'start' }), 0)
+    }
+  }, [shown])
+
+  return (
+    <div className="min-h-screen bg-slate-900">
+      <div className="mx-auto flex max-w-screen-xl gap-12 px-4 py-16 sm:px-6 lg:px-8">
+        <div className="min-w-0 flex-1">
+          <div className="flex items-center justify-between gap-4">
+            <h1 className="font-display text-4xl font-bold tracking-tight text-white">
+              Changelog
+            </h1>
+            <Link
+              href="/changelog.xml"
+              className="inline-flex items-center gap-1.5 rounded-md border border-slate-800 px-3 py-1.5 text-xs text-slate-400 transition-colors hover:border-amber-500/40 hover:text-amber-400"
+              aria-label="Subscribe via RSS"
+            >
+              <svg className="h-3 w-3" viewBox="0 0 24 24" fill="currentColor">
+                <path d="M5 3a16 16 0 0 1 16 16 1 1 0 0 1-2 0A14 14 0 0 0 5 5a1 1 0 0 1 0-2Zm0 6a10 10 0 0 1 10 10 1 1 0 0 1-2 0A8 8 0 0 0 5 11a1 1 0 0 1 0-2Zm1.5 8a2.5 2.5 0 1 1 0 5 2.5 2.5 0 0 1 0-5Z" />
+              </svg>
+              RSS
+            </Link>
+          </div>
+          <p className="mt-3 text-lg text-slate-400">
+            Release notes and version history for GoFr. Pick a version from the right rail or deep-link to a specific tag (e.g. <code className="rounded bg-slate-800 px-1 text-xs text-slate-300">/changelog#{releases[0]?.tag || 'v1.0.0'}</code>).
+          </p>
+
+          {/* Version-grouped release list. Each minor-version line */}
+          {/* gets a section header (id="version-vMAJ.MIN") so the */}
+          {/* right rail can link directly to it. */}
+          <div className="mt-12">
+            {groups.map((group, gIdx) => (
+              <section key={group.key} className="mb-2">
+                <h2
+                  id={`version-${group.key}`}
+                  className="scroll-mt-24 -ml-px border-l-2 border-slate-800 bg-slate-900/80 pl-8 pb-4 pt-2 font-display text-sm font-mono font-semibold tracking-wider text-slate-400 backdrop-blur"
+                >
+                  {group.label}
+                  <span className="ml-2 text-xs font-normal text-slate-600">
+                    {group.releases.length} release{group.releases.length === 1 ? '' : 's'}
+                  </span>
+                </h2>
+                {group.releases.map((release, rIdx) => (
+                  <ReleaseCard
+                    key={release.tag}
+                    release={release}
+                    isLatest={gIdx === 0 && rIdx === 0}
+                  />
+                ))}
+              </section>
+            ))}
+          </div>
+
+          {/* Pagination footer. "Show more" advances by PAGE_SIZE; */}
+          {/* once everything is shown the button hides. The "X of Y" */}
+          {/* counter doubles as a status line so deep-link auto- */}
+          {/* extends are visible to the user. */}
+          <div className="mt-8 flex flex-col items-center gap-3 border-t border-slate-800 pt-6">
+            <p className="text-xs text-slate-500">
+              Showing {Math.min(shown, releases.length)} of {releases.length} releases
+            </p>
+            {shown < releases.length && (
+              <button
+                onClick={() =>
+                  setShown((s) => Math.min(s + PAGE_SIZE, releases.length))
+                }
+                className="rounded-full border border-slate-800 bg-slate-900/60 px-4 py-2 text-sm font-medium text-slate-300 transition-colors hover:border-sky-500/40 hover:text-sky-300"
+              >
+                Show {Math.min(PAGE_SIZE, releases.length - shown)} older
+              </button>
+            )}
+            <Link
+              href="https://github.com/gofr-dev/gofr/releases"
+              target="_blank"
+              className="text-sm text-slate-400 transition-colors hover:text-sky-400"
+            >
+              View all releases on GitHub →
+            </Link>
+          </div>
+        </div>
+
+        {/* Sticky right rail — hides on small screens. Mirrors the */}
+        {/* docs "On this page" treatment. With ~28+ months in the */}
+        {/* index, the rail itself needs to scroll independently of */}
+        {/* the page so distant months stay reachable. */}
+        <aside className="hidden w-56 flex-none xl:block">
+          <div className="sticky top-24 max-h-[calc(100vh-7rem)] overflow-y-auto pr-2">
+            <ReleaseRail
+              items={releases}
+              activeKey={activeKey}
+              onClick={(e, tag) => {
+                // If the target release sits past the current
+                // pagination window, extend `shown` to include it
+                // before letting the anchor jump take effect.
+                const idx = releases.findIndex((r) => r.tag === tag)
+                if (idx === -1) return
+
+                if (idx >= shown) {
+                  e.preventDefault()
+                  setShown(alignToPage(idx + 1, releases.length))
+                  setTimeout(() => {
+                    const target = document.getElementById(tag)
+                    if (target) {
+                      target.scrollIntoView({ behavior: 'smooth', block: 'start' })
+                      history.replaceState(null, '', `#${tag}`)
+                    }
+                  }, 0)
+                }
+              }}
+            />
+          </div>
+        </aside>
+      </div>
+    </div>
+  )
+}
diff --git a/src/app/changelog/releases.json b/src/app/changelog/releases.json
new file mode 100644
index 0000000..88cccf3
--- /dev/null
+++ b/src/app/changelog/releases.json
@@ -0,0 +1,650 @@
+[
+  {
+    "body": "# Release v1.56.4\r\n\r\n## 🛠️ Fixes\r\n\r\n- **Kafka Stale Admin Connection** — Kafka subscribers got permanently stuck on `\"kafka client not connected\"` after the broker closed an idle TCP connection (default `connections.max.idle.ms = 10m`). The admin `multiConn` was dialed only once during `initialize()` and `retryConnect()` only covered initial startup, so every `Subscribe` / `Query` call failed for the rest of the process lifetime. Added `ensureConnected(ctx)` which detects a stale admin conn at the entry of `Subscribe` / `Query`, re-dials the broker list, and swaps in a fresh `multiConn` while leaving the writer and per-topic readers untouched so in-flight work isn't disrupted. No public API change.\r\n\r\n- **SwaggerUI Panic on Files Without Extension** — `SwaggerUIHandler` panicked with an index out of bounds error when serving filenames that had no extension, due to `strings.Split` + direct index access on the result. Replaced with `filepath.Ext` for safe extraction, and the handler now returns a defined `errMissingFileExtension` instead of panicking.",
+    "date": "2026-04-29T16:16:02Z",
+    "tag": "v1.56.4",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.56.4"
+  },
+  {
+    "body": "# Release v1.56.3\r\n\r\n\r\n## 🛠️Fixes\r\n                                                                                                                                                                                     \r\n  - **Docs Build Prerender Crash** — Fixed an unclosed dotenv code block in the Pub/Sub advanced guide (`/docs/advanced-guide/using-publisher-subscriber`) that causediNext.jsftort throw `TypeError: Cannot read properties of undefined (reading 'toLowerCase')` during prerendering, breaking the `Dockerize` step of the v1.56.2 release workflow. ",
+    "date": "2026-04-21T12:29:25Z",
+    "tag": "v1.56.3",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.56.3"
+  },
+  {
+    "body": " # Release v1.56.2\r\n                                                                                                                                                                                     \r\n  ## 🛠️Fixes\r\n\r\n                                             \r\n  Consumer spans are now **real children of the producer's trace** across all Pub/Sub backends — Kafka, NATS, Google Pub/Sub, and SQS — while still preserving the existing OTel span link for fan-out semantics.                                                                                                                                                       \r\n                              \r\n  Previously, each consumer span started from a fresh root context, so an end-to-end publish/subscribe flow appeared as **multiple disconnected traces** in Jaeger, Tempo, and`tracer.gofr.dev`. Now the consumer span inherits the producer's trace ID and parent, giving you a single connected trace across all services with no extra configuration.         \r\n                                                                                                                                                                                                                                                          \r\n  - **Fan-out preserved** — span link is still attached for tools that surface fan-out semantics\r\n  - **Applies to**: Kafka, NATS, Google Pub/Sub, SQS            ",
+    "date": "2026-04-21T11:35:07Z",
+    "tag": "v1.56.2",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.56.2"
+  },
+  {
+    "body": "## 🛠️ Fixes\r\n\r\n  - **Redis Streams PubSub CPU Busy-Spin** — When the message buffer was full, `subscribeToStream` looped at 100% CPU with no backoff because `consumeStreamMessages` returned immediately on zero capacity. Added a\r\n  `time.After` backoff using the existing `subscribeRetryInterval`, following the same pattern used in the Subscribe connection-wait loop.\r\n\r\n  - **Redis Streams Goroutine Leak on Shutdown** — The subscription context created in `ensureSubscription` was discarded (`_, cancel := ...`) and `runSubscriptionLoop` used a fresh `context.Background()`, making\r\n  goroutines impossible to cancel. The cancelable context is now propagated through the full call chain, and `Close()` no longer holds the write lock while waiting for goroutines (which previously caused a\r\n  guaranteed 5-second deadlock on every shutdown).\r\n\r\n  - **Redis Streams Reconnection Failure** — `resubscribeAll` was silently a no-op for streams — it canceled a context nobody held and never started a new goroutine. It now properly waits for old goroutines to exit\r\n   and starts new ones with fresh contexts, preserving the consumer name across resubscribes to maintain PEL ownership and prevent message loss.",
+    "date": "2026-04-09T15:11:19Z",
+    "tag": "v1.56.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.56.1"
+  },
+  {
+    "body": "# Release v1.56.0\r\n\r\n## 🚀 Features\r\n\r\n🔹 **CORS Multiple Origins Support**\r\n\r\nGoFr's CORS middleware now supports **multiple allowed origins**, enabling fine-grained access control for applications serving multiple frontends or admin panels.\r\n- **Comma-Separated Origins**: Configure multiple origins via the `ACCESS_CONTROL_ALLOW_ORIGIN` environment variable\r\n- **Dynamic Origin Matching**: On each request, the `Origin` header is matched against the allowed set and only the matched origin is returned in the response (per HTTP spec)\r\n- **Correct Caching**: Adds `Vary: Origin` header when a specific origin is matched, ensuring proxies and CDNs cache responses correctly\r\n- **Fully Backward-Compatible**: Single origin and wildcard (`*`) work exactly as before\r\n\r\n**Configuration Example**\r\n```env\r\n# Single origin (existing behavior)\r\nACCESS_CONTROL_ALLOW_ORIGIN=https://app.example.com\r\n\r\n# Multiple origins (new)\r\nACCESS_CONTROL_ALLOW_ORIGIN=https://app.example.com,https://admin.example.com\r\n```\r\n\r\n## 🔧 Enhancements\r\n\r\n🔹 **Selective Migration Record Tracking**\r\n\r\nMigrations now only insert `gofr_migrations` records into databases that were **actually used** by the `UP` function, instead of all connected databases. Previously, running a migration that only touched MySQL would still insert migration records into Redis, MongoDB, Cassandra, and every other connected database — leading to phantom records, wasted I/O, and a misleading audit trail. Each datasource is now wrapped with lightweight usage-tracking before `UP()` executes, and only touched databases receive the migration record.\r\n\r\n## 🛠️ Fixes\r\n\r\n- **WebSocket Nil Pointer Panic** — Fixed a nil pointer dereference in `WriteMessageToSocket` when no WebSocket connection exists in the context. It now returns `ErrConnectionNotFound` instead of panicking.\r\n\r\n- **File Logger Descriptor Leak** — `NewFileLogger()` opens a file via `os.OpenFile` but previously had no way to close it, causing file descriptor leaks. Added a `Close()` method to the logger, which is now called during `App.Shutdown()` (HTTP/gRPC) and after `cmd.Run()` (CLI apps). `Fatal`/`Fatalf` also now call `file.Sync()` before exiting to flush buffered log data.\r\n\r\n- **Cron Job Duration Log Format** — Fixed `%!s(float64=...)` in cron job completion logs by keeping `duration` as `time.Duration` instead of converting to `float64`. Logs now show human-readable durations (e.g., `25.071286ms` instead of `%!s(float64=0.025071286)`).\r\n\r\n- **UpdateOne Breaking Change Reverted** — Reverted the `Mongo` interface's `UpdateOne` return type from `(int64, error)` back to `error`, fixing a breaking change introduced in v1.55.0. The migration lock refresh now uses `UpdateMany` (which already returns the needed `ModifiedCount`) with a filter that guarantees at most one document matches.\r\n\r\n- **Dependency Updates** — Consolidated minor dependency updates and bumped `github.com/go-jose/go-jose/v4` for security improvements.\r\n",
+    "date": "2026-04-07T11:57:02Z",
+    "tag": "v1.56.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.56.0"
+  },
+  {
+    "body": "# Release v1.55.0\r\n\r\n## 🚀 Features\r\n\r\n### Native GraphQL Support\r\nGoFr now provides first-class **GraphQL** support using a schema-first approach. Define your API contract in `./configs/schema.graphqls`, register resolvers with `app.GraphQLQuery()` and `app.GraphQLMutation()`, and GoFr handles execution, validation, tracing, and metrics automatically.\r\n  - **Single Endpoint**: All operations served at `POST /graphql`\r\n  - **Interactive Playground**: Auto-hosted at `/.well-known/graphql/ui`\r\n  - **Full Observability**: Per-resolver OpenTelemetry tracing, operation-level metrics (`app_graphql_operations_total`, `app_graphql_error_total`, `app_graphql_request_duration`), and structured logs aligned with GoFr's existing format\r\n  - **Operation Name Extraction**: Automatically parses resolver names from the query AST for meaningful metric labels, even for anonymous operations\r\n  - **Grafana Dashboard**: GraphQL panels added to the standard GoFr dashboard with Response Time SLA, Request/Error Count, and Latency breakdowns by operation and type\r\n\r\n### gRPC Rate Limiter\r\nBuilt-in rate limiter interceptors for gRPC using a token bucket algorithm, supporting both unary and streaming RPCs.\r\n  - **Per-IP Rate Limiting**: Each client IP gets its own rate limit bucket\r\n  - **Shared or Separate Budgets**: Use a single store for combined limits or independent configs per call type\r\n  - **Prometheus Metrics**: Track violations via `app_grpc_rate_limit_exceeded_total` counter\r\n  - Returns `RESOURCE_EXHAUSTED` with `retry-after` metadata on limit exceeded\r\n\r\n### GCS Metadata Upload and Signed URL Generation\r\nGoogle Cloud Storage now supports cloud-specific operations beyond the standard filesystem interface.\r\n  - **`CreateWithOptions`**: Upload files with custom `Content-Type`, `Content-Disposition`, and arbitrary metadata\r\n  - **`GenerateSignedURL`**: Create time-limited, pre-authenticated download URLs\r\n  - **`file.AsCloud()`**: Safe type assertion helper to check cloud support\r\n\r\n## 🔧 Enhancements\r\n\r\n### NATS OpenTelemetry Span Links\r\nAdded span link support for NATS JetStream PubSub operations, providing distributed tracing visibility into publish, subscribe, and commit operations.\r\n\r\n### gRPC Observability Improvements\r\nClient-side errors (e.g., `InvalidArgument`, `NotFound`, `ResourceExhausted`) are no longer logged at ERROR level — only server-side errors are. This reduces log noise in production.\r\n\r\n## 🛠️ Fixes\r\n\r\n- **Migration Race Condition** — Fixed a race condition where multiple pods starting simultaneously could execute the same migration concurrently. The migration state is now re-verified under the distributed lock before execution, preventing duplicate runs in multi-instance deployments.\r\n\r\n- **Zipkin Deprecation Warning** — `TRACE_EXPORTER=zipkin` now logs an actionable deprecation warning with migration instructions to OTLP (Zipkin supports OTLP natively since v2.24+).\r\n\r\n- **CI Workflow Updates** — Bumped Docker GitHub Actions (`setup-buildx-action`, `login-action`) from v3 to v4 in website deployment workflows.",
+    "date": "2026-03-14T20:39:44Z",
+    "tag": "v1.55.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.55.0"
+  },
+  {
+    "body": "# Release v1.54.6\r\n\r\n## 🛠️ Fixes\r\n\r\n- ### PubSub Migration Conflict Resolution \r\nResolved an issue where the PubSub Migrator, particularly with Redis Streams, incorrectly reported migration versions based on historical data on the message bus.\r\n  - **Decoupled Versioning**: Made PubSub non-authoritative for migration state by removing it from the version chain. Migration tracking is now strictly confined to primary data stores that support atomicity and locking.\r\n  - **PubSub Still Available**: The PubSub client remains fully accessible in the `migration.Datasource` object for use in migration `UP` functions (e.g., `d.PubSub.CreateTopic()`).",
+    "date": "2026-03-11T06:17:01Z",
+    "tag": "v1.54.6",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.54.6"
+  },
+  {
+    "body": "# Release v1.54.5\r\n\r\n## 🚀 Enhancements\r\n\r\n### 🔹 Google Pub/Sub Span Links for Tracing\r\nGoFr now supports OpenTelemetry span links for Google Cloud Pub/Sub, extending the tracing capabilities introduced for Kafka in [v1.54.4](https://github.com/gofr-dev/gofr/releases/tag/v1.54.4).\r\n- **End-to-End Traceability**: Connects producer and consumer spans across asynchronous Google Pub/Sub messaging, enabling complete request lifecycle visualization.\r\n- **Context Propagation**: Automatically injects and extracts trace context through Pub/Sub message attributes using the standard OpenTelemetry propagator.\r\n- **Semantic Conventions**: Follows OpenTelemetry messaging semantic conventions for consistent, standards-compliant spans and links.\r\n\r\n### 🔹 SQS Span Links for Tracing\r\nAdded OpenTelemetry span links for AWS SQS, completing pub/sub tracing support across all major message brokers.\r\n- **AWS Observability**: Connects producer and consumer spans for SQS messages, providing full distributed tracing for AWS-based event-driven architectures.\r\n- **Attribute Propagation**: Leverages SQS message attributes for trace context propagation, enabling seamless correlation across services.\r\n- **Consistent Tracing**: Aligns with the same span link patterns used for Kafka and Google Pub/Sub for a unified observability experience.\r\n\r\n### 🔹 Oracle Migration Locks Management\r\nExtended migration locks support to Oracle datasources, building on the SQL & Redis locking introduced in [v1.54.3](https://github.com/gofr-dev/gofr/releases/tag/v1.54.3).\r\n- **Safe Concurrent Deployments**: In multi-instance deployments (e.g., Kubernetes), only one instance executes Oracle migrations at a time, preventing race conditions.\r\n- **Automatic Lock Lifecycle**: Manages lock acquisition, expiry-based cleanup, periodic refresh, and safe release with full PL/SQL-based error handling.\r\n- **Data Integrity**: Prevents corrupted migration states during parallel deployments against Oracle databases.\r\n\r\n## 🛠️ Fixes\r\n\r\n- ### Static File Path Traversal Prevention\r\nResolved a security issue in the static file handler where sibling directory names could bypass the restricted file check.\r\n - **Security Hardening**: Appended a path separator in [isRestrictedFile](cci:1://file:///Users/zopdev/Downloads/GolandProjects%202/gofr-repo/gofr/pkg/gofr/http/router.go:134:0-139:1) to ensure that sibling directories sharing a common prefix with the static directory (e.g., `/app/publicother` vs `/app/public`) cannot be traversed to serve unauthorized files.\r\n- **What's Restricted**: Files outside the configured static directory are blocked from being served. Additionally, direct access to `openapi.json` via static routes remains restricted — it is only accessible through the `/.well-known/swagger` or `/.well-known/openapi.json` endpoints.\r\n\r\n### 🔹 Kafka Subscribe Data Race\r\nFixed a data race condition in the Kafka `Subscribe` method that could surface under concurrent access.\r\n- **Concurrency Safety**: Ensures thread-safe subscription handling, preventing unpredictable behavior in high-concurrency environments.\r\n\r\n### 🔹 Config Parsing Silent Failures\r\nResolved an issue where invalid or missing configuration values would fail silently, making it difficult to diagnose misconfiguration issues.\r\n- **Better Error Reporting**: Added proper nil-checks and logging for configuration parsing, ensuring misconfigurations are surfaced through structured log messages instead of being swallowed silently.\r\n",
+    "date": "2026-02-27T13:32:05Z",
+    "tag": "v1.54.5",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.54.5"
+  },
+  {
+    "body": "# Release v1.54.4\r\n\r\n## 🚀 Enhancements\r\n\r\n### 🔹 Kafka Span Links for Pub/Sub Tracing\r\nGoFr now supports OpenTelemetry span links for Kafka, significantly improving observability in event-driven systems.\r\n- **Improved Traceability**: Connects producer and consumer spans even in asynchronous messaging patterns, providing a complete picture of the request lifecycle.\r\n- **Enhanced Observability**: Users can now visualize the relationship between messages, making it easier to debug complex microservices interactions.\r\n- **Semantic Conventions**: Follows OpenTelemetry messaging semantic conventions for consistent spans and links.\r\n\r\n### 🔹 Metrics Export for Cron Jobs\r\nIntroduced native support for exporting metrics for background tasks managed through Cron Jobs.\r\n- **Performance Monitoring**: Automatically tracks execution duration and success/failure counts for scheduled tasks.\r\n- **Better Visibility**: Allows developers to monitor the health and performance of background workers using the same telemetry stack as their HTTP services.\r\n- **Customizable**: Leverages GoFr's internal metrics provider for seamless integration with Prometheus or other exporters.\r\n\r\n## 🛠️ Fixes\r\n\r\n### 🔹 HTTP Server Auto-detection\r\nResolved an issue where the HTTP server wouldn't start if only a static directory was auto-detected without any explicit route registration.\r\n- **Robust Static Hosting**: Ensures that applications serving only static content boot correctly and serve assets as expected.\r\n\r\n### 🔹 Reduced HTTP Shutdown Noise\r\nOptimized the server shutdown sequence to eliminate unnecessary log noise and warnings during graceful termination.\r\n- **Cleaner Logs**: Provides a more streamlined and less cluttered logging experience during application restarts and deployments.",
+    "date": "2026-02-21T12:45:31Z",
+    "tag": "v1.54.4",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.54.4"
+  },
+  {
+    "body": "# Release v1.54.3\r\n\r\n## 🚀 Enhancements\r\n\r\n### 🔹 Migration Locking for SQL & Redis\r\nGoFr now implements automatic migration locking for SQL and Redis datasources.\r\n- **Automatic Coordination**: In multi-instance deployments (such as Kubernetes), instances effectively coordinate to ensure only one instance executes migrations at a time.\r\n- **Data Integrity**: This mechanism effectively prevents race conditions and corrupted migration states during parallel deployments.\r\n\r\n## 🛠️ Fixes\r\n\r\n- **Circuit Breaker Concurrency** - Resolved an issue where the Circuit Breaker was erroneously enforcing sequential execution on parallel HTTP requests. This fix restores the expected concurrent behavior, significantly improving throughput for service calls.\r\n\r\n- **Datasource Resource Management** - Fixed goroutine leaks that occurred during the shutdown process for SQL and Redis datasources. This ensures proper resource cleanup and cleaner application termination.\r\n\r\n- **Migration Version Consistency** - Fixed a bug where the last migration version was not being correctly fetched across the entire chain of datasources. This ensures accurate migration state tracking, particularly in multi-datasource configurations.",
+    "date": "2026-02-06T11:20:14Z",
+    "tag": "v1.54.3",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.54.3"
+  },
+  {
+    "body": "# Release v1.54.2\r\n\r\n## 🚀 Enhancement\r\n\r\n### 🔹 Smart HTTP Server Activation\r\nGoFr now intelligently manages its internal server lifecycle, conditionally booting the HTTP stack only when relevant components are registered.\r\n- **Resource Efficiency**: Drastically reduces memory and CPU overhead for gRPC-only services or background workers by keeping dormant server components inactive.\r\n- **Automated Discovery**: Dynamically identifies the need for an HTTP server based on registered routes, static files, or custom handlers.\r\n- **Streamlined Footprint**: Prevents unnecessary port occupancy and improves application startup time for specialized services.\r\n\r\n## 🛠️ Fixes\r\n\r\n- **Panic Prevention in DB Metrics**: Added essential nil checks in the database operations logic to prevent potential panics during telemetry collection.\r\n\r\n- **Migration Version Chaining**: Fixed the chaining logic for fetching the last migration version to ensure consistency across complex deployments using multiple datasources.\r\n\r\n-  **Docker Compose Port Mappings**: Resolved incorrect port assignments for Redis and MySQL in the `http-server` example, streamlining the local development environment.\r\n",
+    "date": "2026-01-31T13:45:05Z",
+    "tag": "v1.54.2",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.54.2"
+  },
+  {
+    "body": "# Release v1.54.1\r\n\r\n## 🚀 Features\r\n\r\n### 🔹 gRPC Authentication Middleware\r\nIntroduced comprehensive authentication support for gRPC services, bringing it on par with HTTP services.\r\n- **Supported Methods**: Basic Authentication, API Key Authentication, and OAuth.\r\n- **Seamless Integration**: Easily enable authentication for gRPC unary and streaming handlers.\r\n- **Unified Auth Interface**: Leverages the existing authentication logic for consistency across protocols. Refer : \r\n\r\n### 🔹 Standard OTEL Tracing for gRPC\r\nEnabled standard OpenTelemetry tracing for gRPC services.\r\n- **Automatic Instrumentation**: Automatically captures spans for gRPC requests and responses.\r\n- **Better Observability**: Provides detailed insights into gRPC service performance and call chains.\r\n\r\n## 🛠️ Fixes\r\n\r\n### 🔹 EventHub Consumer Group Fix\r\n- Resolved an issue where consumer groups were not being correctly interpreted in the EventHub datasource, ensuring reliable message consumption.\r\n",
+    "date": "2026-01-27T05:43:56Z",
+    "tag": "v1.54.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.54.1"
+  },
+  {
+    "body": "# **v1.54.0**\r\n\r\n## :rocket: Features\r\n\r\n:small_blue_diamond: **Server-Side Rate Limiter Middleware**\r\n\r\nGoFr now includes a built-in **Rate Limiter Middleware** to protect your APIs from abuse and ensure fair resource distribution.\r\n- **Token Bucket Algorithm**: Implements smooth rate limiting with configurable burst capacity.\r\n- **Per-IP Rate Limiting**: Support for independent limits per client IP with trusted proxy support (`X-Forwarded-For`, `X-Real-IP`).\r\n- **Observability**: Automatically tracks rate limit violations with the `app_http_rate_limit_exceeded_total` metric.\r\n- **Exemptions**: Built-in health check endpoints (`/.well-known/alive`, `/.well-known/health`) are automatically exempt.\r\n\r\n**Usage Example**\r\n```go\r\n    app.UseMiddleware(middleware.RateLimiter(middleware.RateLimiterConfig{\r\n        RequestsPerSecond: 10,\r\n        Burst:             20,\r\n        PerIP:             true,\r\n    }, app.Metrics()))\r\n```\r\n\r\n## 🛠️ Fixes\r\n\r\n:small_blue_diamond: **Circuit Breaker & Health Check Refinement**\r\n\r\nImproved the reliability of the Circuit Breaker and Health Check mechanisms:\r\n- **Custom Health Endpoints**: Fixed an issue where custom health endpoints were not consistently used by the circuit breaker for recovery checks.\r\n",
+    "date": "2026-01-18T07:02:33Z",
+    "tag": "v1.54.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.54.0"
+  },
+  {
+    "body": "# **Release v1.53.0**\r\n\r\n## 🚀 Features\r\n\r\n🔹 **Amazon SQS PubSub Support**\r\n\r\nGoFr now supports **Amazon SQS** as a messaging backend, enabling seamless integration with AWS Simple Queue Service for building resilient, distributed microservices.\r\n\r\n- Supports both **Publishing** and **Subscribing** to SQS standard queues\r\n- **Configurable Behavior**:\r\n  - Support for custom message attributes\r\n  - Configurable visibility timeouts and wait times\r\n  - Support for standard queues\r\n\r\n#### **Usage Example**\r\n\r\nTo use Amazon SQS, import the driver and add it to your application:\r\n\r\n```go\r\nimport (\r\n    \"gofr.dev/pkg/gofr\"\r\n    \"gofr.dev/pkg/gofr/datasource/pubsub/sqs\"\r\n)\r\n\r\nfunc main() {\r\n    app := gofr.New()\r\n\r\n    app.AddPubSub(sqs.New(&sqs.Config{\r\n        Region:          \"us-east-1\",\r\n        AccessKeyID:     \"your-access-key-id\",     // optional if using IAM roles\r\n        SecretAccessKey: \"your-secret-access-key\", // optional if using IAM roles\r\n        // Endpoint:     \"http://localhost:4566\", // optional: for LocalStack\r\n    }))\r\n\r\n    app.Subscribe(\"my-queue\", func(ctx *gofr.Context) error {\r\n        // Process message\r\n        return nil\r\n    })\r\n\r\n    app.Run()\r\n}\r\n```\r\n\r\n## 🚀 Enhancements\r\n\r\n🔹 **Metrics for HTTP Service Resilience**\r\n\r\nEnhanced observability for inter-service communication by adding dedicated metrics for resilience patterns.\r\n- New metric `app_http_retry_count`: Tracks the total number of retries performed for each downstream service\r\n- New metric `app_http_circuit_breaker_state`: A gauge tracking the current state (0 for Closed, 1 for Open) of the circuit breaker\r\n- **Updated Grafana Dashboards**: Included new panels to visualize retry events and circuit breaker transitions, providing immediate insights into service stability and failure patterns. You can refer : https://github.com/gofr-dev/gofr/tree/main/examples/http-server/docker/provisioning/dashboards/gofr-dashboard\r\n\r\n🔹 **Configurable Metrics Server**\r\n\r\nAdded the ability to **disable the internal metrics server** by setting the `METRICS_PORT` environment variable to `0`. This provides greater flexibility for users who prefer to handle metrics collection through external agents or in environments where a separate metrics port is not required.\r\n\r\n## 🛠️ Fixes\r\n\r\n🔹 **Zip Slip Vulnerability Protection**\r\n\r\nImproved the security of the `file/zip` package by implementing protection against **Zip Slip** (path traversal) attacks.\r\n- Automatically validates file paths during extraction to ensure they remain within the target directory\r\n- Rejects zip entries containing absolute paths or parent directory traversal sequences (`..`)\r\n- Ensures safe handling of compressed files from untrusted sources\r\n",
+    "date": "2026-01-10T10:03:16Z",
+    "tag": "v1.53.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.53.0"
+  },
+  {
+    "body": "# **Release v1.52.0**\r\n\r\n## 🚀 Features\r\n\r\n🔹 **Redis PubSub Support**\r\n\r\nGoFr now supports **Redis PubSub** as a messaging backend, providing seamless integration with Redis for publish-subscribe patterns in microservices.\r\n\r\n- Supports both **Redis Channels** (traditional PubSub) and **Redis Streams** modes\r\n- Configurable via `REDIS_PUBSUB_MODE` environment variable (defaults to `streams`)\r\n- **Redis Streams** features:\r\n  - Consumer groups for load balancing and message distribution\r\n  - Automatic consumer group creation with `MKSTREAM` support\r\n  - Configurable PEL (Pending Entry List) ratio for balancing pending vs new messages (default: 0.7, i.e., 70% PEL, 30% new messages)\r\n  - Stream length management with `MaxLen` configuration\r\n  - Automatic message acknowledgment handling\r\n- **Redis Channels** features:\r\n  - Traditional PubSub channel support for simple messaging patterns\r\n  - Automatic channel creation on first publish/subscribe\r\n- Separate database support via `REDIS_PUBSUB_DB` to prevent keyspace collisions (defaults to database 15)\r\n- Configurable buffer size, query timeout, and query limits\r\n- Automatic connection monitoring and resubscription on reconnection\r\n- Full observability with metrics, logging, and distributed tracing\r\n- Graceful error handling with permanent failure detection\r\n\r\n---\r\n\r\n## 🚀 Enhancements\r\n\r\n🔹 **HTTP Router Path Normalization**\r\n\r\nRouter now **normalizes paths before routing** to handle edge cases with double slashes and malformed paths.\r\n\r\n- Automatically cleans and normalizes request paths using `path.Clean()`\r\n- Handles empty paths, double slashes, and trailing slashes consistently\r\n- Ensures proper routing behavior regardless of path formatting in requests\r\n- Improves compatibility with various HTTP clients and reverse proxies\r\n\r\n---\r\n\r\n## 🛠️ Fixes\r\n\r\n🔹 **JSON Encoding Error Handling for NaN Values**\r\n\r\nFixed a bug where `math.NaN()` values in responses caused incorrect error handling. The responder now properly handles JSON encoding failures by:\r\n\r\n- Detecting encoding errors before writing response headers\r\n- Returning appropriate `500 Internal Server Error` status code for encoding failures\r\n\r\n🔹 **Grafana Dashboard Configuration**\r\n\r\nFixed Grafana dashboard configuration to ensure proper metrics visualization and monitoring capabilities.",
+    "date": "2026-01-02T13:45:04Z",
+    "tag": "v1.52.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.52.0"
+  },
+  {
+    "body": "# Release v1.51.0\r\n\r\n## 🚀 Features\r\n\r\n### 🔐 Role-Based Access Control (RBAC)\r\n\r\nGoFr introduces a **config-driven RBAC middleware** for enforcing authorization across HTTP APIs without adding role or permission logic inside handlers.\r\n\r\n---\r\n\r\n### Key Highlights\r\n\r\n* Authorization defined entirely via **JSON/YAML configuration**\r\n* **Permission-based model**\r\n\r\n  * Roles define permissions\r\n  * Endpoints require permissions\r\n* **Header-based and JWT-based role extraction**\r\n\r\n  * JWT-based RBAC supported via GoFr OAuth\r\n  * JWT takes precedence when both are configured\r\n* **Role inheritance** support\r\n* **Exact permission matching** (no wildcards)\r\n* **Gorilla/mux-compatible route matching**\r\n\r\n  * Supports path variables and constraints\r\n* **Safe-by-default enforcement**\r\n\r\n  * Only routes defined in RBAC config are enforced\r\n\r\n---\r\n\r\n### Usage\r\n\r\nEnable RBAC using default config paths:\r\n\r\n```go\r\napp := gofr.New()\r\napp.EnableRBAC()\r\n```\r\n\r\nOr specify a custom RBAC config file:\r\n\r\n```go\r\napp.EnableRBAC(\"configs/rbac.json\")\r\n```\r\n\r\n---\r\n\r\n### JWT Integration\r\n\r\nRBAC integrates with GoFr OAuth for JWT-based authorization:\r\n\r\n```go\r\napp.EnableOAuth(\"https://auth.example.com/.well-known/jwks.json\", 10)\r\napp.EnableRBAC(\"configs/rbac.json\")\r\n```\r\n\r\nRoles are extracted from JWT claims using configurable claim paths.\r\n\r\n---\r\n\r\n### Observability\r\n\r\n* Debug logs include route matching and authorization decision details.\r\n* **Roles are excluded** from traces  to avoid PII leakage.\r\n\r\n\r\n📚 **Documentation**\r\nRefer to the RBAC documentation for configuration details and advanced usage.\r\n",
+    "date": "2025-12-27T10:02:47Z",
+    "tag": "v1.51.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.51.0"
+  },
+  {
+    "body": "# **Release v1.50.2**\r\n\r\n## 🚀 Enhancements\r\n\r\n🔹 **HTTP Connection Pool Configuration**\r\n\r\nGoFr now supports **configurable HTTP connection pool settings** to optimize performance for high-frequency HTTP requests in microservices.\r\n\r\nNew `ConnectionPoolConfig` option for `AddHTTPService()` method\r\n\r\nConfigurable settings:\r\n\r\n-  `MaxIdleConns`: Maximum idle connections across all hosts (default: 100)\r\n-  `MaxIdleConnsPerHost`: Maximum idle connections per host (default: 2, recommended: 10-20)\r\n-  `IdleConnTimeout`: Connection keep-alive duration (default: 90 seconds)\r\n- Addresses the limitation where Go's default `MaxIdleConnsPerHost: 2` is insufficient for microservices\r\n-  **Important**: `ConnectionPoolConfig` must be applied first when using multiple options  \r\n\r\n\r\n🔹 **OpenTSDB Metrics Support**\r\n\r\nAdded metrics instrumentation for OpenTSDB operations to provide better observability.\r\n\r\nNew metrics:\r\n-  `app_opentsdb_operation_duration`: Duration of OpenTSDB operations in milliseconds\r\n-  `app_opentsdb_operation_total`: Total OpenTSDB operations\r\n- Enables monitoring and alerting on OpenTSDB data operations\r\n\r\n---\r\n  \r\n\r\n## 🛠️ Fixes\r\n\r\n🔹 **Panic Recovery for OnStart Hooks**\r\nAdded panic recovery mechanism for `OnStart` hooks to prevent entire application crash. If a hook panics, the error is logged and the application continues with other hooks, improving application stability and resilience.\r\n\r\n🔹 **GCS Provider Name for Observability**\r\nAdded provider name \"GCS\" to Google Cloud Storage file store for improved logging and metrics identification. Previously it used common logging semantics \"COMMON\" shared across file storage providers leading to improper visibilty of the underlying file storage being used,\r\n\r\n🔹 **Zipkin Trace Exporter Error Handling**\r\nFixed error logging for successful trace exports (2xx status codes). Zipkin exporter now correctly ignores `201` status codes and other `2xx` responses, reducing noise in error logs for successful operations.",
+    "date": "2025-12-21T17:05:13Z",
+    "tag": "v1.50.2",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.50.2"
+  },
+  {
+    "body": "# **Release v1.50.1**\r\n\r\n## 🚀 Enhancements\r\n\r\n🔹  **TLS / SSL Support for Database Connections**\r\n\r\nGoFr now supports  **secure TLS/SSL connections**  for relational databases(MySQL / MariaDB/PostgreSQL), improving security and compliance for production deployments.\r\n\r\n-   New configuration  `DB_SSL_MODE`  with supported modes:\r\n    \r\n    -   `disable`,  `preferred`,  `require`,  `skip-verify`,  `verify-ca`,  `verify-full`\r\n        \r\n-   New environment variables for TLS configuration:\r\n    \r\n    -   `DB_TLS_CA_CERT`\r\n        \r\n    -   `DB_TLS_CLIENT_CERT`\r\n        \r\n    -   `DB_TLS_CLIENT_KEY`\r\n        \r\n-   `verify-ca`  and  `verify-full`  modes enforce  **CA certificate validation**\r\n    \r\n-   **Mutual TLS (mTLS)**  supported via client certificate & key\r\n- Refer [Documentation : Tracing In GoFr](https://gofr.dev/docs/quick-start/observability#tracing) for more info.\r\n----------\r\n\r\n🔹  **Custom Authentication Headers for Tracing Exporters**\r\n\r\nGoFr now allows configuring  **custom authentication headers**  for OpenTelemetry exporters, enabling better compatibility with hosted observability platforms.\r\n\r\nKey Highlights:\r\n\r\n-   New configuration:  `TRACER_HEADERS`\r\n    \r\n    -   Accepts  **comma-separated key=value pairs**\r\n        \r\n    -   Example:  `X-Api-Key=secret,Authorization=Bearer token`\r\n        \r\n-   `TRACER_HEADERS`  takes priority over the existing  `TRACER_AUTH_KEY`\r\n-  Refer [Documentation : Connecting MySQL](https://gofr.dev/docs/quick-start/connecting-mysql) for more info.\r\n\r\n## 🛠️ Fixes\r\n\r\n🔹  **Mock HTTP Services Deduplication in Tests**\r\n\r\nFixed an issue where registering multiple mock HTTP services could result in  **deduplication**, causing missing mocks and lost expectations during tests.\r\n\r\nFix Details:\r\n\r\n-   Each service registered via  `WithMockHTTPService(...)`  now receives a  **distinct mock instance**\r\n    \r\n-   Expectations must be set per service using: `mocks.HTTPServices[\"serviceName\"]`\r\n        \r\n- Refer [Documentation : Testing in GoFr](https://gofr.dev/docs/references/testing) for more info.",
+    "date": "2025-12-14T13:55:15Z",
+    "tag": "v1.50.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.50.1"
+  },
+  {
+    "body": "# **Release v1.50.0**\r\n\r\n## 🚀Features\r\n\r\n🔹  **Azure File Storage Support — New File-Store Provider**\r\n\r\nGoFr now introduces  **native Azure File Storage integration**  through a new provider at  \r\n`gofr.dev/pkg/gofr/datasource/file/azure`.\r\n\r\nKey Highlights:\r\n\r\n-   Supports configuration via  **AccountName**,  **AccountKey**, and  **ShareName**  (optional:  **Endpoint**)\r\n-   Automatic  **connection retry loop**  with connection-status logging\r\n-   **Native directory support**  —  `Chdir`,  `ReadDir`, and  `Stat`  behave like a real filesystem\r\n-   **Automatic parent-directory creation**  for nested file paths\r\n-   Built-in  **content-type detection**  based on extension (`json`,  `txt`,  `csv`,  `xml`,  `html`,  `pdf`, etc.)\r\n-   One file share  **per file-store instance**  (explicitly documented)\r\n-   Complete documentation & examples added under  [Official File Handling in GoFr Documentation](https://gofr.dev/docs/advanced-guide/handling-file/page.md)\r\n\r\n### **Example**\r\n\r\n```go\r\n// Create Azure File Storage filesystem\r\nfs, err := azure.New(&azure.Config{\r\n    AccountName: \"mystorageaccount\",\r\n    AccountKey:  \"myaccountkey\",\r\n    ShareName:   \"myshare\",\r\n    // Endpoint is optional, defaults to https://{AccountName}.file.core.windows.net\r\n    // Endpoint: \"https://custom-endpoint.file.core.windows.net\",\r\n})\r\n\r\nif err != nil {\r\n    app.Logger().Fatalf(\"Failed to initialize Azure File Storage: %v\", err)\r\n}\r\n\r\napp.AddFileStore(fs)\r\n\r\napp.Run()\r\n```\r\n\r\n🔹  **CLI Improvements**\r\n\r\n-   More helpful  `ErrCommandNotFound`  message showing the  **invalid command entered**\r\n-   Better help formatting with  **aligned command–description columns**\r\n-   Enhanced behavior for no-command scenarios: prints help + clearer messaging if added.\r\n    \r\n\r\n\r\n## Bug Fixes \r\n\r\n- **Basic Auth Header Normalization**\r\nAuthorization header now correctly uses  **\"Basic \"** instead of **\"basic \"** adhering to RFC standard for Basic Authorization Headers.",
+    "date": "2025-12-06T07:16:16Z",
+    "tag": "v1.50.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.50.0"
+  },
+  {
+    "body": "# **Release v1.49.0**\r\n\r\n## 🚀 New Features\r\n\r\n🔹 **DB Resolver for MySQL Read/Write Splitting**\r\n\r\nGoFr introduces a powerful, production-ready **DBResolver** module that enables automatic **read/write splitting** between a primary database and multiple replicas.\r\n\r\n**Key Highlights:**\r\n\r\n* Automatic routing based on **HTTP methods**:\r\n\r\n  * Writes (`POST`, `PUT`, `PATCH`, `DELETE`) → **Primary**\r\n  * Reads (`GET`, `HEAD`, `OPTIONS`) → **Replicas**\r\n* Route-based overrides using `PrimaryRoutes` for strongly consistent paths\r\n* Pluggable read-balancing strategies:\r\n\r\n  * **Round-robin**\r\n  * **Random**\r\n* Built-in **circuit breaker** for tracking replica failures & recovery\r\n* Full integration through `dbresolver.InitDBResolver()`\r\n* Unlocks **horizontal scaling** for read-heavy services\r\n* Significantly reduces read latency\r\n* Ensures high resilience with automatic failover to primary when replicas are down\r\n\r\n**Additional Details:**\r\n\r\n**Installation**\r\n\r\n```bash\r\ngo get gofr.dev/pkg/gofr/datasource/dbresolver@latest\r\n```\r\n\r\n**Initializing DBResolver**\r\n\r\n```go\r\nimport (\r\n    \"gofr.dev/pkg/gofr\"\r\n    \"gofr.dev/pkg/gofr/datasource/dbresolver\"\r\n)\r\n\r\nfunc main() {\r\n    a := gofr.New()\r\n\r\n    err := dbresolver.InitDBResolver(a, &dbresolver.Config{\r\n        Strategy:     dbresolver.StrategyRoundRobin,\r\n        ReadFallback: true,     // fallback to primary if all replicas fail\r\n        MaxFailures:  3,        // mark replica down after 3 failures\r\n        TimeoutSec:   30,       // cooldown before retrying\r\n        PrimaryRoutes: []string{\r\n            \"/admin\",\r\n            \"/api/payments/*\",\r\n        },\r\n        Replicas: []dbresolver.ReplicaCredential{\r\n            {Host: \"localhost:3307\", User: \"replica_user1\", Password: \"pass1\"},\r\n            {Host: \"replica2.example.com:3308\", User: \"replica_user2\", Password: \"pass2\"},\r\n            {Host: \"replica3.example.com:3309\", User: \"replica_user3\", Password: \"pass3\"},\r\n        },\r\n    })\r\n\r\n    if err != nil {\r\n        a.Logger().Errorf(\"failed to initialize db resolver: %v\", err)\r\n    }\r\n\r\n    a.Run()\r\n}\r\n```\r\n\r\n**Read Endpoint (Auto → Replica)**\r\n\r\n```go\r\na.GET(\"/customers\", func(c *gofr.Context) (any, error) {\r\n    var out []Customer\r\n    c.SQL.Select(c, &out, \"SELECT id, name FROM customers\")\r\n    return out, nil\r\n})\r\n```\r\n\r\n**Write Endpoint (Auto → Primary)**\r\n\r\n```go\r\na.POST(\"/customers\", func(c *gofr.Context) (any, error) {\r\n    var cust Customer\r\n    c.Bind(&cust)\r\n\r\n    _, err := c.SQL.Exec(\"INSERT INTO customers (name) VALUES (?)\", cust.Name)\r\n    return cust, err\r\n})\r\n```\r\n\r\n**Forced Primary Route**\r\n\r\n```go\r\na.GET(\"/admin/customers\", func(c *gofr.Context) (any, error) {\r\n    var out []Customer\r\n    c.SQL.Select(c, &out, \"SELECT id, name FROM customers\")\r\n    return out, nil\r\n})\r\n```\r\n\r\n\r\n🔹 **XML Responses (response.XML)**\r\n\r\nGoFr now supports **raw XML responses** without JSON encoding by using `response.XML`.\r\n\r\n**Key Highlights:**\r\n\r\n* Writes raw XML bytes directly to the client\r\n* Default `Content-Type = application/xml`\r\n* Perfect for legacy and enterprise XML-based systems\r\n\r\n**Example:**\r\n\r\n```go\r\napp.GET(\"/legacy/xml\", func(ctx *gofr.Context) (any, error) {\r\n    content := []byte(`<Response status=\"ok\"><Message>Hello</Message></Response>`)\r\n    return response.XML{Content: content}, nil\r\n})\r\n```\r\n\r\n**XML Output**\r\n\r\n```xml\r\n<Response status=\"ok\"><Message>Hello</Message></Response>\r\n```\r\n\r\n## 📦 Improvements\r\n\r\n🔹 **Responder Improvements**\r\n\r\n* Special response types (`Raw`, `File`, `Template`, `XML`, `Redirect`) now follow a unified handling flow\r\n* Avoids incorrect `206 Partial Content` responses\r\n* Ensures default JSON `Content-Type`\r\n\r\n🔹 **DBResolver Pooling Controls**\r\n\r\nReplica pools now scale relative to primary pools. Defaults:\r\n\r\n* Primary: `DB_MAX_IDLE_CONNECTION=2` → Replicas default to `8`\r\n* Primary: `DB_MAX_OPEN_CONNECTION=20` → Replicas default to `40`\r\n\r\nOptional overrides:\r\n\r\n```env\r\nDB_REPLICA_MAX_IDLE_CAP=100\r\nDB_REPLICA_MIN_IDLE=5\r\nDB_REPLICA_DEFAULT_IDLE=15\r\nDB_REPLICA_MAX_OPEN_CAP=500\r\nDB_REPLICA_MIN_OPEN=20\r\nDB_REPLICA_DEFAULT_OPEN=150\r\n```\r\n\r\n## 🐛 Bug Fixes & Small Changes\r\n\r\n🔹 **Authentication Timing Attack Protection**\r\n\r\n* API Key and Basic Auth now use consistent time comparisons\r\n\r\n\r\nRefer : **GoFr Official Documentation**\r\n[https://gofr.dev/docs](https://gofr.dev/docs)",
+    "date": "2025-11-28T16:14:37Z",
+    "tag": "v1.49.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.49.0"
+  },
+  {
+    "body": "# **Release v1.48.0**\r\n\r\n## 🚀 New Features\r\n\r\n🔹  **Unified Token-Bucket Rate Limiter for HTTP Clients**\r\n\r\nGoFr introduces a brand-new, pluggable  **rate limiter**  that works across all HTTP client calls.\r\n\r\nKey Highlights:\r\n-   Supports  **in-memory**  and  **Redis-backed**  stores\r\n-   Simple drop-in integration via  `RateLimiterConfig`  or  `AddOption`\r\n-   Integer-only token bucket with  **burst**  support\r\n-   Background cleanup for local buckets\r\n-   Customizable request grouping using  `KeyFunc`\r\n    \r\n\r\nWhy this matters:\r\n-   Ensures  **consistent throttling**  across all downstream HTTP services\r\n-   Distributed apps can now safely rate-limit using  **Redis**\r\n    \r\n\r\nAdditional Details :\r\n-   Default limit:  **60 req/min**, burst  **10**\r\n-   Returns  **RateLimitError (429)**  with  `RetryAfter`  for easy handling.\r\n    \r\n\r\n## 📦 Improvements\r\n\r\n🔹  **HTTP Client Enhancements with Rate Limiting**\r\n\r\n-   Rate limiter now acts as an  **HTTP wrapper**, intercepting all Get/Post/Put/Delete calls (including header variants)\r\n    \r\n-  Service key normalization improved via default keying (`scheme://host`)\r\n    \r\n-   Cleaner validation through  `RateLimiterConfig.Validate()`  with automatic sane defaults\r\n    \r\n\r\n🔹  **SQL Operation Normalization**\r\n\r\n-   SQL operation detection now always returns  **UPPERCASE**  keywords. Improves reliability for middleware and query inspection logic.\r\n    \r\n\r\n🔹  **OAuth Token URL Validation Cleanup**\r\n\r\n-   Switched to  **shared scheme constants**  (`http`  /  `https`). Reduces duplicated literals and improves code clarity\r\n\r\n\r\n## 🐛 Bug Fixes & Small Changes\r\n\r\n🔹  **Consistent SQL Operation Detection**\r\n\r\n-   `getOperationType()`  now normalizes to  **uppercase**, preventing case-sensitivity issues across modules\r\n    \r\n\r\n🔹  **Documentation Updates**\r\n\r\n-  **HTTP communication guide**  adds all details to add rate-limiter in your registered HTTP Services. Added examples for:\r\n    -   In-memory usage\r\n    -   Redis-backed multi-instance usage\r\n    -   Custom keying functions\r\n-  Added Documentation to setup gRPC Streaming Services/Clients using GoFr.\r\n\r\nRefer : [GoFr Official Documentation](https://gofr.dev/docs)",
+    "date": "2025-11-21T17:36:33Z",
+    "tag": "v1.48.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.48.0"
+  },
+  {
+    "body": "# **Release v1.47.1**\r\n\r\n## 📊 Enhancements\r\n\r\n🔹  **Unified Datasource Histogram Buckets**\r\n\r\nGoFr now uses a shared  `getDefaultDatasourceBuckets()`  across  **SQL**,  **Redis**, and other datasources.\r\nBenefits:\r\n\r\n-   Standardized buckets from  **0.05ms → 30s**  \r\n-   Consistent observability across datasources\r\n-   Improved monitoring fidelity in Prometheus/Grafana\r\n-   Easier cross-datasource latency comparison\r\n    \r\n\r\n🔹  **ArangoDB v2.1.6 Compatibility & API Upgrade**\r\n\r\nUpdated GoFr’s ArangoDB datasource to align with the latest  `github.com/arangodb/go-driver/v2 v2.1.6`  driver.  This upgrade ensures smooth integration with modern ArangoDB clusters and removes legacy API inconsistencies.\r\n\r\nKey Highlights:\r\n\r\n-   Migrated collection creation to **CreateCollectionV2**  /  **CreateCollectionWithOptionsV2**\r\n-   Ensures correct handling of  **edge**  and  **document**  collection types\r\n\r\n\r\n## 🛠️ Bug Fixes\r\n\r\n### **ArangoDB Database Creation – No More False Failures**\r\n\r\nPreviously, calling  `CreateDatabase()`  on an existing DB caused unnecessary user-visible errors.\r\nFix Summary:\r\n\r\n-   Added an existence check before creating databases\r\n-   Prevents duplicate-create errors\r\n-   Ensures smooth provisioning flows during app startup or migrations\r\n    \r\n###  **ArangoDB Collection Type Handling Corrected**\r\n\r\nEdge collections were previously misconfigured due to missing or incorrect Type assignment.\r\nFix Summary - \r\n-   Explicit  `Type`  handling added for  **edge vs document**  collections\r\n-   Ensures correct metadata and relationship behavior\r\n-   Updated tests to validate collection-type correctness",
+    "date": "2025-11-18T11:46:54Z",
+    "tag": "v1.47.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.47.1"
+  },
+  {
+    "body": "# Release v1.47.0\r\n\r\n## ✨ Features  \r\n\r\n#### 🔹 GCS File System Integration  \r\n\r\nIntroduced **Google Cloud Storage (GCS) File System** as a new implementation of the GoFr `FileSystem` interface.  This enables seamless integration with GCS while maintaining consistent behavior across existing backends like S3, FTP, and SFTP.\r\n\r\n**Supported Methods:**\r\n\r\n```go\r\ntype FileSystem interface {\r\n    Create(name string) (File, error)\r\n    Mkdir(name string, perm os.FileMode) error\r\n    MkdirAll(path string, perm os.FileMode) error\r\n    Open(name string) (File, error)\r\n    OpenFile(name string, flag int, perm os.FileMode) (File, error)\r\n    Remove(name string) error\r\n    RemoveAll(path string) error\r\n    Rename(oldname string, newname string) error\r\n    ReadDir(dir string) ([]FileInfo, error)\r\n    Stat(name string) (FileInfo, error)\r\n    ChDir(dirname string) error\r\n    Getwd() (string, error)\r\n}\r\n```\r\n-   Consistent and unified interface for GCS, S3, FTP, and SFTP file operations.\r\n-   Plug-and-play compatibility with GoFr’s file abstraction layer.\r\n-   Production-ready with proper error wrapping, retries, and structured logging.\r\n-   Simplifies backend switching without changing application logic.\r\n    \r\n\r\nFor detailed usage, visit 👉  [GoFr Docs — GCS File System](https://gofr.dev/docs/advanced-guide/handling-file)\r\n\r\n----------\r\n\r\n### 🛠️ Bug Fixes\r\n\r\n#### Remote Logger — Improper JSON Log Formatting\r\nPreviously, ANSI color codes and non-ASCII characters appeared in JSON logs, breaking downstream log parsers.\r\n\r\n**Example of affected log output:**\r\n\r\n```json\r\n{\"level\":\"DEBUG\",\"time\":\"2025-09-17T17:54:30.625115633Z\",\"message\":\"\\u001b[38;5;8m5460fd91feac021fd633b5989abdeb26 \\u001b[38;5;34m200   \\u001b[0m     5855\\u001b[38;5;8mµs\\u001b[0m GET https://myurl\",\"gofrVersion\":\"v1.45.0\"}\r\n\r\n```\r\n\r\n**Fix Summary:**\r\n\r\n-   Removed ANSI color codes and non-ASCII characters from JSON logs.\r\n-   Preserved terminal log colors for local debugging.\r\n-   Ensured all remote JSON logs are now ASCII-safe and parseable by log processors (ELK, Loki, Cloud Logging, etc.).\r\n    \r\n",
+    "date": "2025-11-07T16:56:09Z",
+    "tag": "v1.47.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.47.0"
+  },
+  {
+    "body": "# Release v1.46.3\r\n\r\n\r\n## Enhancements\r\n\r\n### **Custom Content-Type Support**: \r\nGoFr now allows respective custom content types in HTTP responses and only sets it as JSON when not explicitly present. This enhancement provides developers with greater flexibility in controlling response formats, enabling support for various content types like XML, plain text, or custom formats while maintaining JSON as the sensible default.\r\n\r\n## Fixes\r\n\r\n-   **Fixed Remote Log Level Fatal Exit Issue**: Resolved a critical bug where changing to fatal level at remote log level was causing the application to exit unexpectedly. This fix ensures that remote logging operations no longer trigger unintended application termination, improving stability and reliability in production environments.",
+    "date": "2025-10-17T14:17:15Z",
+    "tag": "v1.46.3",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.46.3"
+  },
+  {
+    "body": "## Release v1.46.2\r\n\r\n**GoFr core package now has 81% test coverage!**  🎉  \r\nThis milestone boosts stability, reliability, and makes contributions safer and easier.\r\n\r\n-  Faster CI and more maintainable code\r\n    \r\n-   🔜 Upcoming: CLI to make your life easier.\r\n    \r\n\r\n**GoFr — Opinionated, Performant, Observable**  https://gofr.dev\r\n\r\n \r\n",
+    "date": "2025-10-10T14:25:33Z",
+    "tag": "v1.46.2",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.46.2"
+  },
+  {
+    "body": "## Release v1.46.1\r\n\r\n\r\n### 🚀 Enhanced Telemetry Service\r\n\r\nWe’ve enhanced GoFr’s  **telemetry**  to provide better insights into framework usage and runtime behavior.  This improvement enables more accurate tracking of key runtime data to help us optimize performance and stability in future releases.\r\n\r\nTelemetry is  **enabled by default**  and can be disabled anytime by setting:\r\n\r\n```bash\r\nexport GOFR_TELEMETRY=false\r\n```\r\n \r\n",
+    "date": "2025-10-07T06:25:18Z",
+    "tag": "v1.46.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.46.1"
+  },
+  {
+    "body": "## Release v1.46.0\r\n\r\n### ✨ Features\r\n\r\n🔹  **OracleDB Migration Support**\r\n\r\n-   Added  **OracleDB migrations with transaction support**.\r\n-   Enables safe schema evolution with  **begin/commit/rollback**  semantics for Oracle-specific migrations.\r\n    \r\n\r\n###  🛠️ Bug Fixes\r\n\r\n- **Custom Metrics Naming with OpenTelemetry**\r\nPreviously, all custom metrics were forced to include a  `_total`  suffix, causing incorrect or duplicate metric names due to internal upgradation of OTEL Package. Now, Metrics can be defined without the mandatory suffix and behave as originally intended.\r\n    \r\n\r\n- **EventHub Subscription Fix**\r\nPreviously, EventHub subscribers were unable to consume events published in the system. Now, Subscribers can successfully receive and process published events.\r\n\r\n### ✨ Developer Experience\r\n\r\n- **Docker Setup for HTTP Server Example**\r\nImproved the  **Docker setup**  for the demo  `http-server`. You can now explore and run it easily at:  \r\n    👉  [`gofr/examples/http-server`](https://github.com/gofr-dev/gofr/tree/development/examples/http-server)\r\n \r\n",
+    "date": "2025-09-26T17:10:55Z",
+    "tag": "v1.46.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.46.0"
+  },
+  {
+    "body": "## Release v1.45.0\r\n\r\n### ✨ Features\r\n\r\n🔹  **DynamoDB Key-Value Store Support**\r\n\r\n-   Added full  **DynamoDB support**  as a GoFr KVStore implementation.   \r\n-   Features include: health checks, connection lifecycle management, JSON helper utilities, structured logging, OpenTelemetry tracing, and mock support for testing.\r\n    \r\n   - Import the gofr's external driver for DynamoDB:\r\n\t\t```shell=\r\n\t\tgo get gofr.dev/pkg/gofr/datasource/kv-store/dynamodb@latest\r\n\t\t```\r\n\t\t**How to use DynamoDB in GoFr**:\r\n\r\n\t\t```go\r\n\t\tdb := dynamodb.New(dynamodb.Configs{\r\n\t\t    Table:            \"gofr-kv-store\",\r\n\t\t    Region:           \"us-east-1\",\r\n\t\t    Endpoint:         \"http://localhost:8000\", // For local dev\r\n\t\t    PartitionKeyName: \"pk\",\r\n\t\t})\r\n\t\t```\r\n\r\n\t\tFor full documentation, checkout 👉  [gofr.dev/docs](https://gofr.dev/docs)",
+    "date": "2025-09-12T14:01:09Z",
+    "tag": "v1.45.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.45.0"
+  },
+  {
+    "body": "# Release v1.44.2\r\n\r\n## 🚀 Enhancements\r\n\r\n### 🔹 Go Version Update\r\n\r\n-   Upgraded  **Go to v1.25.0**  across all modules and workflows.\r\n    \r\n\r\n### 🔹 Remote Logger Optimization\r\n\r\n- Remote Logger produced excessive logs and wasn’t thread-safe. As an enhancement now all the successive remote logger calls will automatically shift to debug, reducing log noise.\r\n\r\n## 🛠️ Bug Fixes\r\n\r\n- ### Config Loading System\r\n\r\nPreviously, File-based configs overwrote system environment variables. Now, System env vars always take precedence, with refactored loading logic and better error handling.\r\n    \r\n\r\n- ### WebSocket Implementation\r\nPreviously, context retrieval was unreliable, methods weren’t fully thread-safe, and errors like  _broken pipe_  caused crashes. This has been fixed. Websocket has context-based connection handling, thread-safe methods (Read/Write/Deadline), improved error handling, concurrency-safe tests, and cleaner startup/shutdown.\r\n",
+    "date": "2025-09-08T14:14:25Z",
+    "tag": "v1.44.2",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.44.2"
+  },
+  {
+    "body": "# Release v1.441.\r\n\r\n## 🚀 Enhancement\r\n\r\n### 🔹 Client Cancellation Handling \r\n\r\n-   GoFr now returns  **HTTP 499 “Client Closed Request”**  when a request is canceled (`context.Canceled`) and logs it at  **ERROR**  level.\r\n\r\n\r\n## 🛠️ Fixes\r\n\r\n- ### Request Timeout Handling \r\n\r\n    Previously, `500` status codes were received for context errors. GoFr now correctly returns  **HTTP 504 “Gateway Timeout”**  when a request exceeds its deadline (`context.DeadlineExceeded`) and logs it at  **ERROR**  level.\r\n\r\n\r\n    \r\n",
+    "date": "2025-09-01T11:00:58Z",
+    "tag": "v1.44.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.44.1"
+  },
+  {
+    "body": "# v1.44.0\r\n\r\n## 🚀 Features\r\n\r\n### 🔹 Correlation ID Access in GoFr Context\r\n\r\nGoFr now allows users to easily  **access the correlation ID**  via  `gofr.Context`.\r\n\r\n-   Retrieve correlation ID anywhere in your application using:\r\n    \r\n    ```go\r\n    ctx.GetCorrelationID()\r\n    ```\r\n----------\r\n\r\n### 🔹 Couchbase Support\r\n\r\nGoFr now supports injecting  **Couchbase**  as a datasource.  Any driver implementing the following interface can be added via  `app.AddCouchbase()`  and accessed across the application using  `gofr.Context`.\r\n\r\n#### 🧩 Supported Couchbase Interface:\r\n\r\n```go\r\ntype Couchbase interface {\r\n    Get(ctx context.Context, key string, result any) error\r\n    Insert(ctx context.Context, key string, document, result any) error\r\n    Upsert(ctx context.Context, key string, document any, result any) error\r\n    Remove(ctx context.Context, key string) error\r\n    Query(ctx context.Context, statement string, params map[string]any, result any) error\r\n    AnalyticsQuery(ctx context.Context, statement string, params map[string]any, result any) error\r\n}\r\n\r\n```\r\n\r\n#### ✅ Example Usage:\r\n\r\n```go\r\na := gofr.New()\r\n\r\na.AddCouchbase(couchbase.New(&couchbase.Config{\r\n    Host:     \"localhost\",\r\n    User:     \"Administrator\",\r\n    Password: \"password\",\r\n    Bucket:   \"test-bucket\",\r\n}))\r\n\r\n```\r\n\r\n📚  **Documentation**:  [Couchbase Setup Guide](https://gofr.dev/docs)\r\n\r\n----------\r\n\r\n### 🔹 OracleDB Support\r\n\r\nGoFr now supports injecting  **OracleDB**  as a relational datasource via a clean and extensible interface.  \r\n\r\n#### 🧩 Supported Oracle Interface:\r\n\r\n```go\r\ntype Oracle interface {\r\n    Exec(ctx context.Context, query string, args ...any) error\r\n    Select(ctx context.Context, dest any, query string, args ...any) error\r\n}\r\n```\r\n\r\nThis approach makes it easy to inject any compatible Oracle driver while maintaining flexibility to use multiple databases within your GoFr application.\r\n    \r\n\r\n#### ✅ Example – Add OracleDB in GoFr\r\n\r\n```go\r\napp.AddOracle(oracle.New(oracle.Config{\r\n    Host:     \"localhost\",\r\n    Port:     1521,\r\n    Username: \"system\",\r\n    Password: \"YourPasswordHere\",\r\n    Service:  \"FREEPDB1\",\r\n}))\r\n```\r\n\r\n📚  **Documentation & Setup Guide**:  [Oracle](https://gofr.dev/docs)\r\n\r\n----------\r\n\r\n## 🛠️ Fixes\r\n\r\n-   Removed the  **unnecessary SQL initialization**  when no  `DB_*`  environment variables are defined. Prevents failure logs:  `connection to failed: host name is empty`\r\n- Fixed issue where metrics showed  **infinite DB calls**  for every query.",
+    "date": "2025-08-21T12:40:56Z",
+    "tag": "v1.44.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.44.0"
+  },
+  {
+    "body": "## v1.43.0\r\n\r\n### 🚀 Features\r\n\r\n1.  **Startup Hooks Support (`OnStart`)**\r\n   \r\nGoFr now allows registering  **synchronous startup jobs**  using the  `OnStart`  method.\r\n\r\nThis enables actions like:\r\n\r\n-   Warming up Redis or in-memory caches\r\n    \r\n-   Seeding databases\r\n    \r\n-   Validating configuration before traffic is served\r\n    \r\nThe method receives a fully initialized  `*gofr.Context`  with access to SQL, Redis, and Logger instances. If any hook fails, the app will  **gracefully shut down**  with clear logs.\r\n\r\n🛠️  **Example usage:**\r\n\r\n```go\r\na.OnStart(func(ctx *gofr.Context) error {\r\n    return ctx.Redis.Set(ctx, \"key\", \"value\", 0).Err()\r\n})\r\n```\r\n\r\nThis ensures critical setup steps are completed  **before your app starts accepting traffic**.\r\n\r\n\r\n### 🛠️ Fixes\r\n\r\n1.  **PubSub Migrator Chain Fix**\r\n    \r\nPreviously incorrect migration state visibility was seen when PubSub was connected. This has been resolved. Now it retrieves correct version from PubSub and continues chain to next migrator. Handles query failures without skipping downstream migrators\r\n    \r\n",
+    "date": "2025-08-05T16:05:43Z",
+    "tag": "v1.43.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.43.0"
+  },
+  {
+    "body": "# v1.42.5 \r\n\r\n## 🚀 Enhancements\r\n\r\n### 🔹 ScyllaDB Migrator Support\r\n\r\nGoFr now includes native support for **ScyllaDB** migrations.\r\n\r\n#### 🧩 Supported Migration Interface:\r\n```go\r\ntype ScyllaDB interface {\r\n    Query(dest any, stmt string, values ...any) error\r\n    QueryWithCtx(ctx context.Context, dest any, stmt string, values ...any) error\r\n\r\n    Exec(stmt string, values ...any) error\r\n    ExecWithCtx(ctx context.Context, stmt string, values ...any) error\r\n\r\n    ExecCAS(dest any, stmt string, values ...any) (bool, error)\r\n\r\n    NewBatch(name string, batchType int) error\r\n    NewBatchWithCtx(ctx context.Context, name string, batchType int) error\r\n\r\n    BatchQuery(name, stmt string, values ...any) error\r\n    BatchQueryWithCtx(ctx context.Context, name, stmt string, values ...any) error\r\n\r\n    ExecuteBatchWithCtx(ctx context.Context, name string) error\r\n}\r\n```\r\n\r\n\r\n### 🔹 OpenTSDB Migrator Support\r\n\r\nSupport for  **OpenTSDB**  migration operations, enable you to pre-seed metrics and manage annotations.\r\n\r\n#### ✅ Key Features:\r\n-   Versioned JSON-based migration files\r\n    \r\n-   Integrated directly into GoFr's migration interface\r\n    \r\n\r\n#### 🧩 Supported Migration Interface:\r\n\r\n```go\r\ntype OpenTSDB interface {\r\n    // PutDataPoints can be used for seeding initial metrics during migration\r\n    PutDataPoints(ctx context.Context, data any, queryParam string, res any) error\r\n\r\n    // PostAnnotation creates or updates an annotation in OpenTSDB using the 'POST /api/annotation' endpoint.\r\n    PostAnnotation(ctx context.Context, annotation any, res any) error\r\n\r\n    // PutAnnotation creates or replaces an annotation in OpenTSDB using the 'PUT /api/annotation' endpoint.\r\n    PutAnnotation(ctx context.Context, annotation any, res any) error\r\n\r\n    // DeleteAnnotation removes an annotation from OpenTSDB using the 'DELETE /api/annotation' endpoint.\r\n    DeleteAnnotation(ctx context.Context, annotation any, res any) error\r\n}\r\n```\r\n\r\n----------\r\n\r\n📚  **Documentation**  \r\nSee  [gofr.dev/migrations](https://gofr.dev/migrations)  for full examples, best practices, and schema layouts for ScyllaDB and OpenTSDB migrations.\r\n",
+    "date": "2025-08-01T11:01:15Z",
+    "tag": "v1.42.5",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.42.5"
+  },
+  {
+    "body": "## **v1.42.4**\r\n\r\n### **🛠️ Improvements**\r\n\r\n1. **Elasticsearch Migrator for Versioned Changes**\r\n\r\n   GoFr now includes a dedicated **Elasticsearch migrator** under `pkg/migration` for managing version-controlled changes like index creation, mapping updates, and analyzer definitions.\r\n   **Key Features:**\r\n\r\n   * Seamless integration with GoFr’s internal **migrator interface**.\r\n   * Uses Elasticsearch’s **REST API** for all operations.\r\n   * Maintains migration state for reliable deployments.\r\n\r\n   Refer to [gofr.dev/migrations](https://gofr.dev/docs/advanced-guide/handling-data-migrations) for more details and examples.\r\n\r\n### **🐞 Bug Fixes**\r\n\r\n1. **Fixed Panic in Context Logging in GoFr CMD Apps**\r\n\r\n   A bug that caused a panic when using `ctx.Warnf` instead of `ctx.Logger.Warnf` has been fixed.\r\n\r\n   **Behavior Before:**\r\n   \r\n   Calling `ctx.Warnf` in GoFr CMD Apps resulted in:\r\n\r\n   ```\r\n   panic: runtime error: invalid memory address or nil pointer dereference\r\n   ```\r\n\r\n   **Now:**\r\n   \r\n   `ctx.Warnf` functions correctly and logs without causing runtime crashes.",
+    "date": "2025-07-25T14:19:51Z",
+    "tag": "v1.42.4",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.42.4"
+  },
+  {
+    "body": "# v1.42.3 \r\n\r\n----------------------\r\n\r\n## 🛡️ Security Fix\r\n- Resolved weak RSA key generation in `mock_oauth_server.go`.\r\n- Previously, a 1024-bit RSA key was being generated in the mock OAuth server (rsa.GenerateKey).\r\n- Increased the key size to 2048 bits, aligning with modern cryptographic standards and addressing [CodeQL alert #73](https://github.com/gofr-dev/gofr/security/code-scanning/73).\r\n\r\n",
+    "date": "2025-07-09T07:29:40Z",
+    "tag": "v1.42.3",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.42.3"
+  },
+  {
+    "body": "## v1.42.2\r\n\r\n### 🛠️ Improvements\r\n\r\n#### 1.  **Versioned Migrations Support Extended to NATS and EventHub**\r\n\r\nFollowing up on versioned migration support for Kafka, MQTT, and Google PubSub in the previous release, GoFr now officially adds:\r\n\r\n- **NATS**\r\n- **Azure EventHub**\r\n\r\nBoth now support  **versioned migrations**, allowing event streaming systems to be schema-evolvable and compatible with data migration needs.\r\n\r\n#### 2.  **Cleaner AuthConfig APIs for External Services**\r\n\r\nYou can now configure external services like  `catfact.ninja`  using streamlined constructors:\r\n\r\n**Old Way:**\r\n\r\n```go\r\napp.AddHTTPService(\"cat-facts\", \"https://catfact.ninja\",\r\n    &service.APIKeyConfig{APIKey: \"some-random-key\"},\r\n    &service.BasicAuthConfig{UserName: \"gofr\", Password: \"gofr\"})\r\n``` \r\n\r\n**New Way:**\r\n\r\n```go\r\napp.AddHTTPService(\"cat-facts\", \"https://catfact.ninja\",\r\n    service.NewAPIKeyConfig(\"some-random-key\"),\r\n    service.NewBasicAuthConfig(\"username\", \"password\"),\r\n    )\r\n``` \r\n\r\n `NewBasicAuthConfig(username, password)`:\r\n\r\n-   Trims values   \r\n-   Validates presence of both fields  \r\n-   Ensures  **password is base64 encoded**, preventing unsafe plaintext usage \r\n-   Returns  **clear errors**  for invalid formats\r\n    \r\n\r\n `NewAPIKeyConfig(apiKey)`:\r\n\r\n-   Simplified usage  \r\n-   Validated internally\r\n-   Adds cleaner abstraction with automatic header injection\r\n    \r\n",
+    "date": "2025-07-04T13:59:35Z",
+    "tag": "v1.42.2",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.42.2"
+  },
+  {
+    "body": "# v1.42.1\r\n\r\n## 🛠️ Improvements\r\n\r\n### 1. **`NewOAuthConfig()` for Safer OAuth Setup**\r\n\r\nGoFr now includes a dedicated constructor to validate OAuth configurations for interservice HTTP calls, ensuring secure and consistent authentication setup. Refer to the [official documentation](https://gofr.dev/docs/advanced-guide/http-authentication#adding-o-auth-authentication-to-http-services) to know more :\r\n\r\n```go\r\nNewOAuthConfig(\r\n\tclientID,  // string: OAuth2 client ID (required)\r\n\tsecret,    // string: OAuth2 client secret (required)\r\n\ttokenURL,  // string: Token exchange endpoint (required & validated)\r\n\tscopes,    // []string: Optional OAuth2 scopes\r\n\tparams,    // url.Values: Optional additional endpoint parameters\r\n\tauthStyle, // oauth2.AuthStyle: Credential passing style (header/body/auto)\r\n)\r\n```\r\n\r\n#### 🔍 Why this matters:\r\n\r\n* Prevents common misconfigurations like missing `tokenURL`, which previously caused vague errors such as:\r\n\r\n  ```\r\n  Post \"\": unsupported protocol scheme \"\"\r\n  ```\r\n* Performs validation on required fields and returns clear error messages.\r\n* Encourages safe and standardized OAuth client setup.\r\n\r\n#### ✅ Example Usage:\r\n\r\n```go\r\nconfig, err := NewOAuthConfig(\r\n\t\"my-client-id\",                       // clientID\r\n\t\"my-client-secret\",                   // secret\r\n\t\"https://provider.com/oauth/token\",  // tokenURL\r\n\t[]string{\"read\", \"write\"},           // scopes\r\n\tnil,                                  // params\r\n\toauth2.AuthStyleAutoDetect,          // authStyle\r\n)\r\n\r\nif err != nil {\r\n\tlog.Fatal(err)\r\n}\r\n```\r\n\r\nRefer to the [official documentation](https://gofr.dev/docs/advanced-guide/http-authentication#adding-o-auth-authentication-to-http-services) to know more.\r\n\r\n\r\n\r\n### 2. **Configurable `AuthStyle` in OAuth**\r\n\r\nThe `AuthStyle` field in OAuth2 configuration is now configurable by the user.\r\n\r\n#### 🔧 Behavior:\r\n\r\n* Previously hardcoded to `oauth2.AuthStyleInHeader`\r\n* Now allows values such as:\r\n\r\n  * `oauth2.AuthStyleAutoDetect` (default)\r\n  * `oauth2.AuthStyleInHeader`\r\n  * `oauth2.AuthStyleInParams`\r\n\r\nThis makes GoFr's OAuth integration more flexible and compatible with diverse OAuth providers.\r\n\r\n---\r\n\r\n### 3. **Versioned Migrations in Kafka, MQTT, and Google PubSub**\r\n\r\nGoFr now supports **versioned migrations** for the following data sources:\r\n\r\n* ✅ **Kafka**\r\n* ✅ **MQTT**\r\n* ✅ **Google PubSub**\r\n\r\n#### 🧩 Additional Config (MQTT only):\r\n\r\nTo support retained message fetching for versioned migrations in MQTT, enable:\r\n\r\n```\r\nMQTT_RETRIEVE_RETAINED=true\r\n```\r\nBy default, this is set to `false` to maintain backward compatibility. When set to true, this actually retains the latest message for each topics in the connected MQTT host, hence aiding in versioned migrations.\r\n\r\n\r\n",
+    "date": "2025-06-27T12:42:48Z",
+    "tag": "v1.42.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.42.1"
+  },
+  {
+    "body": "# v1.42.0\r\n\r\n## 🚀 Features\r\n\r\n### 1.  **CockroachDB Support**\r\n\r\nGoFr now supports  **CockroachDB**, a distributed cloud-native SQL database.\r\nDevelopers can now configure GoFr services to connect to CockroachDB using simple environment variables.\r\n\r\n#### 🔧 Configuration:\r\n```\r\nDB_DIALECT=cockroachdb\r\nDB_HOST=localhost\r\nDB_PORT=26257\r\nDB_USER=root\r\nDB_PASSWORD=your-password\r\nDB_NAME=defaultdb\r\nDB_SSL_MODE=require\r\n``` \r\nFor more details, refer to the  [SQL usage guide](/advanced-guide/dealing-with-sql/).\r\n\r\n## 🛠️ Improvements\r\n\r\n### 1.  **gRPC Reflection Toggle via Config**\r\n\r\nGoFr now supports enabling/disabling  **gRPC server reflection**  using a simple config flag:\r\n```\r\nGRPC_ENABLE_REFLECTION=true\r\n``` \r\n\r\n#### 🔍 When to enable:\r\n\r\n-   **Development & Debugging**: Use with tools like grpcurl, Postman, or Evans.\r\n    \r\n-   **Internal Networks**: Safe in private, trusted environments.\r\n    \r\n-   **CI/CD Pipelines**: Ideal for service discovery in automated setups.\r\n    \r\n\r\nThis allows dynamic inspection of gRPC services while maintaining control over exposure.\r\n\r\n\r\n## 🛠️ Fixes\r\n\r\n### 1.  **Supabase Healthcheck Issue Resolved**\r\n\r\nResolved an issue where Supabase-backed services were not responding properly to health checks due to incorrect handling of internal pings.\r\n\r\n\r\n### 2.  **Fixed Data Race in Metrics Gauges**\r\n\r\nAddressed a  **concurrency bug** where the internal  `float64Gauge`  map was accessed without synchronization. Proper locking is now in place around map access to avoid data races during concurrent  `SetGauge`  and metric reads.\r\n\r\n### 3.  **App Name & Version Initialization Bug**\r\n\r\nFixed a configuration issue where  `AppName`  and  `AppVersion`  were incorrectly defaulting to  `gofr-app`  and  `dev`, even when explicitly provided by the user. These values now correctly reflect user-specified configuration during startup.\r\n",
+    "date": "2025-06-20T04:50:59Z",
+    "tag": "v1.42.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.42.0"
+  },
+  {
+    "body": "# v1.41.0\r\n\r\n## 🔧 Improvements\r\n\r\n\r\n### 1.  **New HTTP Error Type:  `ErrorRecordNotFound`**\r\n\r\nA new standardized error type  `http.ErrorRecordNotFound`  has been introduced to gracefully handle scenarios where  **no records are found**  in the database.\r\n\r\n####  Example:\r\n\r\n```go\r\nreturn  nil, http.ErrorRecordNotFound{\r\n    Message: \"User not found with the given ID\",\r\n}\r\n```\r\n\r\nThis improves semantic clarity and enables better client-side handling for empty-query results.\r\n\r\n### 2.  **Improved Cron Job Observability**\r\n\r\nAll  **cron jobs**  in GoFr now come with  **built-in logger and tracing support**.\r\n\r\n-   Logs from scheduled tasks are now clearly visible.\r\n    \r\n-   Each recurring job run is automatically  **tagged with a unique trace ID**, making it easier to trace, debug, and monitor scheduled executions across your system.\r\n    \r\n\r\nThis ensures better observability for background tasks without requiring additional instrumentation.\r\n\r\n## 🐛 Fixes\r\n\r\n### 1.  **Supabase Connection Issue Resolved**\r\n\r\nPreviously,  **Supabase connections were not initializing correctly**  in GoFr due to a missing dialect registration. Supabase-backed services will now  **connect without issues**—no manual fixes required.\r\n",
+    "date": "2025-06-12T18:05:20Z",
+    "tag": "v1.41.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.41.0"
+  },
+  {
+    "body": "# v1.40.1\r\n\r\n\r\n## 🔧 Dependency Updates\r\n\r\nUpgraded all externalized datasource dependencies to their latest stable versions for improved performance, security, and compatibility across supported services.\r\n",
+    "date": "2025-06-06T06:26:14Z",
+    "tag": "v1.40.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.40.1"
+  },
+  {
+    "body": "\r\n# v1.40.0\r\n\r\n## 🚀 Features\r\n\r\n### **Support for Supabase Database**\r\n\r\nUsers can now connect their GoFr services to a  **Supabase**  database using environment variables. This feature supports both  **direct**  and  **pooled**  connections, enabling secure and scalable Postgres usage via Supabase.\r\n\r\n#### 🔧 Environment Variable Setup:\r\n```bash\r\nDB_DIALECT=supabase\r\nDB_HOST=db.[PROJECT_REF].supabase.co  # Optional, derived from PROJECT_REF\r\nDB_USER=postgres                      # Or database user name\r\nDB_PASSWORD=password\r\nDB_NAME=postgres                      # Or your database name\r\nDB_PORT=5432                          # Optional, defaults based on connection type\r\nDB_SSL_MODE=require                   # Optional, forced to \"require\" for Supabase\r\n\r\n# Supabase-specific configs\r\nSUPABASE_PROJECT_REF=your_project_ref\r\nSUPABASE_CONNECTION_TYPE=direct       # Options: direct, session, transaction\r\nSUPABASE_REGION=us-east-1             # Required for pooled connections\r\n\r\n# Alternatively, can provide full connection string\r\nDATABASE_URL=postgresql://postgres:password@db.your_project_ref.supabase.co:5432/postgres\r\n``` \r\n\r\n----\r\n\r\n### **Inter-Service WebSocket Communication**\r\n\r\nGoFr now supports  **Inter-Service WebSocket Communication**, enabling services to exchange real-time messages over WebSocket connections. Ideal for microservices needing live updates or event-driven communication.\r\n\r\n#### 🔑  Key Methods:\r\n\r\n-   `AddWSService`: Register a persistent WebSocket connection to another service with optional auto-reconnect.\r\n    \r\n-   `WriteMessageToService`: Send messages to any registered service.\r\n    \r\n\r\n#### ✅ Example Usage:\r\n\r\n```go\r\nfunc main(){\r\n\r\n\tapp := gofr.New()\r\n\r\n\terr := app.AddWSService(\"notification-service\", \"ws://notifications.example.com/ws\", nil, true, 5*time.Second) \r\n\tif err != nil {\r\n\t    app.Logger.Errorf(\"Failed to add WebSocket service: %v\", err) \r\n\t    return \r\n\t}\r\n\r\n\tapp.POST(\"/send-notification\", func(ctx *gofr.Context) (any, error) {\r\n\t    message := map[string]string{ \r\n\t\t    \"title\": \"New Message\", \r\n\t\t    \"content\": \t\"You have a new notification!\",\r\n\t    }\r\n\r\n\t    err := ctx.WriteMessageToService(\"notification-service\", message)\r\n\t    if err != nil { \r\n\t\t    return  nil, err\r\n\t    } \r\n\t    \r\n\t\treturn  \"Notification sent successfully!\", nil \r\n\t\t})\r\n\r\n\tapp.Run()\r\n}\r\n``` \r\n\r\nThis enables resilient, real-time service communication with minimal configuration.\r\n\r\n\r\n## 🔧 Improvements\r\n\r\n### 1.  **New HTTP Error Type:  `ServiceUnavailable`**\r\n\r\nA new standardized error type  `ErrorServiceUnavailable`  has been introduced for representing service unavailability due to dependency issues like database failures or third-party service outages.\r\n\r\n#### ⚙️ Use Case Example:\r\n\r\n```go\r\nerr := http.ErrorServiceUnavailable{\r\n    Dependency: \"PostgreSQL\",\r\n    ErrorMessage: \"Connection timeout\",\r\n}\r\n``` \r\nThis improvement enhances observability and clarity when dealing with critical external failures.\r\n",
+    "date": "2025-05-23T12:07:26Z",
+    "tag": "v1.40.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.40.0"
+  },
+  {
+    "body": "# v1.39.1\r\n\r\n## 🛠 Improvements\r\n\r\n1. **Disable Logs for Health & Alive Probes**\r\n\r\n\tLogging for health check routes (`/.well-known/health` and `/.well-known/alive`) can now be disabled to reduce log clutter in environments with frequent probe calls (e.g., Kubernetes).\r\n\r\n\tSet the following environment variable:\r\n\r\n\t```bash\r\n\tLOG_DISABLE_PROBES=true\r\n\t```\r\n\r\n2. **TraceID Now Included in Context-Based Logging**\r\n\r\n\tLogs emitted using `ctx.Logger()` now automatically include the request `traceID`. This enhances traceability across services and allows easier debugging in distributed systems.\r\n\r\n\tExample log before:\r\n\r\n\t```json\r\n\t{\"message\": \"User created\", \"level\": \"INFO\"}\r\n\t```\r\n\r\n\tAfter:\r\n\r\n\t```json\r\n\t{\"message\": \"User created\", \"trace_id\": \"3ac9f5e7c12e...\", \"level\": \"INFO\"}\r\n\t```\r\n\r\n\tNo additional configuration needed—this is now built-in.\r\n\r\n3. **Enhanced ArangoDB Query Options Support**\r\n\r\n\tYou can now pass advanced query and subquery options when executing AQL queries via GoFr’s ArangoDB client.\r\n\r\n\t```go\r\n\toptions := map[string]any{\r\n\t    \"count\":     true,\r\n\t    \"batchSize\": 100,\r\n\t    \"options\": map[string]any{\r\n\t        \"fullCount\": true,\r\n\t        \"profile\":   2,\r\n\t    },\r\n\t}\r\n\t```\r\n\r\n\tSupported keys include (but are not limited to):\r\n\r\n\t- **QueryOptions:**\r\n\r\n\t\t* `count`, `batchSize`, `ttl`, `cache`, `memoryLimit`\r\n\r\n\t- **QuerySubOptions (under `options` key):**\r\n\r\n\t\t* `fullCount`, `allowRetry`, `stream`, `optimizer`, `profile`, `maxRuntime`, `skipInaccessibleCollections`, and more\r\n\r\n\t**Example usage:**\r\n\r\n\t```go\r\n\terr := ctx.ArangoDB.Query(ctx, \"myDatabase\", query, bindVars, &results, options)\r\n\t```\r\n\r\n\tThis update gives you full control over AQL query execution for performance tuning, streaming, profiling, and more. \r\n",
+    "date": "2025-05-15T12:56:14Z",
+    "tag": "v1.39.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.39.1"
+  },
+  {
+    "body": "# v1.39.0\r\n\r\n## 🚀 Features\r\n\r\n### gRPC Streaming Support  \r\nGoFr now supports all gRPC streaming types, unlocking full duplex communication capabilities:\r\n- **Server-side streaming**  \r\n- **Client-side streaming**  c\r\n- **Bidirectional streaming**  \r\nAuto-generated handlers for streaming methods with built-in metrics and tracing support for all streaming calls\r\n\r\n> **Note:** Requires `gofr-cli v0.7.0` or higher.  \r\n> Refer to the [examples](https://github.com/gofr-dev/gofr/tree/main/examples/grpc-streaming) to explore usage patterns.\r\n\r\n\r\n\r\n### Redirect Support in HTTP Handlers  \r\nHandlers can now trigger client redirects by returning a `response.Redirect` object:\r\n\r\n```go\r\nimport (\r\n    \"gofr.dev/pkg/gofr\"\r\n    \"gofr.dev/pkg/gofr/http/response\"\r\n)\r\n\r\nfunc main() {\r\n    app := gofr.New()\r\n\r\n    app.GET(\"/old-page\", func(ctx *gofr.Context) (any, error) {\r\n        return response.Redirect{URL: \"https://example.com/new-page\"}, nil\r\n    })\r\n\r\n    app.Run()\r\n}\r\n```\r\nUse this for SEO-friendly permanent or temporary redirects from legacy URLs.\r\n\r\n##  🛠 Improvements\r\n\r\n### 1. TLS Support for Redis\r\n\r\nRedis connections in GoFr can now be secured using TLS. This enhancement enables secure communication in production and enterprise deployments. Configuration is done via environment variables:\r\n\r\n| Environment Variable     | Description                                                     |\r\n| ------------------------ | --------------------------------------------------------------- |\r\n| `REDIS_TLS_ENABLED`      | Set to `\"true\"` to enable TLS support                           |\r\n| `REDIS_TLS_CA_CERT_PATH` | File path to the CA certificate to verify Redis server identity |\r\n| `REDIS_TLS_CERT_PATH`    | File path to the client certificate (for mTLS connections)      |\r\n| `REDIS_TLS_KEY_PATH`     | File path to the client private key (for mTLS connections)      |\r\n\r\n\r\n\r\n\r\n",
+    "date": "2025-05-08T16:19:25Z",
+    "tag": "v1.39.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.39.0"
+  },
+  {
+    "body": "# **Release - v1.38.0**\r\n\r\n## 🚀  **Features**\r\n\r\n### **Elasticsearch Integration Support**\r\n\r\n-   GoFr now supports  **Elasticsearch**  as a pluggable data source with a standard interface for document indexing, searching, and cluster management.\r\n    \r\n-   Developers can inject any compatible Elasticsearch client that implements the following interface:\r\n    \r\n    ```go\r\n    type Elasticsearch interface {\r\n        Connect()\r\n        CreateIndex(ctx context.Context, index string, settings map[string]any) error \r\n        DeleteIndex(ctx context.Context, index string) error \r\n        IndexDocument(ctx context.Context, index, id string, document any) error \r\n        GetDocument(ctx context.Context, index, id string) (map[string]any, error)\r\n        UpdateDocument(ctx context.Context, index, id string, update map[string]any) error \r\n        DeleteDocument(ctx context.Context, index, id string) error \r\n        Search(ctx context.Context, indices []string, query map[string]any) (map[string]any, error)\r\n        Bulk(ctx context.Context, operations []map[string]any) (map[string]any, error)\r\n        HealthChecker\r\n    }\r\n    ``` \r\n    \r\n-   Official GoFr-compatible driver is available via:\r\n    \r\n    ```\r\n    go get gofr.dev/pkg/gofr/datasource/elasticsearch@latest\r\n    ```\r\n    \r\n-   Example usage in your  `main.go`:\r\n    \r\n    ```go\r\n    func main (){\r\n\t\t    app := gofr.New()\r\n\t\t    \r\n\t\t\tes := elasticsearch.New(elasticsearch.Config{\r\n\t\t        Addresses: []string{\"http://localhost:9200\"},\r\n\t\t        Username: \"elastic\",\r\n\t\t        Password: \"changeme\",\r\n\t\t    })\r\n    \r\n\t\t    app.AddElasticsearch(es)\r\n\t\t    \r\n\t\t\tapp.Run ()\r\n    }\r\n    ``` \r\n- Checkout our [official documentation](https://gofr.dev/docs/datasources/getting-started) for more details.    \r\n\r\n \r\n",
+    "date": "2025-04-24T15:41:51Z",
+    "tag": "v1.38.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.38.0"
+  },
+  {
+    "body": "# **Release - v1.37.1**\r\n\r\n## 🚀 **Improvements**\r\n\r\n### **Extended Error Responses (RFC 9457-style)**\r\n\r\n-   GoFr now supports extended error responses following the [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457.html) specification.\r\n    \r\n-   Developers can implement the new `ResponseMarshaler` interface to enrich error responses with custom fields beyond the standard error message and status code.\r\n\t```go\r\n\ttype ResponseMarshaler interface {\r\n\t    Response() map[string]any\r\n\t}\r\n\t```\r\n- Example:\r\n\r\n\t```go\r\n\ttype ValidationError struct {\r\n\t    Field string \r\n\t    Message string \r\n\t    Code int \r\n\t} \r\n\r\n\tfunc  (e ValidationError) Error() string { \r\n\t\treturn e.Message \r\n\t} \r\n\r\n\tfunc  (e ValidationError) StatusCode() int { \r\n\t\treturn e.Code \r\n\t} \r\n\r\n\tfunc  (e ValidationError) Response() map[string]any { \r\n\t\treturn  map[string]any{ \r\n\t\t\t\"field\":   e.Field, \r\n\t\t\t\"type\": \"validation_error\", \r\n\t\t\t\"details\": \"Invalid input format\",\r\n\t    }\r\n\t}\r\n\t``` \r\n\r\n\t> ⚠️ **Note:**  The `message` field is automatically populated from the `Error()` method. Custom fields with the name \"message\" in the `Response()` map should not be used as they will be ignored in favor of the `Error()` value.\r\n\r\n\tThis feature allows more descriptive and structured error responses, ideal for client-side validation, API debugging, and frontend integration.\r\n\r\n## 🛠 **Fixes**\r\n\r\n\r\n### **1. WebSocket: Fixed Concurrent Write Panic**\r\n\r\n-   WebSocket writes are now thread-safe. Previously, concurrent calls to `WriteMessageToSocket()` caused race conditions and panics. Writes are now internally synchronized.\r\n    \r\n\r\n### **2. NATS: Synchronous Connection Setup**\r\n\r\n-   NATS connections are now established synchronously to prevent `errJetStreamNotConfigured` errors when calling `jetStream()` immediately after `Connect()`.\r\n",
+    "date": "2025-04-16T04:13:04Z",
+    "tag": "v1.37.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.37.1"
+  },
+  {
+    "body": "\r\n##  🚀 **Features**  \r\n\r\n\r\n### **1. Dgraph Migration Support**\r\n\r\n-   Added native migration capabilities for Dgraph through new methods, enabling precise schema evolution:\r\n\t```go\r\n\t// Apply or update the complete Dgraph schema \r\n\tApplySchema(ctx context.Context, schema string) error\r\n\t// Atomically create or update a field definition\r\n\tAddOrUpdateField(ctx context.Context, fieldName, fieldType, directives string) error  \r\n\t// Permanently remove a field/predicate and its associated data \r\n\tDropField(ctx context.Context, fieldName string) error\t \r\n\t``` \r\n-   Refer to  the [official documentation](https://gofr.dev/docs/datasources/dgraph) for full usage details.\r\n    \r\n## 🛠 **Improvements**  \r\n\r\n\r\n### **1. gRPC Server Configuration via  `AddGRPCServerOptions`**\r\n-   GoFr now allows configuring advanced gRPC  `ServerOptions`.\r\n-   Example: Enabling TLS and setting a connection timeout\r\n    \r\n    ```go\r\n    creds, _ := credentials.NewServerTLSFromFile(\"server-cert.pem\", \"server-key.pem\")\r\n    \r\n    app.AddGRPCServerOptions(\r\n        grpc.Creds(creds),\r\n        grpc.ConnectionTimeout(10*time.Second),\r\n    )\r\n    ``` \r\n- Refer to the [official documentation](https://gofr.dev/docs/advanced-guide/grpc) to know more.\r\n    \r\n### **2. Add Custom Unary Interceptors**\r\n    \r\n   ```go\r\n  app.AddGRPCUnaryInterceptors(authInterceptor)\r\n  ```\r\n- GoFr already logs, traces and sends default metrics for all gRPC calls. No external interceptor for such features is necessary. Custom server-side  `UnaryServerInterceptors` can now be registered easily for use cases like:\r\n    \r\n    -   Authentication\r\n    -   Request validation\r\n   \r\n - For guidance on how to define Server UnaryInterceptors that can be added in your GoFr's gRPC server, check out the [official documentation](https://gofr.dev/docs/advanced-guide/grpc).\r\n\r\n### **3. Advanced gRPC Client DialOptions Support**\r\n\r\n-   Clients can now be customized extensively via  `grpc.DialOptions`.\r\n     This allows to add gRPC services with :\r\n          -   Secure TLS communication\r\n          -   Load-balanced connections\r\n          -   Retry logic\r\n          -   Context-aware metadata injection (useful for tracing and auth)\r\n        \r\n\r\n    ```go\r\n    const serviceConfig = `{\r\n      \"loadBalancingPolicy\": \"round_robin\",\r\n      \"methodConfig\": [{\r\n        \"name\": [{\"service\": \"HelloService\"}],\r\n        \"retryPolicy\": {\r\n          \"maxAttempts\": 4,\r\n          \"initialBackoff\": \"0.1s\",\r\n          \"maxBackoff\": \"1s\",\r\n          \"backoffMultiplier\": 2.0,\r\n          \"retryableStatusCodes\": [\"UNAVAILABLE\", \"RESOURCE_EXHAUSTED\"]\r\n        }\r\n      }]\r\n    }` \r\n    \r\n\t// Metadata interceptor to add client ID to each request\r\n    func  MetadataUnaryInterceptor(ctx context.Context, method string, req, reply any,\r\n        cc *grpc.ClientConn, invoker grpc.UnaryInvoker, opts ...grpc.CallOption,\r\n    ) error {\r\n        md := metadata.Pairs(\"client-id\", \"f1b1a372-02f5-4065-9ccf-113d34a3d5ed\")\r\n        \r\n        ctx = metadata.NewOutgoingContext(ctx, md) \r\n\t\r\n\t    return invoker(ctx, method, req, reply, cc, opts...)\r\n    } \r\n\t\r\n\tfunc  main() {\r\n        app := gofr.New()\r\n    \r\n        creds, err := credentials.NewClientTLSFromFile(\"cert.pem\", \"\") if err != nil {\r\n            app.Logger().Errorf(\"TLS error: %v\", err) return }\r\n    \r\n        grpcClient, err := client.NewHelloServiceGoFrClient(\r\n            app.Config.Get(\"GRPC_SERVER_HOST\"),\r\n            app.Metrics(),\r\n            grpc.WithTransportCredentials(creds),\r\n            grpc.WithDefaultServiceConfig(serviceConfig),\r\n            grpc.WithChainUnaryInterceptor(MetadataUnaryInterceptor),\r\n        ) \r\n\t\r\n\t\tif err != nil {\r\n            app.Logger().Errorf(\"Failed to create client: %v\", err) return \r\n        }\r\n    \r\n        handler := NewGreetHandler(grpcClient)\r\n        \r\n        app.GET(\"/hello\", handler.Hello)\r\n        \r\n        app.Run()\r\n    }\r\n    ```\r\n     - Refer to the [official documentation](https://gofr.dev/docs/advanced-guide/grpc) to know more.\r\n         \r\n## 🛠 **Fixes**  \r\n\r\n### **1. SurrealDB  `Update`  Method: Unexpected Behavior Fixed** \r\n- Regardless of the input, the  `Update`  method previously inserted an unexpected hardcoded key-value pair. The method now correctly updates  **only  the intended fields** as passed by the caller.\r\n",
+    "date": "2025-04-08T14:29:59Z",
+    "tag": "v1.37.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.37.0"
+  },
+  {
+    "body": "# **Release - v1.36.0**  \r\n\r\n##  🚀 **Features**  \r\n\r\n### **1. SurrealDB Migration Support**  \r\n- Added support for database migration operations in SurrealDB.  \r\n- Supported methods include:  \r\n\t```go\r\n\t// Creates a new namespace in SurrealDB.\r\n\tCreateNamespace(ctx context.Context, namespace string) error  \r\n\t// Creates a new database in SurrealDB.\r\n\tCreateDatabase(ctx context.Context, database string) error \r\n\t// Deletes a namespace from SurrealDB.\r\n\tDropNamespace(ctx context.Context, namespace string) error\r\n\t// Deletes a database from SurrealDB.  \r\n\tDropDatabase(ctx context.Context, database string) error  \r\n\t``` \r\n- Refer to our [official documentation](https://gofr.dev/docs/datasources/surrealdb) to know more.\r\n\r\n## 🛠 **Improvements**  \r\n\r\n### **1. Default Metrics for SurrealDB Data Source**  \r\n- Introduced default metric collection for SurrealDB at the specified `METRICS_PORT`, enabling better observability and performance monitoring.  \r\n\r\n### **2. JWT Claim Validations**  \r\n- `EnableOAuth` now takes an additional JWT validation options as `jwt.ParserOption`, allowing fine-grained control over claim validation. \r\n- Example :\r\n\t```go\r\n\tapp.EnableOAuth(\r\n\t\t\"http://jwks-endpoint\",\r\n\t\t20,\r\n\t\tjwt.WithExpirationRequired(), // to enforce presence of exp claim in every token\r\n\t\tjwt.WithAudience(\"https://api.example.com\"),\r\n\t\tjwt.WithIssuer(\"https://auth.example.com\")\r\n\t)\r\n\t```\r\n- To know more about the different claim validation options, check out our [official documentation](https://gofr.dev/docs/advanced-guide/http-authentication#3-o-auth-2-0).\r\n\r\n## 🛠 **Fixes**  \r\n\r\n### **1. `pprof` Profiling Enhancements**  \r\n- Previously, the `pprof` endpoint was restricted to being enabled only when the `APP_ENV=DEBUG` environment variable was set, and it ran on the specified `HTTP_PORT`. This prevented users from loading their different environments, for e.g. stage or production configurations if we set `APP_ENV` as `DEBUG` for profiling.\r\n- GoFr now automatically enables `pprof` profiling on `METRICS_PORT` (default: `2121`).  \r\n- Profiling endpoints include :  \r\n  - `/debug/pprof/cmdline`  \r\n  - `/debug/pprof/profile`  \r\n  - `/debug/pprof/symbol`  \r\n  - `/debug/pprof/trace`  \r\n  - `/debug/pprof/` (index)  \r\n \r\nFor more information on setting up and using profiling in your application, refer to our [official documentation](https://gofr.dev).\r\n\r\n",
+    "date": "2025-03-25T15:02:17Z",
+    "tag": "v1.36.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.36.0"
+  },
+  {
+    "body": "# **Release - v1.35.2**\r\n\r\n# 🛠 **Improvements**\r\n\r\n### **1. Kafka TLS Enhancements**\r\n-   Added support for configuring Kafka with **TLS parameters**, enabling seamless integration with **Confluent Kafka SaaS** and similar ecosystems.\r\n Introduced the following configuration options:\r\n\r\n    ```\r\n    KAFKA_TLS_CERT_FILE            : Path to the TLS certificate file.  \r\n    KAFKA_TLS_KEY_FILE             : Path to the TLS key file.  \r\n    KAFKA_TLS_CA_CERT_FILE         : Path to the TLS CA certificate file.  \r\n    KAFKA_TLS_INSECURE_SKIP_VERIFY : Boolean option to skip TLS certificate verification.  \r\n    ```\r\n\r\n    **Note:** All provided paths must be absolute. Check out our [official documentation](https://gofr.dev/docs/advanced-guide/using-publisher-subscriber#kafka) to learn more.  \r\n\r\n### **2. Static File Server Enhancements**\r\n    \r\n-  If a requested file is missing, the server attempts to serve `404.html` with a `404` status code. If `404.html` is unavailable, it returns a `404` status code.\r\n    \r\n-   If the file being accessed lacks **read permissions**, the error is logged and an appropriate  `500 Internal Server Error`  status code and response body is returned.\r\n\r\n# 🛠  **Fixes**\r\n\r\n### **1. Middleware Execution Order**\r\n-   Restored the original middleware execution order prior to [**Release v1.35.0**](https://github.com/gofr-dev/gofr/releases/tag/v1.35.0). Standard middlewares (`logs`, `traces`, `metrics`, `CORS`) are now executed before user-defined middlewares, ensuring consistent observability even when responses are handled early for e.g. in custom middlewares.\r\n- However, **WebSocket** connection upgrades necessarily take place **after all middleware processing**, maintaining compatibility with corresponding authentication flows introduced previously.\r\n\r\n\r\n### **2. Kafka Security Protocol Configuration Fix**\r\n-   Previously, SASL authentication failed in ecosystems like Confluent due to missing `security.protocol` support, causing errors like:  \r\n     ```\r\n      SASL handshake failed: EOF\r\n     ```\r\n-   Introduced `KAFKA_SECURITY_PROTOCOL` to explicitly define the security protocol for Kafka communication. Supported options include : `PLAINTEXT`, `SSL`, `SASL_PLAINTEXT`, `SASL_SSL`, ensuring seamless authentication. Check out [official documentation](https://gofr.dev/docs/advanced-guide/using-publisher-subscriber#kafka) to know more.\r\n   \r\n### 3. **Redundant WriteHeader Calls**\r\n-   Fixed redundant WriteHeader calls when custom middleware in the static file server set a status code, preventing log spam like:\r\n\t   ```\r\n\t    http: superfluous response.WriteHeader call  from gofr.dev/pkg/gofr/http/middleware.(*StatusResponseWriter).WriteHeader (logger.go:23)\r\n\t``` \r\n-   Headers are now written once—by either user-defined middleware or the framework handlers.\r\n",
+    "date": "2025-03-18T14:48:52Z",
+    "tag": "v1.35.2",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.35.2"
+  },
+  {
+    "body": "\r\n# **Release v1.35.1**\r\n \r\n# 🛠  **Improvements**\r\n\r\n### **1. Kafka Connection & Security Enhancements**\r\n\r\n-   Added support for configuring Kafka with extra **connection and security parameters** to **seamlessly integrate** with Confluent Kafka SaaS and similar platforms.\r\n-   Introduced three new configuration options for **SASL authentication**:\r\n\r\n\t#### 🔧 `KAFKA_SASL_MECHANISM`\r\n\t-   SASL mechanism for authentication (e.g. `PLAIN`, `SCRAM-SHA-256`, `SCRAM-SHA-512`)\r\n\t-   Default: `None`\r\n\r\n\t#### 🔧 `KAFKA_SASL_USERNAME`\r\n\r\n\t-   Username for SASL authentication\r\n\t-   Default: `None`\r\n\r\n\t#### 🔧 `KAFKA_SASL_PASSWORD`\r\n\r\n\t-   Password for SASL authentication\r\n\t-   Default: `None`\r\n\r\n### **2. Multiple Static Folders Support**\r\n-   **Multiple static folders** can now be registered and served at different custom endpoints.\r\n    \r\n-   Example usage:\r\n```go\r\n    package main \r\n    \r\n    import  \"gofr.dev/pkg/gofr\"  \r\n\r\n\tfunc  main() {\r\n        app := gofr.New()\r\n        app.AddStaticFiles(\"public\", \"./public\")\r\n        app.AddStaticFiles(\"static\", \"./static\")\r\n        app.Run()\r\n    }\r\n   ``` \r\n    \r\n-   In this example:\r\n    \r\n    -   Files in the `public` folder are served at `host/public/*`\r\n    -   Files in the `static` folder are served at `host/static/*`\r\n  \r\n### **3. ArangoDB Resource Creation Enhanced**\r\n\r\n-   `CreateDB`, `CreateGraph`, and `CreateCollection`  methods in Arango, now check for existing resources before creating them. Check out our [official documentation](https://gofr.dev/docs/datasources/arangodb) to know more.\r\n\r\n# 🛠  **Fixes**\r\n\r\n### **1. Fixed Static File Server Endpoint Handling**\r\n-   Previously, files in the **`static`** directory were served by default at **`/static/`**. If the same directory was registered at another path, the files were being served at both endpoints, resulting in duplicate serving.\r\n-   This has now been fixed. If a user registers a custom endpoint using **`app.AddStaticFiles({custom-endpoint}, ./static)`**, GoFr will automatically serve the files only at the specified custom endpoint.\r\n-   Additionally, if any directories are re-registered within the GoFr application, the files will now be served at the **latest** registered endpoint, ensuring there’s no duplication.\r\n\r\n\r\n\r\n\r\n",
+    "date": "2025-03-11T13:34:29Z",
+    "tag": "v1.35.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.35.1"
+  },
+  {
+    "body": "# **Release  v1.35.0**\r\n\r\n# 🚀  **Features**\r\n\r\n### **1. Template Rendering Support**  \r\n\r\n- GoFr now supports rendering HTML templates directly from handlers using the new `response.Template` response type. \r\n\r\n- By default, it looks for template files in the `templates` directory, automatically parsing the specified file and injecting the provided data, allowing developers to serve dynamic HTML content without requiring a separate template rendering mechanism.\r\n\r\n- #### **Usage Example:**\r\n\tHere's how you can use template rendering in a GoFr handler:\r\n\t```go\r\n\tpackage main\r\n\r\n\timport (\r\n\t\t\"fmt\"\r\n\t\t\"net/http\"\r\n\r\n\t\t\"gofr.dev/pkg/gofr\"\r\n\t\t\"gofr.dev/pkg/gofr/response\"\r\n\t)\r\n\r\n\ttype Todo struct {\r\n\t\tTitle       string\r\n\t\tDescription string\r\n\t\tDone        bool\r\n\t}\r\n\r\n\tfunc main() {\r\n\t\tapp := gofr.New()\r\n\r\n\t\tapp.GET(\"/todo\", func(ctx *gofr.Context) (interface{}, error) {\r\n\t\t\tdata := Todo{\r\n\t\t\t\tTitle:       \"Learn GoFr\",\r\n\t\t\t\tDescription: \"Understand how template rendering works in GoFr\",\r\n\t\t\t\tDone:        false,\r\n\t\t\t}\r\n\t\t\treturn response.Template{Name: \"todo.html\", Data: data}, nil\r\n\t\t})\r\n\r\n\t\tapp.Run()\r\n\r\n\t}\r\n\t```\r\n\r\n\t#### **Example Template (templates/todo.html):**\r\n\r\n\t```\r\n\t<!DOCTYPE html>\r\n\t<html lang=\"en\">\r\n\t<head>\r\n\t    <meta charset=\"UTF-8\">\r\n\t    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\r\n\t    <title>Todo</title>\r\n\t</head>\r\n\t<body>\r\n\t    <h1>{{ .Title }}</h1>\r\n\t    <p>{{ .Description }}</p>\r\n\t    <p>Status: {{ if .Done }} ✅ Completed {{ else }} ❌ Pending {{ end }}</p>\r\n\t</body>\r\n\t</html>\r\n\t```\r\n\tWhen a request is made to `/todo`, GoFr will render the `todo.html` template by injecting the provided `Todo` struct values.\r\n\r\n### **2. Graceful Shutdown Configuration**\r\n\r\n- A new environment variable, `SHUTDOWN_GRACE_PERIOD`, has been introduced to allow customization of the server's shutdown timeout.\r\n\r\n-   **Default:** `30s`\r\n-   **Purpose:** Ensures in-flight requests are served before shutdown.\r\n \r\n# 🛠  **Fixes & Improvements**\r\n\r\n### **1. Authentication in Websockets**  \r\n- Ensured proper authentication for GoFr WebSocket connections by requiring user-defined authentication or middleware to run before upgrading, as WebSockets do not inherently support authentication.\r\n    \r\n### **2.  Fixed Infinite Write Retry on Closed WebSocket** \r\n- Previously, if a WebSocket connection was only writing and then closed, it would result in infinite retries without properly closing. This issue has now been resolved.\r\n\r\n\r\n",
+    "date": "2025-03-04T14:00:12Z",
+    "tag": "v1.35.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.35.0"
+  },
+  {
+    "body": "# **Release - v1.34.1**\r\n\r\n\r\n# 🛠  **Fixes & Improvements**\r\n\r\n### **1. GoFr Now Runs on Go 1.24**  \r\nGoFr is now powered by the latest Golang version 1.24, ensuring compatibility with the newest features and improvements.  \r\n\r\n### **2. Improved Retry Mechanism for MQTT Default Client**  \r\nThe MQTT Default Client now includes automatic retries and seamless reconnection, enhancing reliability and stability.  \r\n\r\n### **3. Fixed Command Routing in CLI Applications**  \r\nCLI applications built with GoFr now correctly resolve the intended commands typed in the terminal, preventing unintended command execution.\r\n",
+    "date": "2025-02-25T17:41:34Z",
+    "tag": "v1.34.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.34.1"
+  },
+  {
+    "body": "# **Release - v1.34.0**\r\n\r\n# 🚀  **Features**\r\n\r\n### **1. NATS-KV Store Support**  \r\nGoFr now supports  **NATS-KV Store**  as a datastore. The supported methods include:\r\n    \r\n```go\r\ntype KVStore interface {\r\n    Get(ctx context.Context, key string) (string, error)\r\n    Set(ctx context.Context, key, value string) error\r\n    Delete(ctx context.Context, key string) error\r\n    HealthCheck(ctx context.Context) (any, error)\r\n}\r\n```\r\nTo integrate NATSKV Store as a datastore, add the following configuration:\r\n    \r\n```go\r\napp.AddKVStore(nats.New(nats.Configs{\r\n        Server: \"nats://localhost:4222\",\r\n        Bucket: \"persons\",\r\n    }))\r\n```\r\nRefer to the  [**documentation**](https://gofr.dev/docs/advanced-guide/injecting-databases-drivers)  for more details.\r\n    \r\n### **2. ArangoDB Migrations**  \r\nAdded migration support for  **ArangoDB**, allowing users to perform schema changes seamlessly. The following methods are now available in migration:\r\n    \r\n```go\r\n// CreateDB creates a new database in ArangoDB.\r\nCreateDB(ctx context.Context, database string) error\r\n\r\n// DropDB deletes an existing database in ArangoDB.\r\nDropDB(ctx context.Context, database string) error\r\n\r\n// CreateCollection creates a new collection in a database.\r\nCreateCollection(ctx context.Context, database, collection string, isEdge bool) error\r\n\r\n// DropCollection deletes an existing collection from a database.\r\nDropCollection(ctx context.Context, database, collection string) error\r\n\r\n// CreateGraph creates a new graph in a database.\r\n//\r\n// Parameters:\r\n//   - ctx: Request context for tracing and cancellation.\r\n//   - database: Name of the database where the graph will be created.\r\n//   - graph: Name of the graph to be created.\r\n//   - edgeDefinitions: Pointer to EdgeDefinition struct containing edge definitions.\r\n//\r\n// Returns an error if edgeDefinitions is not of type *EdgeDefinition or is nil.\r\nCreateGraph(ctx context.Context, database, graph string, edgeDefinitions any) error\r\n\r\n// DropGraph deletes an existing graph from a database.\r\nDropGraph(ctx context.Context, database, graph string) error\r\n\r\n``` \r\n \r\n# 🛠  **Fixes & Improvements**\r\n\r\n### **1. Automatic PubSub Reconnection**  \r\nFixed automatic retries and reconnection in  **PubSub**. It now reconnects immediately upon connection availability.\r\n    \r\n### **2. Added  `go.work`** \r\nSimplifies dependency handling and development with better multi-module management.\r\n\r\n### **3. Telemetry for Active GoFr Servers** \r\nGoFr now includes telemetry to track the number of running GoFr servers, helping us understand adoption and usage trends.\r\n\r\nTo disable telemetry, set:\r\n```bash\r\nGOFR_TELEMETRY=false\r\n```\r\n\r\n",
+    "date": "2025-02-18T14:30:13Z",
+    "tag": "v1.34.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.34.0"
+  },
+  {
+    "body": "# Release v1.33.0\r\n\r\n# 🚀  **Features**\r\n\r\n### **1.  ArangoDB Support as a Datasource**\r\n\r\nUsers can now integrate **ArangoDB** as a datasource within their GoFr applications. Supported Methods include : \r\n```go\r\ntype ArangoDB interface {\r\n    // CreateDocument creates a new document in the specified collection.\r\n\tCreateDocument(ctx context.Context, dbName, collectionName string, document any) (string, error)\r\n\t// GetDocument retrieves a document by its ID from the specified collection.\r\n\tGetDocument(ctx context.Context, dbName, collectionName, documentID string, result any) error\r\n\t// UpdateDocument updates an existing document in the specified collection.\r\n\tUpdateDocument(ctx context.Context, dbName, collectionName, documentID string, document any) error\r\n\t// DeleteDocument deletes a document by its ID from the specified collection.\r\n\tDeleteDocument(ctx context.Context, dbName, collectionName, documentID string) error\r\n\t// GetEdges retrieves all the edge documents connected to a specific vertex in an ArangoDB graph.\r\n\tGetEdges(ctx context.Context, dbName, graphName, edgeCollection, vertexID string, resp any) error\r\n\t// Query executes an AQL query and binds the results\r\n\tQuery(ctx context.Context, dbName string, query string, bindVars map[string]any, result any) error\r\n    HealthCheck(context.Context) (any, error)\r\n}\r\n```\r\nRefer to our [official documentation](https://gofr.dev/docs/advanced-guide/injecting-databases-drivers) to know more.\r\n\r\n### **2.  Default HealthCheck Support for gRPC Servers and Clients**\r\nThis release introduces built-in **HealthCheck** support for both gRPC servers and clients.\r\n\r\n- **Prerequisites:**  \r\nTo use the new health check features, ensure that **gofr-cli v0.5.0** is installed. Use it to generate your gRPC client and server templates.\r\n\r\n- **gRPC Servers**\r\nAfter running the existing command:\r\n\r\n\t```\r\n\t gofr wrap grpc server -proto=path/to/your/proto/file\r\n\t```\r\n\r\n\tA new file named `health_gofr.go` will be generated. This file contains the health functionality for your gRPC server. The health methods are embedded within the GoFr gRPC server struct, which looks like this:\r\n\r\n\t```go\r\n\ttype {serviceName}GoFrServer struct {\r\n\t    health *healthServer\r\n\t}\r\n\t```\r\n\r\n\t**Supported HealthCheck Methods:**\r\n\r\n\t```go\r\n\t// Check checks if the service is healthy.\r\n\tfunc (h *healthServer) Check(ctx *gofr.Context, req *grpc_health_v1.HealthCheckRequest) (*grpc_health_v1.HealthCheckResponse, error)\r\n\t// Watch watches for any changes in the service’s health status.\r\n\tfunc (h *healthServer) Watch(ctx *gofr.Context, in *grpc_health_v1.HealthCheckRequest, stream grpc_health_v1.Health_WatchServer) error\r\n\t// SetServingStatus allows you to set the health status of the service (healthy, unhealthy, etc.).\r\n\tfunc (h *healthServer) SetServingStatus(ctx *gofr.Context, service string, status grpc_health_v1.HealthCheckResponse_ServingStatus)\r\n\t// Shutdown gracefully shuts down the service.\r\n\tfunc (h *healthServer) Shutdown(ctx *gofr.Context)\r\n\t// Resume resumes the service after it has been shut down.\r\n\tfunc (h *healthServer) Resume(ctx *gofr.Context)\r\n\t```\r\n\r\n\tTo integrate these health features, register your gRPC server in `main.go` as follows:\r\n\r\n\t```go\r\n\tfunc main() {\r\n\t    app := gofr.New()\r\n\r\n\t    packageName.Register{serviceName}ServerWithGofr(app, &{packageName}.New{serviceName}GoFrServer())\r\n\r\n\t    app.Run()\r\n\t}\r\n\t```\r\n\r\n- **For gRPC Clients**\r\nHealthCheck calls are now supported on all gRPC clients generated through the gofr-cli command i.e :\r\n\t```\r\n\tgofr wrap grpc client -proto=path/to/your/proto/file\r\n\t```\r\n\t**Supported HealthCheck methods** include :\r\n\t```go\r\n\t// Check checks the service health.\r\n\tfunc (c *{serviceName}GoFrClient) Check(ctx *gofr.Context, in *grpc_health_v1.HealthCheckRequest) (*grpc_health_v1.HealthCheckResponse, error)\r\n\t// Watch allows the client to watch for health status changes.\r\n\tfunc (c *{serviceName}GoFrClient) Watch(ctx *gofr.Context, in *grpc_health_v1.HealthCheckRequest) (grpc.ServerStreamingClient[grpc_health_v1.HealthCheckResponse], error)\r\n\t```\r\n\t\t\r\nFor a deeper understanding, check out our [official documentation](https://gofr.dev/docs/advanced-guide/grpc) and refer to our [example repo](https://github.com/gofr-dev/gofr/tree/main/examples/grpc).\r\n\r\n# 🛠️ **Fix**\r\nResolved an issue with the `AddRESTHandlers` support where PUT requests were not updating records in the database when we have `autoincrement` tag added in our entity struct. The issue has now been fixed.\r\n",
+    "date": "2025-02-06T06:37:38Z",
+    "tag": "v1.33.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.33.0"
+  },
+  {
+    "body": "# Release v1.32.0\r\n\r\n## 🚀 **Features :**\r\n\r\n**1. Support for SurrealDB as a Data Source**  \r\nSurrealDB is now supported as a data source in GoFr. The following methods are supported:\r\n```go\r\ntype SurrealDB interface  {\r\n\tQuery(ctx context.Context, query string, vars map[string]any) ([]any, error)\r\n\tCreate(ctx context.Context, table string, data any) (map[string]any, error)\r\n\tUpdate(ctx context.Context, table string, id string, data any) (any, error)\r\n\tDelete(ctx context.Context, table string, id string) (any, error)\r\n\tSelect(ctx context.Context, table string) ([]map[string]any, error)\r\n\tHealthCheck(context.Context) (any, error)\r\n}\r\n```\r\n\r\nTo integrate SurrealDB into your application, use the `AddSurrealDB` method in your `main.go` :\r\n\r\n```go\r\nclient := surrealdb.New(&surrealdb.Config{\r\n    Host:       \"localhost\",\r\n    Port:       8000,\r\n    Username:   \"root\",\r\n    Password:   \"root\",\r\n    Namespace:  \"test_namespace\",\r\n    Database:   \"test_database\",\r\n    TLSEnabled: false,\r\n})\r\n\r\napp.AddSurrealDB(client)\r\n```\r\nFor more details, refer to our [official documentation](https://gofr.dev/docs/advanced-guide/injecting-databases-drivers).\r\n\r\n**2. Built-in Metrics for gRPC Services**\r\n    \r\nGoFr now includes **in-built metrics** for all **gRPC server executions and interservice gRPC calls**. We automatically capture metrics to measure the response time of gRPC server/clients.\r\n  \r\n  - Prerequisites : **gofr-cli version v0.4.0** must be installed. \r\n  - Use the following commands :\r\n     - ` gofr wrap grpc server --proto=<path/to/proto/file>` to generate GoFr's gRPC handlers.\r\n     - `gofr wrap grpc client -proto=<path/to/proto/file>` to generate GoFr's gRPC client.\r\n- Refer the  [official documentation](https://gofr.dev/docs/advanced-guide/grpc) & [examples](https://github.com/gofr-dev/gofr/tree/main/examples/grpc) to set up gRPC server/clients with in built logging, tracing and metrics support.\r\n\r\n## 🛠️ **Fixes :**\r\n **1. Enhanced gRPC Logging**\r\n-   Improved logs for interservice gRPC calls, now including:\r\n       -   **Trace ID:** For better tracking of distributed requests.\r\n       -   **Status Code:** Logs the response status of gRPC calls for easy debugging and issue resolution.\r\n",
+    "date": "2025-01-27T08:59:36Z",
+    "tag": "v1.32.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.32.0"
+  },
+  {
+    "body": "# Release v1.31.0\r\n\r\n## 🚀 Features :\r\n\r\n1. **Support for ScyllaDB as a Data Source**  \r\n   ScyllaDB is now supported as a data source in GoFr. The following methods are supported:\r\n\r\n   ```go\r\n   Query(dest any, stmt string, values ...any) error  \r\n   QueryWithCtx(ctx context.Context, dest any, stmt string, values ...any) error  \r\n   Exec(stmt string, values ...any) error  \r\n   ExecWithCtx(ctx context.Context, stmt string, values ...any) error  \r\n   ExecCAS(dest any, stmt string, values ...any) (bool, error)  \r\n   NewBatch(name string, batchType int) error  \r\n   NewBatchWithCtx(ctx context.Context, name string, batchType int) error  \r\n   BatchQuery(name, stmt string, values ...any) error  \r\n   BatchQueryWithCtx(ctx context.Context, name, stmt string, values ...any) error  \r\n   ExecuteBatchWithCtx(ctx context.Context, name string) error  \r\n   ```\r\n\r\n   To integrate ScyllaDB into your application, use the `AddScyllaDB` method:\r\n\r\n   ```go\r\n   client := scylladb.New(scylladb.Config{\r\n       Host:     app.Config.Get(\"SCYLLADB_HOST\"),\r\n       Keyspace: app.Config.Get(\"SCYLLADB_KEYSPACE\"),\r\n       Port:     app.Config.GetInt(\"SCYLLADB_PORT\"),\r\n       Username: app.Config.Get(\"SCYLLADB_USERNAME\"),\r\n       Password: app.Config.Get(\"SCYLLADB_PASSWORD\"),\r\n   })\r\n   app.AddScyllaDB(client)\r\n   ```\r\n\r\n   For detailed instructions, refer to the [ScyllaDB documentation](https://github.com/gofr-dev/gofr/blob/development/docs/advanced-guide/injecting-databases-drivers/page.md#scylladb).\r\n\r\n2. **Built-in Tracing for Interservice gRPC Calls**  \r\n   All interservice gRPC calls in GoFr now include in-built tracing support.\r\n\r\n   - **Prerequisite**: Ensure `gofr-cli` v0.3.0 is installed. To install `gofr-cli`, run:\r\n     ```bash\r\n     go install gofr.dev/cli/gofr@latest\r\n     ```\r\n\r\n   - To generate the gRPC client, run:\r\n     ```bash\r\n     gofr wrap grpc client -proto=path/to/your/proto/file\r\n     ```\r\n\r\n   For detailed instructions on setting up the gRPC Client in GoFr, refer to the [documentation](https://gofr.dev/docs/advanced-guide/grpc). You can also explore an example gRPC client implementation in the [examples folder](https://github.com/gofr-dev/gofr/tree/ca741320534061d5e4550931949e27543b6c69bf/examples/grpc).\r\n\r\n\r\n**Full Changelog**: https://github.com/gofr-dev/gofr/compare/v1.30.0...v1.31.0",
+    "date": "2025-01-20T11:18:30Z",
+    "tag": "v1.31.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.31.0"
+  },
+  {
+    "body": "## Release v1.30.0\r\n\r\n## 🚀 Features\r\n\r\n#### 1. GoFr's Context Support in gRPC Handlers\r\n\r\nIntroduced context integration for gRPC handlers, enabling efficient dependency and tracing management.\r\nAutomatically generates gRPC handler templates with built-in support for `gofr's context` using the **`gofr wrap grpc`** command of [gofr cli](https://github.com/gofr-dev/gofr-cli/releases/tag/v0.2.1).\r\n\r\n**Note:** For details on setting up Protocol Buffers and gRPC in GoFr, visit the official [Documentation](https://gofr.dev/docs/advanced-guide/grpc#creating-protocol-buffers) and [Example](https://github.com/gofr-dev/gofr/tree/development/examples/grpc-server)\r\n\r\n## 🔧 Fixes\r\n\r\n#### 1. `ExpectSelect` Update in SQL Mocks\r\n\r\nRefactored the `ExpectSelect` function in SQL mocks. Users can now set expected responses using the `ReturnsResponse` method, ensuring accurate mock behavior during tests.\r\n\r\n* **Example Usage:**\r\n\r\n    ```go\r\n    var result, actualResult Response\r\n\r\n    mockContainer, sqlMock := NewMockContainer(t)\r\n    ctx := &gofr.Context{\r\n      Container: mockContainer,\r\n    }\r\n\r\n    expectedResult := Response{\r\n      // ... fill with expected values\r\n    }\r\n\r\n    sqlMock.ExpectSelect(ctx, &result, query).ReturnsResponse(expectedResult)\r\n\r\n    ctx.SQL.Select(ctx, &actualResult, query)\r\n\r\n    assert.Equal(t, actualResult, expectedResult)\r\n    ```\r\n\r\n#### 2. Environment Variable Handling\r\n\r\n* OS-level environment variables now override values from `.env`, `.<APP_ENV>.env` configurations, ensuring consistent behaviour across environments.\r\n\r\n#### 3. Improved Logging\r\n\r\n* Removed sensitive information (e.g., usernames and passwords) from MongoDB connection logs by replacing `uri` with `host`.\r\n* Fixed inaccurate Redis connection logs and removed unnecessary SQL connection logs when no SQL connection is established.\r\n* Added error logs for database migration failures, improving visibility during debugging.\r\n\r\n#### 4. Security Fixes\r\n\r\n* Updated `golang.org/x/crypto` to v0.31.0 to resolve potential authorization bypass issues.\r\n* Updated `go.mod` in `pkg/gofr/datasource/mongo` for compatibility with Go commands.\r\n",
+    "date": "2025-01-10T06:24:21Z",
+    "tag": "v1.30.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.30.0"
+  },
+  {
+    "body": "# Release v1.29.0\r\n\r\n---\r\n\r\n### ✨ Features:\r\n1. **Custom Metadata in Responses**  \r\n   Users can now include metadata in API responses using the `response.Response` struct. This allows for clean, structured responses while providing additional contextual information.  \r\n   - **Response Structure**:  \r\n     - With Metadata:  \r\n       ```json\r\n       {\r\n           \"data\": {},\r\n           \"metadata\": {}\r\n       }\r\n       ```\r\n     - Without Metadata:  \r\n       ```json\r\n       {\r\n           \"data\": {}\r\n       }\r\n       ```  \r\n   - **Example Usage**:  \r\n     ```go\r\n     func HelloHandler(c *gofr.Context) (interface{}, error) {\r\n         headers := map[string]string{\r\n             \"X-Custom-Header\": \"CustomValue\",\r\n         }\r\n\r\n         metaData := map[string]any{\r\n             \"environment\": \"staging\",\r\n             \"timestamp\":   time.Now(),\r\n         }\r\n\r\n         return response.Response{\r\n             Data:     map[string]string{\"message\": \"Hello, World!\"},\r\n             Metadata: metaData,\r\n             Headers:  headers,\r\n         }, nil\r\n     }\r\n     ```  \r\n---\r\n\r\n2. **Support for Redis Database Selection**:\r\n- Introduces a new config `REDIS_DB` to specify the Redis database index to be used.\r\n- Example usage:\r\n    ```go\r\n    os.Setenv(\"REDIS_DB\", \"1\")\r\n    ```\r\n\r\n### 🛠️ Fixes:\r\n1. **Disconnected Spans Exported for Remote-log-url**:\r\n- Resolves an issue where disconnected spans were created for each fetch request of the remote log.\r\n- Ensures that all traces exported for a single HTTP request have spans in hierarchy.\r\n\r\n2. **Hardcoded Ports Fix**:\r\n- Addresses the issue of hardcoded ports within the codebase.\r\n- Now allows for dynamic port configuration, improving flexibility and deployment scenarios.\r\n\r\n3. **Lowercase Default Paths for CRUD Helpers**:\r\n- Changes the default paths for CRUD helpers to be in lowercase.\r\n- Helps avoid confusion caused by case sensitivity on certain servers.\r\n",
+    "date": "2024-12-24T13:12:45Z",
+    "tag": "v1.29.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.29.0"
+  },
+  {
+    "body": "# Release v1.28.2\r\n\r\n**Fixes 🛠️️ :**\r\n\r\n-   Set `Content-Type: application/json` for HTTP service that doesn't explicitly provide a content type, when calling `GET`, `POST`, or similar methods during interservice communication.\r\n",
+    "date": "2024-12-11T07:29:15Z",
+    "tag": "v1.28.2",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.28.2"
+  },
+  {
+    "body": "## Release v1.28.1\r\n\r\n#### 🛠️ Fixes:\r\n\r\n1.  **Improved Static File Metrics**\r\n    \r\n    -   Metrics middleware now accurately identifies and tracks static file requests, including handling file paths with query parameters.\r\n    \r\n    **Example:**\r\n     Metrics will now correctly log  `/static/example.js`  or  `/static/example.js?v=42`.\r\n    \r\n2.  **Subscription Handler Validation**\r\n    -   Improved error handling in  `App.Subscribe()`.\r\n    -   Ensures that  `topic`  and  `handler`  parameters are validated to prevent runtime errors.\r\n    -   Logs detailed error messages for invalid subscriptions.\r\n\r\n",
+    "date": "2024-12-09T08:44:34Z",
+    "tag": "v1.28.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.28.1"
+  },
+  {
+    "body": "### ✨ Features:\r\n\r\n**Custom Response Headers Support**:\r\nUsers can add custom HTTP response headers using the  `Response`  struct. This feature helps add extra information, such as security policies or other metadata, to improve communication between clients and servers.\r\n-  Example usage:\r\n    ``` go\r\n        return response.Response{\r\n            Data:    \"Hello World from new Server\",\r\n            Headers: map[string]string{\"X-Custom-Header\": \"CustomValue\", \"X-Another-Header\": \"AnotherValue\"},\r\n        }` \r\n      ```  \r\n \r\n**OpenTSDB Support**:  \r\nUsers can integrate OpenTSDB to store and retrieve time-series data. \r\n- Methods include:\r\n  - `PutDataPoints`: Send data to OpenTSDB.\r\n  -  `QueryDataPoints`: Retrieve data based on specified parameters.\r\n  - `GetAggregators`: Get available aggregation functions.\r\n  - `QueryAnnotation`,  `PostAnnotation`,  `PutAnnotation`,  `DeleteAnnotation`: Manage annotations in OpenTSDB.\r\n \r\n - To import GoFr's external OpenTSDB driver:\r\n  `go get gofr.dev/pkg/gofr/datasource/opentsdb@latest`\r\n   \r\n```go\r\ntype OpenTSDB interface { \r\n    HealthChecker \r\n    PutDataPoints(ctx context.Context, data any, queryParam string, res any) error\r\n    QueryDataPoints(ctx context.Context, param any, res any) error \r\n    QueryLatestDataPoints(ctx context.Context, param any, res any) error \r\n    GetAggregators(ctx context.Context, res any) error QueryAnnotation(ctx context.Context, queryAnnoParam map[string]any, res any) error \r\n    PostAnnotation(ctx context.Context, annotation any, res any) error\r\n    PutAnnotation(ctx context.Context, annotation any, res any) error \r\n    DeleteAnnotation(ctx context.Context, annotation any, res any) error \r\n}\r\n```    \r\n - For more info, checkout the documentation: https://gofr.dev/docs/advanced-guide/injecting-databases-drivers#open-tsdb\r\n\r\n**Support for Binding Binary/Octet Stream**:  \r\nUsers can bind `binary/octet-stream` content directly to `[]byte` slices using GoFr context.\r\n- Example usage:\r\n\r\n  ```go\r\n      var result []byte\r\n      err := req.Bind(&result)\r\n      if err != nil {\r\n        log.Fatalf(\"Bind error: %v\", err)\r\n      } \r\n    ```\r\n\r\n\r\n### 🛠️ Fixes:\r\n\r\n**Milliseconds Logged as Microseconds**:\r\n- Previously, operation duration was calculated in milliseconds but was incorrectly logged as microseconds, which led to confusion. This has been fixed to ensure that logs display the accurate duration in microseconds.\r\n  \r\n**Dgraph Datasource Panic Fix**\r\n- Fixed an issue where the Dgraph datasource would panic due to an uninitialized tracer when added as an external datasource. This bug has been addressed.\r\n    \r\n**Solr Methods Fixes**:\r\n-  Fixed errors occurring in the following Solr datasource methods:  `Update`,  `Delete`,  `ListFields`,  `Retrieve`,  `AddField`,  `UpdateField`,  `DeleteField`.\r\n-  Updated documentation and provided a working example, accordingly.\r\n    \r\n**Deprecated  `UseMiddlewareWithContainer`  Method**:\r\n- The method  `UseMiddlewareWithContainer`  has been deprecated and will be removed in future releases. Developers should use the  `*App.UseMiddleware`  method instead, which does not depend on the container.\r\n\r\n **Static File Path Handling Fix**:\r\n - Fixed an issue in the  `AddStaticFiles`  method where file paths were not correctly resolved when they didn't start with  `./`  or were not absolute paths. The fix ensures that the correct file path is registered for static file serving.\r\n",
+    "date": "2024-11-27T12:51:45Z",
+    "tag": "v1.28.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.28.0"
+  },
+  {
+    "body": "# Release v1.27.1\r\n\r\n##  🛠️ Fixes\r\n### Fix Google Pubsub Panic\r\nThe callback function for the Google client Subscribe function was configured to fetch one message per Subscribe call. Still, at times the message was being sent to a closed channel causing unexpected behaviour. Fixed the issue of receiving messages on a channel that closes only on application shutdown.",
+    "date": "2024-11-17T04:50:30Z",
+    "tag": "v1.27.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.27.1"
+  },
+  {
+    "body": "# Release v1.27.0\r\n\r\n## ✨ Features\r\n  \r\n1.  **`UseMiddlewareWithContainer`  for Custom Middleware with Container Access**  \r\n    Introduced the  `UseMiddlewareWithContainer`  method, which allows custom middleware to access the application's container. This provides access to essential services such as logging, configuration, and database instances, enabling middleware to modify request processing dynamically.\r\n    \r\n    **Example Usage:**\r\n    \r\n    ```go\r\n    import (\r\n        \"fmt\"\r\n        \"net/http\"\r\n    \r\n        \"gofr.dev/pkg/gofr\"\r\n        \"gofr.dev/pkg/gofr/container\"\r\n    )\r\n    \r\n    func main() {\r\n        // Create a new GoFr application instance\r\n        a := gofr.New()\r\n    \r\n        // Add custom middleware with container access\r\n        a.UseMiddlewareWithContainer(customMiddleware)\r\n    \r\n       ....\r\n    }\r\n    \r\n    // Define middleware with container access\r\n    func customMiddleware(c *container.Container, handler http.Handler) http.Handler {\r\n        return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {\r\n            c.Logger.Log(\"Hey! Welcome to GoFr\")\r\n            handler.ServeHTTP(w, r)\r\n        })\r\n    }\r\n    ` \r\n    \r\n 2.  **Migrations Support in MongoDB**  \r\n   GoFr now introduces support for data migrations in MongoDB, enabling seamless modifications to your database schema and data. This includes adding new fields, modifying data types of existing fields, setting or removing indexes, and applying constraints to collections. All changes are meticulously tracked in the GoFr Migrations Table, ensuring a reliable and auditable history of database updates.\r\n----------\r\n\r\n## 🛠️ Fixes\r\n\r\n1.  **Remote Log URL Setup**  \r\n    Resolved an issue where logs fetched from the remote log URL were missing correlation IDs. Logs now consistently include the correlation ID, ensuring better traceability.\r\n    \r\n2.  **Entity DataType Documentation Update**  \r\n    Enhanced the documentation for the  `Add-rest-handler`  feature by specifying supported data types in the entity structure, improving usability and reducing confusion.\r\n    \r\n3.  **SQL Logs Level Adjustment**  \r\n    Fixed the log level for successful SQL connections, which was mistakenly set to debug. It is now appropriately logged at the info level, aligning with logging best practices.\r\n\r\n\r\n",
+    "date": "2024-11-15T11:33:55Z",
+    "tag": "v1.27.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.27.0"
+  },
+  {
+    "body": "# Release v1.26.0\r\n\r\n## ✨ Features\r\n\r\n### 1. Support for NATS as External Pub-Sub\r\n\r\nWe have added support for NATS as an external pub/sub service in GoFr. Users can now easily set up NATS for message publishing and subscribing by configuring it via `app.AddPubSub`. Here’s a quick example:\r\n\r\n```go\r\napp.AddPubSub(nats.New(&nats.Config{\r\n    Server:    \"nats://localhost:4222\",\r\n    CredsFile: \"\",\r\n    Stream: nats.StreamConfig{\r\n        Stream:   \"my-stream\",\r\n        Subjects: []string{\"order-logs\", \"products\"},\r\n    },\r\n    MaxWait:     5 * time.Second,\r\n    MaxPullWait: 500,\r\n    Consumer:    \"my-consumer\",\r\n}, app.Logger()))\r\n\r\n```\r\n\r\nTo inject NATS, import it using the following command:\r\n\r\n```go\r\ngo get gofr.dev/pkg/gofr/datasources/pubsub/nats\r\n```\r\n\r\nRefer to our documentation for detailed setup instructions.\r\n\r\n### 2.  New Environment Variable `DB_CHARSET`\r\n\r\nIntroduced a new environment variable `DB_CHARSET` to make the **MySQL character set configurable**. By default, DB_CHARSET is set to **utf8**. However, setting it to **utf8mb4** is recommended for full Unicode support, including emojis and special characters.\r\n\r\n### 3. Enhanced CLI with TUI Elements (Spinners and Progress Bar)\r\n\r\nThis release enhances the GoFr command-line experience by introducing Text User Interface (TUI) elements, including spinners and a progress bar for visual feedback during command execution. \r\n\r\nCheck out an example in `examples/sample-cmd` to see this in action.\r\n\r\n### 4. New Examples for Remote File Server Interaction\r\n\r\nWe’ve added new examples in the `examples/using-add-filestore` directory, demonstrating how to interact with remote file servers using GoFr. This addition provides a convenient reference for developers working with remote file management.\r\n\r\n---\r\n\r\n## 🛠️ Fixes\r\n\r\n### 1. Fix: Invalid ClickHouse Documentation\r\n\r\nUpdated the ClickHouse package documentation to highlight only the relevant parts, improving readability and maintainability.\r\n",
+    "date": "2024-11-07T09:14:22Z",
+    "tag": "v1.26.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.26.0"
+  },
+  {
+    "body": "# Release v1.25.0 \r\n\r\n## ✨ Features\r\n\r\n### BadgerDB Tracing\r\n- Added context support and tracing for **BadgerDB** datasource operations, enhancing observability and tracking within the BadgerDB storage layer.(Released pkg/gofr/datasource/kv-store/badger - v0.2.0)\r\n\r\n### Redis Authentication Support\r\n- Users can now connect to Redis instances requiring a username, password, or both. Configure these credentials in the `.env` file located in the `configs` folder:\r\n\r\n  - **`REDIS_USER`**: User credential for connecting to the Redis server. Multiple users with different permissions can be configured within a single Redis instance. For more details, refer to the [official Redis documentation](https://redis.io/docs/latest/operate/oss_and_stack/management/security/acl/).\r\n  \r\n  - **`REDIS_PASSWORD`**: Password credential required only if authentication is enabled on the Redis instance.\r\n\r\n### Enhanced Authentication Retrieval in Context\r\n- The `GetAuthInfo` method on the context provides easy access to various authentication methods, allowing developers to retrieve:\r\n\r\n  - **JWT Claims**: Use `GetAuthInfo().GetClaims()` when OAuth is enabled, returning a `jwt.MapClaims` response.\r\n  \r\n  - **Username**: Use `GetAuthInfo().GetUsername()` for basic authentication, returning the username or an empty string if basic auth is not enabled.\r\n  \r\n  - **API Key**: Use `GetAuthInfo().GetAPIKey()` for API key-based authentication, returning the API key or an empty string if API key auth is not enabled.\r\n\r\n---\r\n\r\n## 🛠️ Fixes\r\n\r\n### Static File Route Issue\r\n- Resolved a bug in the `AddStaticFiles` method where static files could not be accessed via specified routes. Now, running the following code:\r\n\r\n  ```go\r\n  func main() {\r\n      app := gofr.New()\r\n      app.AddStaticFiles(\"/\", \"./static\")\r\n      app.Run()\r\n  }\r\n  ```\r\n\r\n  Files within the `./static` directory can be accessed properly, e.g., `http://localhost:9000/abc.jpeg`, without encountering a \"route not registered\" error.\r\n\r\n### Controlled Access to OpenAPI Files\r\n- Prevented direct access to the `openapi.json` file via static routes. The file is now restricted to access through explicitly defined routes such as `/.well-known/swagger` or `/.well-known/openapi.json` for secure and controlled API documentation access.\r\n",
+    "date": "2024-11-04T11:01:14Z",
+    "tag": "v1.25.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.25.0"
+  },
+  {
+    "body": "# Release v1.24.2\r\n\r\n## 🛠️ Fixes\r\n- **Tracing in Solr data source**\r\nFixed missing tracing for Solr data source. Now, spans for Solr data source will be visible on the trace graph with important attributes to better debug the user application.\r\n\r\n- **Cassandra logs misaligned**\r\nThe logs while running the migrations for the Cassandra database were misaligned and did not contain the exact operation that was being performed. Now logs are aligned with the other logs and also contain which operation is being performed.\r\n\r\n- **EventHub messages not getting consumed**\r\nThe Azure EventHub was not able to subscribe to the messages, fixed the flow to correctly consume the messages, and also added proper shutdown for the subscriber to close on application closure.\r\n\r\n- **Application Shutdown not working when subscribers are registered**\r\nNow gofr applications will shutdown gracefully without getting stuck because of the forever subscription for topics.\r\n\r\n\r\n**Full Changelog**: https://github.com/gofr-dev/gofr/compare/v1.24.1...v1.24.2",
+    "date": "2024-10-22T12:19:59Z",
+    "tag": "v1.24.2",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.24.2"
+  },
+  {
+    "body": "# Release v1.24.1\r\n\r\n## 🛠️ Fixes:\r\n- **Google Subscriptions not calling user handlers**\r\nFixed a bug in the Google subscriber where messages were being consumed in the callback handler but was not calling the `SubscribeFunc` registered by the user.",
+    "date": "2024-10-17T14:21:07Z",
+    "tag": "v1.24.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.24.1"
+  },
+  {
+    "body": "# Release v1.24.0\r\n\r\n\r\n## ✨ Features:\r\n\r\n- **Cassandra Tracing & Context Support**:  \r\n  We’ve added context support and tracing for Cassandra operations, improving flexibility and observability. The following methods are now available:\r\n\r\n  **Single Operations:**\r\n  - **`QueryWithCtx`**: Executes queries with context, binding results to the specified destination.\r\n  - **`ExecWithCtx`**: Executes non-query operations with context.\r\n  - **`ExecCASWithCtx`**: Executes lightweight (CAS) transactions with context.\r\n  - **`NewBatchWithCtx`**: Initializes a new batch operation with context.\r\n\r\n  **Batch Operations:**\r\n  - **`BatchQueryWithCtx`**: Adds queries to batch operations with context.\r\n  - **`ExecuteBatchWithCtx`**: Executes batch operations with context.\r\n  - **`ExecuteBatchCASWithCtx`**: Executes batch operations with context and returns the result.\r\n\r\n  ***Note:*** The following methods in Cassandra have been deprecated:\r\n  ```go\r\n  type Cassandra interface {\r\n      Query(dest interface{}, stmt string, values ...any) error\r\n      Exec(stmt string, values ...any) error\r\n      ExecCAS(dest any, stmt string, values ...any) (bool, error)\r\n      BatchQuery(stmt string, values ...any) error\r\n      NewBatch(name string, batchType int) error\r\n      CassandraBatch\r\n  }\r\n\r\n  type CassandraBatch interface {\r\n      BatchQuery(name, stmt string, values ...any)\r\n      ExecuteBatch(name string) error\r\n      ExecuteBatchCAS(name string, dest ...any) (bool, error)\r\n  }\r\n  ```\r\n\r\n\r\n- **JWT Claims Retrieval**:  \r\n  OAuth-enabled applications can now retrieve JWT claims directly within handlers. Here’s an example:\r\n  ```go\r\n  func HelloHandler(c *gofr.Context) (interface{}, error) {\r\n      // Retrieve the JWT claim from the context\r\n      claimData := c.Context.Value(middleware.JWTClaim)\r\n\r\n      // Assert that the claimData is of type jwt.MapClaims\r\n      claims, ok := claimData.(jwt.MapClaims)\r\n      if !ok {\r\n          return nil, fmt.Errorf(\"invalid claim data type\")\r\n      }\r\n\r\n      // Return the claims as a response\r\n      return claims, nil\r\n  }\r\n  ```\r\n\r\n## 🛠️ Fixes:\r\n\r\n- **Redis Panic Handling**:  \r\n  Resolved an issue where calling `Redis.Ping()` without an active connection caused the application to panic. This is now handled gracefully.\r\n\r\n- **Docker Example Enhancement**:  \r\n  The `http-server` example has been enhanced to include Prometheus and Grafana containers in its Docker setup, allowing users to fully explore GoFr's observability features.\r\n",
+    "date": "2024-10-14T12:24:50Z",
+    "tag": "v1.24.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.24.0"
+  },
+  {
+    "body": "# Release v1.23.0 \r\n\r\n## ✨Features:\r\n- **Tracing support added for MongoDB database:**  \r\n  Added tracing capabilities for MongoDB database interactions, extending built-in tracing support across various MongoDB methods.\r\n  \r\n- **Support for binding encoded forms:**  \r\n  Added functionality for binding multipart-form data and URL-encoded form data.  \r\n  - You can use the `Bind` method to map form fields to struct fields by tagging them appropriately.   \r\n  - For more details, visit the [documentation](https://gofr.dev/docs/references/context).\r\n\r\n## 🛠️Fixes:\r\n- **Resolved nil correlationID due to uninitialized exporter:**  \r\nAddressed an issue that emerged from release [v1.22.0](https://github.com/gofr-dev/gofr/releases/tag/v1.22.0), where the trace exporter and provider were not initialized when no configurations were specified. The isssue has been fixed. The trace provider is now set to initialize by default, regardless of the provided configuration.\r\n  \r\n  \r\n  \r\n",
+    "date": "2024-10-07T07:24:30Z",
+    "tag": "v1.23.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.23.0"
+  },
+  {
+    "body": "# Release v1.22.1\r\n\r\n## ✨ Fixes\r\n- Fix clickhouse Import\r\nImporting clickhouse import was failing in version 1.22.0, due to otel tracer package present as indirect dependency.",
+    "date": "2024-10-03T07:22:59Z",
+    "tag": "v1.22.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.22.1"
+  },
+  {
+    "body": "# Release v1.22.0\r\n\r\n## ✨ Features\r\n- Support for tracing in clickhouse.\r\nClickhouse Traces are now added and sent along with the respective request traces.\r\n\r\n-  Support for sampling traces.\r\nTraces can now be sampled based on the env config `TRACER_RATIO` \r\nIt refers to the proportion of traces that are exported through sampling. It ranges between 0 to 1. By default, this ratio is set to 1, meaning all traces are exported.\r\n\r\n-  Support Azure Eventhub as external pub-sub datasource.\r\nEventhub\r\n\t- Eventhub can be used similar to how messages are published and subscribed to KAFKA, MQTT and Google Pubsub.\r\n\t- To inject Eventhub import it using the following command.\r\n\t   ```\r\n\t   go get gofr.dev/pkg/gofr/datasources/pubsub/eventhub\r\n\t   ```\r\n   - Setup Eventhub by calling the AddPubSub method of gofr.\r\n\t   ```\r\n\t   app.AddPubSub(eventhub.New(eventhub.Config{  \r\n\t\tConnectionString: \"\",  \r\n\t\tContainerConnectionString: \"\",  \r\n\t\tStorageServiceURL: \"\",  \r\n\t\tStorageContainerName: \"\",  \r\n\t\tEventhubName: \"\",  \r\n\t\tConsumerGroup: \"\",  \r\n\t\t}))\r\n\t\t```\r\n\tRefer [documentation](https://gofr.dev/docs/advanced-guide/using-publisher-subscriber) to know how to get these values.\r\n\r\n- Support to enable HTTPS in the HTTP server\r\nYou can now secure your servers with SSL/TLS certificates by adding the certificates through following configs - `CERT_FILE` and `KEY_FILE`.\r\n\r\n## ✨ Fixes\r\n- Fix SQLite logs.\r\n\tEmpty strings were coming due to difference in configuration parameters required in SQLite vs other SQL datasource when connecting which has been fixed.",
+    "date": "2024-10-01T11:00:45Z",
+    "tag": "v1.22.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.22.0"
+  },
+  {
+    "body": "# Release v1.21.0\r\n\r\n## ✨ Features\r\n- ### Support for DGraph\r\n     Dgraph can be added using the method on gofrApp AddDgraph.\r\n     Following methods are supported:\r\n```go\r\n// Dgraph defines the methods for interacting with a Dgraph database.\r\n\r\ntype Dgraph interface {\r\n// Query executes a read-only query in the Dgraph database and returns the result.\r\nQuery(ctx context.Context, query string) (interface{}, error)\r\n\r\n// QueryWithVars executes a read-only query with variables in the Dgraph database.\r\nQueryWithVars(ctx context.Context, query string, vars map[string]string) (interface{}, error)\r\n\r\n// Mutate executes a write operation (mutation) in the Dgraph database and returns the result.\r\nMutate(ctx context.Context, mu interface{}) (interface{}, error)\r\n\r\n// Alter applies schema or other changes to the Dgraph database.\r\nAlter(ctx context.Context, op interface{}) error\r\n\r\n// NewTxn creates a new transaction (read-write) for interacting with the Dgraph database.\r\nNewTxn() interface{}\r\n\r\n// NewReadOnlyTxn creates a new read-only transaction for querying the Dgraph database.\r\nNewReadOnlyTxn() interface{}\r\n\r\n// HealthChecker checks the health of the Dgraph instance.\r\nHealthChecker\r\n}\r\n```\r\nTo use Dgraph in your GoFr application, follow the steps given below:\r\n#### Step 1\r\n`go get gofr.dev/pkg/gofr/datasource/dgraph`\r\n\r\n #### Step 2\r\n ```\r\napp.AddDgraph(dgraph.New(dgraph.Config{\r\nHost: \"localhost\",\r\nPort: \"8080\",\r\n}))\r\n```\r\nGoFr supports both queries and mutations in Dgraph. To know more: [Read the Docs](https://gofr.dev/docs/advanced-guide/injecting-databases-drivers)\r\n\r\n## 🛠 Enhancements\r\n- ### Migrations in Cassandra\r\n   Users can now add migrations while using `Cassandra` as the datasource. This enhancement assumes that user  has  already  created the `KEYSPACE` in cassandra. A `KEYSPACE` in Cassandra is a container for tables that defines data replication settings across  the  cluster. [Visit the Docs](https://gofr.dev/docs/advanced-guide/handling-data-migrations) to know more.\r\n\r\n```\r\ntype Cassandra interface {\r\n    Exec(query string, args ...interface{}) error\r\n    NewBatch(name string, batchType int) error\r\n    BatchQuery(name, stmt string, values ...any) error\r\n    ExecuteBatch(name string) error\r\n        HealthCheck(ctx context.Context) (any, error)\r\n}\r\n```\r\nTo achieve atomicity during migrations, users can leverage batch operations using the NewBatch, BatchQuery, and ExecuteBatch methods. These methods allow multiple queries to be executed as a single atomic operation.\r\n\r\nWhen using batch operations, consider using batchType: LoggedBatch i.e. 0 for atomicity or an UnloggedBatch  i.e. 1 for improved performance where atomicity isn't required. This approach provides a way to maintain data consistency during complex migrations. \r\n\r\n-  ### Added mocks for Metrics  \r\n    `MockContainer` can be used to set expectation for metrics in the application while writing test.\r\n    \r\n    #### Usage:\r\n    ```\r\n        // GoFr's mockContainer\r\n        _, mock := NewMockContainer(t)  \r\n      \r\n        // Set mock expectations using the mocks from NewMockContainer\r\n        mock.Metrics.EXPECT().IncrementCounter(context.Background(), \"name\")\r\n      \r\n        // Call to your function where metrics has to be mocked\r\n        .\r\n        .\r\n        .\r\n    \r\n    ```\r\n",
+    "date": "2024-09-23T12:21:03Z",
+    "tag": "v1.21.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.21.0"
+  },
+  {
+    "body": "# Release v1.20.0\r\n\r\n## ✨ Features\r\n- Support for Solr\r\nSolr can now be used as a datasource, for adding Solr use `AddSolr(cfg Solr.Config)` method of gofrApp.\r\nRefer [documentation](https://github.com/gofr-dev/gofr/blob/development/docs/advanced-guide/injecting-databases-drivers/page.md#solr) for detailed info.\r\nSupported Functionalities are:\r\n\t```\r\n\tSearch(ctx context.Context, collection string, params map[string]any) (any, error)  \r\n\tCreate(ctx context.Context, collection string, document *bytes.Buffer, params map[string]any) (any, error)  \r\n\tUpdate(ctx context.Context, collection string, document *bytes.Buffer, params map[string]any) (any, error)  \r\n\tDelete(ctx context.Context, collection string, document *bytes.Buffer, params map[string]any) (any, error)  \r\n\t  \r\n\tRetrieve(ctx context.Context, collection string, params map[string]any) (any, error)  \r\n\tListFields(ctx context.Context, collection string, params map[string]any) (any, error)  \r\n\tAddField(ctx context.Context, collection string, document *bytes.Buffer) (any, error)  \r\n\tUpdateField(ctx context.Context, collection string, document *bytes.Buffer) (any, error)  \r\n\tDeleteField(ctx context.Context, collection string, document *bytes.Buffer) (any, error)\r\n\t```\r\n\r\n## 🛠 Enhancements\r\n- Added mocks for HTTP Service\r\nMocks to test GoFr HTTP client had to be generated manually. Now, mocks for the HTTP service has been added in GoFr's `MockContainer`.\r\n    ### Usage:\r\n    ```\r\n        // register HTTP services to be mocked\r\n        httpservices := []string{\"cat-facts\", \"cat-facts1\", \"cat-facts2\"}  \r\n      \r\n        // pass the httpservices in NewMockContainer\r\n        _, mock := NewMockContainer(t, WithMockHTTPService(httpservices...))  \r\n      \r\n        // Set mock expectations using the mocks from NewMockContainer\r\n        mock.HTTPService.EXPECT().Get(context.Background(), \"fact\",map[string]interface{}{  \r\n        \"max_length\": 20,  \r\n        }).Return(result, nil)  \r\n      \r\n        // Call to your function where HTTPService has to be mocked\r\n        .\r\n        .\r\n        .\r\n    ```\r\n\r\n",
+    "date": "2024-09-16T11:34:16Z",
+    "tag": "v1.20.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.20.0"
+  },
+  {
+    "body": "# Release v1.19.1\r\n\r\n## 🛠 Enhancements\r\n- Support for S3 operations\r\nFileStore can now be initialised as S3 with the `AddFileStore` method.  \r\nSince, S3 is an external datasource, it can be imported by:  \r\n`go get gofr.dev/pkg/gofr/datasource/file/s3`\r\n\r\n\t**Example:**  \r\n`app.AddFileStore(s3.New(&s3.Config{EndPoint: \"http://localhost:4566\", BucketName: \"gofr-bucket-2\", Region: \"us-east-1\", AccessKeyID: \"test\", SecretAccessKey: \"test\"}))`\r\n\r\n\tSupported functionalities are:\r\n\t```\r\n\t Create(name string) (File, error)\r\n\t Mkdir(name string, perm os.FileMode) error\r\n\t MkdirAll(path string, perm os.FileMode) error\r\n\t Open(name string) (File, error)\r\n\t OpenFile(name string, flag int, perm os.FileMode) (File, error)\r\n\t Remove(name string) error\r\n\t RemoveAll(path string) error\r\n\t Rename(oldname, newname string) error\r\n\t ReadDir(dir string) ([]FileInfo, error)\r\n\t Stat(name string) (FileInfo, error)\r\n\t Getwd() (string, error)\r\n\t```\r\n\r\n## 🐞 Fixes\r\n- Resolved SQL mocks\r\nPreviously the mock was not able to mock Query, QueryRow, Select, Dialect, HealthCheck methods. Hence, replaced mock-gen generated SQL mocks with go-mock-sql package in the mock container.",
+    "date": "2024-09-09T12:20:50Z",
+    "tag": "v1.19.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.19.1"
+  },
+  {
+    "body": "# Release v1.19.0\r\n\r\n## ✨ Features\r\n- Support for second in cron format\r\nCron job schedules can now be more precise with an optional addition field for seconds.\r\nFormat can now be either 5 part or 6 part, denoting `second (optional), minute, hour, day_of_month, month, day_of_week`.\r\n\r\n    **Example:**\r\n  ```\r\n  // Cron job to run every 10 second\r\n  app.AddCronJob(\"*/10 * * * * *\", \"counter\", count)\r\n  // Cron job to run every 5 minute\r\n  app.AddCronJob(\"*/5 * * * *\", \"counter\", count)\r\n  ```\r\n\r\n- Support for SFTP operations\r\nFileStore can now be initialised as SFTP with the `AddFileStore` method.\r\nSince, SFTP is an external datasource, it can be imported by:\r\n`go get gofr.dev/pkg/gofr/datasource/file/sftp`\r\n\t\r\n\t**Example:**\r\n`app.AddFileStore(sftp.New(&sftp.Config{Host: \"127.0.0.1\",\r\nUser: \"user\",\r\nPassword: \"password\",\r\nPort: 22}))`\r\n\r\n\tSupported functionalities are:\r\n\t```\r\n\tCreate(name string) (File, error)\r\n\tMkdir(name string, perm os.FileMode) error\r\n\tMkdirAll(path string, perm os.FileMode) error\r\n\tOpen(name string) (File, error)\r\n\tOpenFile(name string, flag int, perm os.FileMode) (File, error)\r\n\tRemove(name string) error\r\n\tRemoveAll(path string) error\r\n\tRename(oldname, newname string) error\r\n\tReadDir(dir string) ([]FileInfo, error)\r\n\tStat(name string) (FileInfo, error)\r\n\tGetwd() (string, error)\r\n\t```\r\n        \r\n        \r\n## 🛠 Enhancements\r\n- Response with Partial Content status code\r\nIf the handler returns both data as well as error, then the status code would now be Partial Content `206`\r\n\r\n- Enhance Observability for FTP\r\nLogs formatting and structuring have been improved.\r\nA new histogram metric `app_ftp_stats` has been introduced to populate data for execution duration with labels as `type` and `status`.\r\n![Image](https://media.discordapp.net/attachments/1257270270583111700/1280116980438794315/Screenshot_2024-09-02_at_4.17.16_PM.png?ex=66d6e957&is=66d597d7&hm=ef375e196139b4c8459f4df8c64d02dc56747208ef3bc7a091155003da51413b&=&format=webp&quality=lossless&width=2160&height=196)\r\n\r\n- Logger mock methods for testing purpose\r\nTo help test the logging methods, mocks have now been generated with `mockgen`, instead of manually creating for every datasource.\r\n\r\n## 🐞 Fixes\r\n- Resolved permission issues in directories\r\nWhile creating new directory, the permissions were missing for the directory. Fixed that by providing `ModePerm` (`777`) permissions.",
+    "date": "2024-09-02T11:48:49Z",
+    "tag": "v1.19.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.19.0"
+  },
+  {
+    "body": "# Release v1.18.0\r\n\r\n## ✨ Features\r\n- SQL Tags in AddRESTHandlers\r\nThe `AddRESTHandlers` function now supports the following SQL tags for enhanced data integrity and database handling:\r\n    - `auto_increment`:\r\n        When this tag is applied to a struct field, any provided ID value will be ignored. Instead, the ID returned by the database after insertion will be used.\r\n    - `not_null`:\r\n      This tag enforces a non-null constraint at the service level, ensuring that no nil value can be sent for the specified field.\r\n      Incase nil value is sent, error will be returned.\r\n\r\n  Example:\r\n  ```go\r\n  type user struct {\r\n\t  ID \t\tint \t`json:\"id\" \tsql:\"auto_increment\"`\r\n\t  Name \tstring \t`json:\"name\" \tsql:\"not_null\"`\r\n\t  Age \tint \t`json:\"age\"`\r\n\t  IsEmployed \tbool \t`json:\"isEmployed\"`\r\n  }\r\n  ```\r\n\r\n- Added support for directory operations in FileSystem\r\nSupported functionalities are:\r\n`ChDir(dirname  string) error` - ChDir changes the current directory.\r\n`Getwd() (string, error)` - Getwd returns the path of the current directory.\r\n`ReadDir(dir  string) ([]FileInfo, error)` - ReadDir returns a list of files/directories present in the directory.\r\n`Stat(name  string) (FileInfo, error)` - Stat returns the file/directory information in the directory.\r\n\r\n## 🛠 Enhancements\r\n- Error logs for invalid configs\r\nAdded validations for `REQUEST_TIMEOUT` and `REMOTE_LOG_FETCH_INTERVAL` configs and log error if invalid.\r\n\r\n- Error logs for internal server errors\r\nPreviously, if any occurred then there was a log with just status code and correlationID.\r\nHence, added an error log with correlationID and `error message`.\r\n![image](https://github.com/user-attachments/assets/b1b4dcb5-f66e-4404-888b-ea6a369dee2d)\r\n\r\n- FileSystem mock methods for testing purpose\r\nTo help test the FileSystem methods, mocks have now been added to mock container struct which can be generated from `NewMockContainer` method.\r\n\r\n## 🐞 Fixes\r\n- Resolved application status in case of migration failure\r\nIf any occurs while running the migrations, the application will now gracefully `shutdown`.\r\n\r\n- Resolved response for error case\r\nFor an error case, where the response consists of error message only and has no data to return, then also the data field was present in output as `null`.\r\nThis has been removed now, so only error struct will be returned with respective status code.",
+    "date": "2024-08-26T07:49:39Z",
+    "tag": "v1.18.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.18.0"
+  },
+  {
+    "body": "# Release v1.17.0\r\n\r\n## ✨ Features\r\n- Added support for FTP as an external datasource\r\nFTP can be added using the method on gofrApp `AddFTP(fs file.FileSystemProvider)`\r\nSupported functionalities are:\r\n`Create(name string) (File, error)`\r\n `Mkdir(name string, perm os.FileMode) error`\r\n `MkdirAll(path string, perm os.FileMode) error`\r\n`Open(name string) (File, error)`\r\n`OpenFile(name string, flag  int, perm os.FileMode) (File, error)`\r\n`Remove(name string) error`\r\n`RemoveAll(path string) error`\r\n`Rename(oldName, newName string) error`\r\n\r\n- Cassandra now supports Batching\r\nAdded Batch functionality with newly introduced methods:\r\n`NewBatch(batchType int) error`\r\n`BatchQuery(stmt string, values ...interface{})`\r\n`ExecuteBatch() error`\r\n\r\n- Automated injection of  `gofr.Context` in the gRPC server during registering of the gRPC service\r\ngRPC can now inject gofr `container` to the `Server` struct, to access logger, datasources, and other functionalities provided by gofr.\r\nRefer to [example](https://github.com/gofr-dev/gofr/blob/development/examples/grpc-server/grpc/server.go) for detailed info.\r\n\r\n## 🛠 Enhancements\r\n- Messages can now be written to WebSocket without returning\r\nAdded method on gofrContext `WriteMessageToSocket(data any) error` to write a message.\r\n\r\n## 🐞 Fixes\r\n- Resolved panic for EnableBasicAuth\r\nIf an odd no. of arguments (user, password) were passed to the `EnableBasicAuth` method, the app panicked. Fixed this issue, user and password can be passed in the method as comma-separated pairs like:\r\n`EnableBasicAuth(user1, pass1, user2, pass2)`\r\n\r\n- Resolved authentication for EnableBasicAuth\r\nEven if the credentials were correct, the app was returning the `401` status Unauthorised instead of the expected `200`.\r\n\r\n- Fixed unstructured log in Mongo\r\nDebug query logs were not properly formatted for Mongo, fixed the formatting.\r\nThe `message` field in logs was `string` type, updated it to `object`",
+    "date": "2024-08-12T09:23:23Z",
+    "tag": "v1.17.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.17.0"
+  },
+  {
+    "body": "# Release v1.16.1\r\n\r\n## 🐞 Fixes\r\n- Resolved DB migrations panic in logging\r\nApp was panicking while logging with migrations datasource, as the logger was `nil`. Now, populated the logger, hence fixing the panic.\r\n- Removed unexpected error log for tracing when it was not enabled from configs\r\n`{\"level\":\"ERROR\",\"time\":\"2024-08-06T17:47:56.714963+05:30\",\"message\":\"unsupported TRACE_EXPORTER: \",\"gofrVersion\":\"v1.16.0\"}`\r\nThe above log was printed when tracing configs (TRACE_EXPORTER, TRACER_URL) weren't provided, and since tracing is optional feature, removed error log if configs aren't given.",
+    "date": "2024-08-06T15:17:24Z",
+    "tag": "v1.16.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.16.1"
+  },
+  {
+    "body": "# Release v1.16.0\r\n\r\n## ✨ Features\r\n- Application will now gracefully shutdown to prevent data loss during application termination\r\nAll the processes (go-routines) will be awaited to finish before shutting down. Currently, the timeout for shutdown is `30 seconds`. Will be making it configurable in upcoming release.\r\n\r\n- Enhanced query parameter handling to support multiple values\r\nPreviously, only a single value was supported for query params with `Param(key string) string` method. Now, added another method `Params(key string) []string` which returns array of values passed for given query param.\r\nExample:\r\n  ```\r\n  If URL is \r\n   - http://order-service/orders?id=123,234\r\n   - http://order-service/orders?id=123&id=234\r\n   \r\n  Then ctx.Params(\"id\") will return [\"123\", \"234\"]\r\n  ```\r\n\r\n- Enhanced security with SSL support for PostgreSQL connections\r\nDefault certificates can now be used as SSL, by configuring `DB_SSL_MODE` as `require`.\r\nCurrently this is only supported with PostgreSQL. Custom certificates and other DBs will be supported in future releases.\r\n\r\n## 🛠 Enhancements\r\n- Improved logging for tracer configs validation\r\nTracing is only enabled when `both` TRACE_EXPORTER and TRACER_URL are provided, so added error logs if any one of them is provided and the other is missing.\r\n\r\n  <img width=\"799\" alt=\"Screenshot 2024-08-05 at 12 24 53 PM\" src=\"https://github.com/user-attachments/assets/5b202376-a71a-4044-87bf-b04330d5898a\">\r\n\r\n  <img width=\"797\" alt=\"Screenshot 2024-08-05 at 12 27 58 PM\" src=\"https://github.com/user-attachments/assets/7519fb7a-cb0c-4e9c-b67b-38e8281cf8e7\">\r\n\r\n- Improved tracing with OpenTelemetry protocol integration\r\nTracing can now be configured as otel protocol by configuring `TRACE_EXPORTER` as `otlp`, and providing `TRACER_URL`.\r\n\r\n## 🐞 Fixes\r\n- Resolved panic caused by passing non-pointer objects in AddRESTHandlers method\r\nApp was panicking while initialising if the argument is passed by value to `AddRESTHandlers` method. Since, the method only accepts arguments passed by reference, added validations and error log instead of panic.",
+    "date": "2024-08-05T07:01:14Z",
+    "tag": "v1.16.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.16.0"
+  },
+  {
+    "body": "# Release v1.15.0\r\n\r\n## ✨ Features\r\n- Add support for BadgerDB as key value store. (#835) \r\n\r\n## 🛠 Enhancements\r\n- Fail app start in case of error in config file. (#854)\r\n- Add validations for tracer configs and log errors. (#859)\r\n\r\n#### Changelog: https://github.com/gofr-dev/gofr/compare/v1.14.1...v1.15.0",
+    "date": "2024-07-22T09:09:18Z",
+    "tag": "v1.15.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.15.0"
+  },
+  {
+    "body": "# Release v1.14.1\r\n\r\n## 🐞 Fixes\r\n- Fix fatal log methods (#842)\r\n\r\n#### Changelog: https://github.com/gofr-dev/gofr/compare/v1.14.0...v1.14.1",
+    "date": "2024-07-12T12:21:25Z",
+    "tag": "v1.14.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.14.1"
+  },
+  {
+    "body": "## This version contains breaking changes, please use [v1.14.1](https://github.com/gofr-dev/gofr/releases/tag/v1.14.1)\r\n\r\n# Release v1.14.0\r\n\r\n## ✨ Features\r\n- Add support for auth header for tracer exporter (#828)\r\nAuthorization header can be passed for tracer using `TRACER_AUTH_KEY` config\r\n\r\n- Add support for custom tracer URL (#834)\r\nTraces can now be posted to custom URL provided in `TRACER_URL` config\r\n\r\n**NOTE**: `TRACER_HOST` and `TRACER_PORT` are now deprecated, use `TRACER_URL` instead.\r\n\r\n#### Changelog: https://github.com/gofr-dev/gofr/compare/v1.13.0...v1.14.0",
+    "date": "2024-07-12T10:47:52Z",
+    "tag": "v1.14.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.14.0"
+  },
+  {
+    "body": "## ✨ Features\r\n- Add support for profilling endpoints. (#774)\r\n- Add support for MQTT_KEEP_ALIVE. (#771)\r\n- Support transactions in MongoDB driver. (#779) \r\n- Add support for retry of failing downstream calls. (#778) \r\n\r\n## 🐞 Fixes\r\n- Fix MQTT messages being lost due to connection loss. (#771)\r\n- Fix request timeout for health check calls. (#777)\r\n- Fix dependent integration test in pub-sub example. (#784)\r\n- Fix MQTT tests using mock Client and mock Token. (#791)\r\n\r\n**Changelog**: https://github.com/gofr-dev/gofr/compare/v1.12.0...v1.13.0",
+    "date": "2024-07-08T10:18:53Z",
+    "tag": "v1.13.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.13.0"
+  },
+  {
+    "body": "# Release v1.12.0\r\n\r\n## ✨ Features\r\n- Add support of migrations for ClickHouse DB. (#750)\r\n- Add support for serving static files. (#674)\r\n- Add support of mocks for external datasources. (#749)\r\n\r\n## 🛠 Enhancements\r\n- Update GO version to `v1.22` (#741)\r\n**NOTE**: Starting this version, supported GO versions are >= `v1.21`\r\n\r\n## 🐞 Fixes\r\n- Fix response of remote logging service. (#770)\r\n- Fix nil metrics issue for error cases. (#761)\r\n- Fix go.mod for examples. (#767)\r\n\r\n#### Changelog: https://github.com/gofr-dev/gofr/compare/v1.11.0...v1.12.0",
+    "date": "2024-06-28T11:53:32Z",
+    "tag": "v1.12.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.12.0"
+  },
+  {
+    "body": "# Release v1.11.0\r\n\r\n## ✨ Features\r\n- Support for container in Auth Middlewares. (#738)\r\n\r\n## 🐞 Fixes\r\n- Fix `app_http_service_response` metric population for error case. (#743)\r\n- Add configs for idle and max open connections. (#739)\r\n- Add logging methods in migrations logger. (#727)\r\n\r\n#### Changelog: https://github.com/gofr-dev/gofr/compare/v1.10.0...v1.11.0",
+    "date": "2024-06-21T11:11:06Z",
+    "tag": "v1.11.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.11.0"
+  },
+  {
+    "body": "# Release v1.10.0\r\n\r\n## ✨ Features\r\n- Support for WebSocket connections. (#692)\r\n- Add support to read form-data of type TEXT. (#718)\r\n- Add support for `StatusAccepted` response for POST endpoints. (#730)\r\n- Add support for ClickhouseDB. (#736)\r\n\r\n## 🐞 Fixes\r\n- Fix CMD responses followed by `%`. (#697)\r\n- Add missing health details in app health-check. (#706)\r\n- Fix request timeout response in text to JSON. (#716)\r\n- Fix the help option in CMD sub-commands. (#715)\r\n- Fix panic recovery for HTTP request. (#720)\r\n- Make Span logs descriptive by adding error origin. (#710)\r\n- Add mock metrics being used by framework by default in MockSQL. (#707)\r\n\r\n#### Changelog: https://github.com/gofr-dev/gofr/compare/v1.9.0...v1.10.0",
+    "date": "2024-06-18T11:12:50Z",
+    "tag": "v1.10.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.10.0"
+  },
+  {
+    "body": "# Release v1.9.0\r\n## ✨ Features\r\n- Support for CASSANDRA as an external DB. (#654)\r\n- Support for local filestore. (#695)\r\n- Default Support for `--help` and `-h` for CMD applications to show help command. (#661)\r\n\r\n## 🐞 Fixes\r\n- Improve logging for SQL DB. (#655)\r\n- Fix Request timeout logs. (#699)\r\n\r\n#### Changelog: https://github.com/gofr-dev/gofr/compare/v1.8.1...v1.9.0",
+    "date": "2024-06-11T05:14:59Z",
+    "tag": "v1.9.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.9.0"
+  },
+  {
+    "body": "# Release v1.8.1\r\n\r\n## 🐞 Fixes\r\n- Added missing QueryContext method in sql (https://github.com/gofr-dev/gofr/pull/671)\r\n- Bind consumes pub sub messages into `int`, `bool`, `string` and `float64`. (https://github.com/gofr-dev/gofr/pull/670)\r\n- Added entity already exists error (https://github.com/gofr-dev/gofr/pull/676)\r\n- Allow to change CORS headers using configs (https://github.com/gofr-dev/gofr/pull/669)\r\n- Fixed response and tracing in trace handler for [http-server](https://github.com/gofr-dev/gofr/blob/main/examples/http-server/main.go) example (https://github.com/gofr-dev/gofr/pull/684) (https://github.com/gofr-dev/gofr/pull/687)\r\n- Fixed misaligned terminal logs (https://github.com/gofr-dev/gofr/pull/688)\r\n\r\n\r\n**Full Changelog**: https://github.com/gofr-dev/gofr/compare/v1.8.0...v1.8.1",
+    "date": "2024-06-05T11:44:31Z",
+    "tag": "v1.8.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.8.1"
+  },
+  {
+    "body": "# Release v1.8.0\r\n\r\n## ✨ Features\r\n- Added support to set table name and rest path in REST handlers. (#648)\r\n\r\n## 🐞 Fixes\r\n- Fixed OAuth call before refresh interval in case of error. (#665)\r\n\r\n#### Change log : https://github.com/gofr-dev/gofr/compare/v1.7.0...v1.8.0",
+    "date": "2024-05-28T12:41:11Z",
+    "tag": "v1.8.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.8.0"
+  },
+  {
+    "body": "# Release v1.7.0\r\n\r\n## ✨ Features\r\n- Added observability support for MongoDB. (#616)\r\n- Enhanced metrics for datasources. (#630)\r\n- Added support for custom headers for HTTP client. (#611)\r\n- Added support for `REQUEST_TIMEOUT` for HTTP, with default value of 5 sec. (#628)\r\n- Added Kafka producer batch configurations. (#631)\r\n- Added support for SQLite datasource. (#646)\r\n- Added pre-defined errors, and support for custom errors. (#604)\r\n- Introduced Mongo package as a sub package in datasources. (#627)\r\n\r\n## 🐞 Fixes\r\n- Fixed formatting for service call logs. (#615)\r\n- Fixed formatting for Kafka logs. (#618)\r\n- Fixed log level for internal server error logs. (#625)\r\n- Improved datasource logs and added debug logs. (#632)\r\n\r\n**NOTE: UseMongo() is deprecated in this version, and will be removed in the upcoming versions. Please use AddMongo() instead.**\r\n\r\n#### Change log : https://github.com/gofr-dev/gofr/compare/v1.6.1...v1.7.0",
+    "date": "2024-05-27T06:37:46Z",
+    "tag": "v1.7.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.7.0"
+  },
+  {
+    "body": "# Release v1.6.1\r\n\r\n## 🐞 Fixes\r\n- Added missing `PATCH` route registration. (#598)(#602)\r\n- Fixed `X-API-KEY` based auth for http service. (#612)\r\n\r\n#### Change log : https://github.com/gofr-dev/gofr/compare/v1.6.0...v1.6.1",
+    "date": "2024-05-14T09:32:42Z",
+    "tag": "v1.6.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.6.1"
+  },
+  {
+    "body": "# Release v1.6.0\r\n\r\n## ✨ Features\r\n- Added support for SQL Keywords for CRUDHandlers. (#566)\r\n- Added support for custom favicon.ico. (#571)\r\n- Added support for cron job scheduling. (#592)\r\n- Added support for swagger endpoints. (#594)\r\n\r\n## 🐞 Fixes\r\n- Updated `CONSUMER_ID` to optional when publishing. (#581)\r\n- Moved MockLogger from `testutil` to `logging` package. (#582)\r\n- Fixed access to DB in Kafka consumers. (#585)\r\n\r\n#### Change log : https://github.com/gofr-dev/gofr/compare/v1.5.0...v1.6.0",
+    "date": "2024-05-12T09:00:55Z",
+    "tag": "v1.6.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.6.0"
+  },
+  {
+    "body": "# Release v1.5.0\r\n\r\n## ✨ Features\r\n- Added support of postgreSQL for AddRESTHandlers. (#549)\r\n- Added support for custom middlewares. (#554)\r\n\r\n## 🐞 Fixes\r\n- Fixed logs structuring for PubSub. (#539)\r\n\r\n\r\n#### Change log : https://github.com/gofr-dev/gofr/compare/v1.4.0...v1.5.0",
+    "date": "2024-05-03T04:02:42Z",
+    "tag": "v1.5.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.5.0"
+  },
+  {
+    "body": "# Release v1.4.1\r\n\r\n## 🐞 Fixes\r\n- Add retry for SQL connection (#530)\r\n- Add panic recovery for subscription and migrations to prevent server from crashing (#525)\r\n- Fix issue in `gofr_migrations` table creation (#531)",
+    "date": "2024-04-27T13:20:48Z",
+    "tag": "v1.4.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.4.1"
+  },
+  {
+    "body": "# Release v1.4.0\r\n\r\n## ✨ Features\r\n- Add tracing support for SQL datasource.(#462)\r\n- Remove auth for routes with prefix `/.well-known` routes.(#476)\r\n- Add support for GoFr tracer to export traces on [tracer.gofr.dev](https://tracer.gofr.dev/) (#481)\r\n- Add support for labels in gauge metrics.(#490)\r\n- Add app_info metric to push `app_name`, `app_version` and `framework_version`.(#513)\r\n\r\n## 🐞 Fixes\r\n- Change keyword basic to Basic while checking Auth header in basic Auth. (#464)\r\n- Fix buckets for redis & sql metrics to microseconds from milliseconds. (#485)\r\n- Fix env override to support `.env` should overload `.local.env` or other env files. (#491)\r\n",
+    "date": "2024-04-20T13:14:11Z",
+    "tag": "v1.4.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.4.0"
+  },
+  {
+    "body": "# Release v1.3.1\r\n\r\n## 🐞 Fixes\r\n\r\n- Fixed DockerFiles for examples (#453)\r\n- Fixed success status code for POST and DELETE (#452)\r\n- Fixed file name in documentation (#455)\r\n- Added jaeger as a valid trace exporter (#454)",
+    "date": "2024-04-10T12:33:24Z",
+    "tag": "v1.3.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.3.1"
+  },
+  {
+    "body": "# Release v1.3.0\r\n\r\n## ✨ Features\r\n\r\n- Support for APP_ENV environment variable for reading different config files based on provided value of the variable. (#403)\r\n- Add support for using external mongo DB. (#435)\r\n- Fix mismatch in ports and health check URL in documentation. (#438)\r\n- Support for adding default REST endpoints using `AddRESTEndpoints`. (#406)\r\n\r\n## 🐞 Fixes\r\n\r\n- Convert the concrete struct types to interfaces for SQL and Redis datasources in container. (#426) \r\n- Fix wait-groups in case of server-start error. (#436)\r\n- Change the time-stamp value from microseconds to milliseconds for all logs. (#410)",
+    "date": "2024-04-06T10:43:16Z",
+    "tag": "v1.3.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.3.0"
+  },
+  {
+    "body": "# Release v1.2.1\r\n\r\n## 🐞 Fixes\r\n- Added Access-Control-Allow-Headers to fix CORS issue.\r\n- Standardize log formatting and sanitize SQL and Redis queries before logging.",
+    "date": "2024-03-27T15:58:31Z",
+    "tag": "v1.2.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.2.1"
+  },
+  {
+    "body": "# Release v1.2.0\r\n\r\n## ✨ Features\r\n- Add support for binding files along with `zip` file support and `multipart.FileHeader`.\r\n- Add support for user-defined HTTP Client Options.\r\n- Add support for registering routes on PATCH method.\r\n\r\n## 🐞 Fixes\r\n- Fix missing logs for MQTT, Google PubSub and Migrations.",
+    "date": "2024-03-22T15:05:05Z",
+    "tag": "v1.2.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.2.0"
+  },
+  {
+    "body": "# Release v1.1.1\r\n\r\n## 🐞 Fixes\r\n- Add missing gofr framework version to metrics, logs, and traces",
+    "date": "2024-03-14T12:45:14Z",
+    "tag": "v1.1.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.1.1"
+  },
+  {
+    "body": "# Release v1.0.0\r\n\r\n## ✨ Features\r\n- Add Support for [Basic, Api-Key and OAuth](https://gofr.dev/docs/advanced-guide/http-authentication) authentication mechanisms.\r\n- Add support for [MQTT](https://gofr.dev/docs/advanced-guide/using-publisher-subscriber#mqtt) publish-subscribe model.\r\n\r\n**Full Changelog**: https://github.com/gofr-dev/gofr/compare/v1.0.2...v1.1.0",
+    "date": "2024-03-12T03:56:47Z",
+    "tag": "v1.1.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.1.0"
+  },
+  {
+    "body": "# Release v1.0.3\r\n\r\n## 🐞 Fixes\r\n- Fix grpc support link in readme and add the same to [gofr.dev](https://gofr.dev/docs/advanced-guide/grpc).\r\n- Add missing health check for PubSub (Google PubSub and Kafka).\r\n- Add missing migrations for PubSub (Create and Delete topics).\r\n- Fix migration panic when SQL is not initialized.",
+    "date": "2024-03-06T13:53:01Z",
+    "tag": "v1.0.3",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.0.3"
+  },
+  {
+    "body": "# Release v1.0.2\r\n\r\n## 🐞 Fixes\r\n- Fix duration for SQL query log and metrics.\r\n- Update metrics value format and histogram buckets of time duration from `seconds` to `microseconds` for following datasources:\r\n\t- **Redis**:\r\n\t\t- Previous: `{.001, .003, .005, .01, .02, .03, .05, .1, .2, .3, .5, .75, 1, 2, 3, 5, 10, 30}`\r\n\t\t- Now: `{50, 75, 100, 125, 150, 200, 300, 500, 750, 1000, 1250, 1500, 2000, 2500, 3000}`\r\n\t- **SQL**:\r\n\t\t- Previous: `{.001, .003, .005, .01, .02, .03, .05, .1, .2, .3, .5, .75, 1, 2, 3, 5, 10, 30}`\r\n\t\t- Now: `{50, 75, 100, 125, 150, 200, 300, 500, 750, 1000, 2000, 3000, 4000, 5000, 7500, 10000}`\r\n- Add missing metrics for PubSub :\r\n\t- app_pubsub_publish_total_count: Number of total publish operations.\r\n\t- app_pubsub_publish_success_count: Number of successful publish operations.\r\n\t- app_pubsub_subscribe_total_count: Number of total subscribe operations.\r\n\t- app_pubsub_subscribe_success_count: Number of successful subscribe operations.\r\n",
+    "date": "2024-03-04T12:56:04Z",
+    "tag": "v1.0.2",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.0.2"
+  },
+  {
+    "body": "# Release v1.0.1\r\n\r\n## 🐞 Fixes\r\n- Fixed content-type header for HTTP responses\r\n- Removed non-necessary logs from CMD application start",
+    "date": "2024-03-01T11:22:05Z",
+    "tag": "v1.0.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.0.1"
+  },
+  {
+    "body": "# Release v1.0.0\r\n\r\n## ✨ Features\r\n- Publisher-Subscriber support for Apache Kafka and Google PubSub.\r\n- Postgres support for the SQL database has been added, `DB_DIALECT` is the environment variable used to define which driver is used by GoFr application.\r\n- Added `REMOTE_LOG_FETCH_INTERVAL` to let the user configure log fetch interval from the remote logging service (default value is 15 seconds).\r\n- Add `ExecContext` method for SQL datasources.\r\n\r\n## 🐞 Fixes\r\n- Renamed the `DB` object to `SQL` in container and migration datasources.\r\n- Fix response message of aliveness handler to the following : \r\n`{\r\n    \"data\": {\r\n        \"status\": \"UP\"\r\n    }\r\n}`\r\n- Fix JSON keys for redis migration entry to follow camelcase.",
+    "date": "2024-02-27T11:38:15Z",
+    "tag": "v1.0.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v1.0.0"
+  },
+  {
+    "body": "# Release v0.3.0\r\n\r\n## ✨ Features\r\n- Migrations Support for MySQL and REDIS.\r\n\t\t\r\n- Metrics - The following metrics are now being pushed by default.\r\n**System Info**\r\n\t\t- app_go_routines : Number of Go routines running.\r\n\t\t- app_sys_memory_alloc : Number of bytes allocated for heap objects.\r\n\t\t- app_sys_total_alloc : Number of cumulative bytes allocated for heap objects.\r\n\t\t- app_go_numGC : Number of completed Garbage Collector cycles.\r\n\t\t- app_go_sys : Number of total bytes of memory.\r\n\r\n\t **HTTP**\r\n\t\t- app_http_response : Response time of HTTP requests in seconds.\r\n\t\t- app_http_service_response : Response time of HTTP service requests in seconds.\r\n\r\n\t **Redis**\r\n\t\t- app_redis_stats : Observes the response time for Redis commands. \r\n\t\t \r\n\t **SQL**\r\n\t\t- app_sql_stats : Histogram metric response time of HTTP requests in seconds.\r\n\t\t- app_sql_open_connections : Number of open SQL connections.\r\n\t\t- app_sql_inUse_connections : Number of inUse SQL connections.\r\n\r\n## 🐞 Fixes\r\n- Add PUT Method in circuit breaker.\r\n- Add check to handle panic when the command line application's last argument is `-`.",
+    "date": "2024-02-19T12:37:37Z",
+    "tag": "v0.3.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v0.3.0"
+  },
+  {
+    "body": "# Release v0.2.0\r\n\r\n## ✨ Features\r\n- HTTP Client for performing HTTP calls with the following options - \r\n   (These options are order-agnostic and will override specific functionalities over basic HTTP calls)\r\n    - Circuit Breaker for automatically cutting off service calls if the downstream service constantly throws 5xx.\r\n    - Health Configs for allowing custom health-check endpoints to be configured to perform health checks.\r\n    \r\n- Introduced `/.well-known/alive` default endpoint to check if the application is serving incoming requests.\r\n\r\n- Introduced formatted logging for SQL queries, Redis queries, and HTTP service calls, where data is formatted to look readable and properly formatted to make it easy for users to debug and find important logs.\r\n\r\n- Remote Log Level Change - users can provide a service URL that provides data to change the log level for the application without stopping and re-running the application.\r\n\r\n- Metrics - creating metrics and updating their values by open telemetry standards with support for the following metrics using Prometheus as an exporter and exposing these on a customizable port and `/metrics` endpoint : \r\n   - **Counter**: A  metric whose values are strictly increasing.\r\n   - **UpDownCounter**:  A metric that increases or decreases from the current value by a certain value.\r\n   - **Histogram**: A metric that samples observations (like request durations or response sizes) and counts them in configurable buckets. It also provides a sum of all observed values.\r\n   - **Gauge**: A metric representing a single numerical value that can arbitrarily go up and down, this change is not dependent on the previous value of the metric.\r\n\r\n## 🐞 Fixes\r\n- Tracing has been fixed where the traces were not in order and appeared to be in a non-hierarchal manner\r\n- Refactored the implementation and response for `/.well-known/health`",
+    "date": "2024-02-09T15:36:19Z",
+    "tag": "v0.2.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v0.2.0"
+  },
+  {
+    "body": "\r\n## What's Changed\r\n\r\n### 🔧 Features\r\n* Add querry logger for redis  by @Umang01-hash in https://github.com/gofr-dev/gofr/pull/209\r\n* Add HTTP Call methods in `new.go` for interservice calls with Logs by @aryanmehrotra in https://github.com/gofr-dev/gofr/pull/210\r\n* Add Redis Healthcheck  & Refactor Health check by @aryanmehrotra in https://github.com/gofr-dev/gofr/pull/216\r\n\r\n\r\n### 🔧  Enhancements\r\n* Add CMD unit tests by @aryanmehrotra in https://github.com/gofr-dev/gofr/pull/205\r\n* Add tests for Logger , Service pkg by @Umang01-hash in https://github.com/gofr-dev/gofr/pull/195\r\n* Increase coverage for examples, cmd, config, grpc, http by @srijan-27 in https://github.com/gofr-dev/gofr/pull/201\r\n* Add Tests for Container, Context, CMD and Database by @aryanmehrotra in https://github.com/gofr-dev/gofr/pull/189\r\n* Update branch with main in workflow by @srijan-27 in https://github.com/gofr-dev/gofr/pull/181\r\n* Add tests for db, gofr, grpc, handler and httpServer by @vipul-rawat in https://github.com/gofr-dev/gofr/pull/197\r\n* Add security, licence, code of conduct and contribution guidelines by @aryanmehrotra in https://github.com/gofr-dev/gofr/pull/188\r\n* Refactor tests for logger package by @Umang01-hash in https://github.com/gofr-dev/gofr/pull/204\r\n* Removing deprecated linter from config by @vikash\r\n* Using 256 bit color for terminal log display by @vikash\r\n* Pretty printing SQL Logs by @vikash\r\n* Restructuring SQL to add health-check structure by @vikash\r\n* Add Quick Start Docs by @Umang01-hash in https://github.com/gofr-dev/gofr/pull/220\r\n\r\n### 📦 Dependency updates\r\n* Upgrading redis library by @vikash in https://github.com/gofr-dev/gofr/pull/196\r\n* Bump github.com/DATA-DOG/go-sqlmock from 1.5.1 to 1.5.2 by @dependabot in https://github.com/gofr-dev/gofr/pull/215\r\n* Upgrade dependencies by @vipul-rawat in https://github.com/gofr-dev/gofr/pull/185\r\n* Bump golang.org/x/term from 0.0.0-20201126162022-7de9c90e9dd1 to 0.15.0 by @dependabot in https://github.com/gofr-dev/gofr/pull/178\r\n\r\n## New Contributors\r\n* @srijan-27 made their first contribution in https://github.com/gofr-dev/gofr/pull/181\r\n\r\n**Full Changelog**: https://github.com/gofr-dev/gofr/compare/v0.0.1...v0.1.0",
+    "date": "2024-01-22T12:57:55Z",
+    "tag": "v0.1.0",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v0.1.0"
+  },
+  {
+    "body": "# v0.0.1\r\n\r\nDear GoFr Community,\r\n\r\nWe're thrilled to announce that GoFr is now an open-source project, marking a new chapter in its evolution. We extend our heartfelt gratitude to all past and present contributors who've been instrumental in GoFr's development.\r\n\r\nAs part of our security measures, we've removed the complete project history, ensuring its integrity moving forward.\r\n \r\nBy making GoFr open source, we aim to foster a collaborative environment for developers of all backgrounds to innovate and enhance the project.\r\n\r\nWe invite you to explore the newly open-sourced GoFr, fork it, and contribute to its development. Your expertise is invaluable, and we look forward to new ideas and collaborative efforts.\r\n\r\nFeel free to reach out with questions, feedback, or suggestions. Thank you for your contributions and support. \r\n\r\nLet's shape GoFr's next chapter together!\r\n\r\n## Release Notes\r\n### Features\r\n\r\n- REST, gRPC server and CMD creation\r\n- Support for SQL and NoSQL Data Stores with Auto-Initialization\r\n  - **SQL**: MySQL\r\n  - **Cache** : Redis\r\n- Predefined logs with log levels for STDOUT and JSON",
+    "date": "2024-01-04T12:15:57Z",
+    "tag": "v0.0.1",
+    "url": "https://github.com/gofr-dev/gofr/releases/tag/v0.0.1"
+  }
+]
diff --git a/src/app/cli/gofr/page.jsx b/src/app/cli/gofr/page.jsx
index 8fdde1b..bd071a9 100644
--- a/src/app/cli/gofr/page.jsx
+++ b/src/app/cli/gofr/page.jsx
@@ -1,17 +1,65 @@
-import React from 'react';
+import React from 'react'
+import Link from 'next/link'
 
+export const metadata = {
+  title: 'GoFr CLI — Project Scaffolding for the Go Framework',
+  description:
+    'GoFr CLI is the command-line tool for initializing GoFr projects, generating boilerplate, and running framework-aware tasks for Go microservices.',
+  alternates: {
+    canonical: '/cli/gofr',
+  },
+}
 
 const Page = () => {
-    return (
-        <div className={`flex justify-center items-center min-h-[70vh]`}>
-            <div className={`text-4xl font-semibold flex gap-3 flex-wrap justify-center`}>
-                <span>
-                    Documentation
-                </span>
-                <span className={`text-sky-400`}>Coming Soon</span>
-            </div>
-        </div>
-    );
-};
+  return (
+    <div className="mx-auto max-w-3xl px-4 py-16 sm:px-6 lg:px-8">
+      <h1 className="font-display text-4xl font-bold tracking-tight text-slate-900 dark:text-white">
+        GoFr CLI
+      </h1>
+      <p className="mt-4 text-lg text-slate-600 dark:text-slate-400">
+        The command-line tool for initializing projects and performing tasks with the GoFr framework.
+      </p>
 
-export default Page;
\ No newline at end of file
+      <div className="mt-8 rounded-2xl bg-slate-900 p-6 shadow-lg ring-1 ring-white/10">
+        <p className="text-sm font-medium text-slate-400">Installation</p>
+        <code className="mt-2 block text-sm text-sky-300">
+          go install gofr.dev/cli/gofr@latest
+        </code>
+      </div>
+
+      <div className="mt-8 grid gap-4 sm:grid-cols-2">
+        <Link
+          href="/docs/references/gofrcli"
+          className="group relative block rounded-xl border border-slate-200 p-5 transition-all hover:border-transparent dark:border-slate-800"
+        >
+          <div className="absolute -inset-px rounded-xl border-2 border-transparent opacity-0 transition-opacity [background:linear-gradient(var(--quick-links-hover-bg,theme(colors.sky.50)),var(--quick-links-hover-bg,theme(colors.sky.50)))_padding-box,linear-gradient(to_top,theme(colors.indigo.400),theme(colors.cyan.400),theme(colors.sky.500))_border-box] group-hover:opacity-100 dark:[--quick-links-hover-bg:theme(colors.slate.800)]" />
+          <div className="relative">
+            <h3 className="font-display text-base font-medium text-slate-900 dark:text-white">
+              CLI Documentation
+            </h3>
+            <p className="mt-1 text-sm text-slate-600 dark:text-slate-400">
+              Full reference for all CLI commands and options.
+            </p>
+          </div>
+        </Link>
+        <Link
+          href="https://github.com/gofr-dev/gofr-cli"
+          target="_blank"
+          className="group relative block rounded-xl border border-slate-200 p-5 transition-all hover:border-transparent dark:border-slate-800"
+        >
+          <div className="absolute -inset-px rounded-xl border-2 border-transparent opacity-0 transition-opacity [background:linear-gradient(var(--quick-links-hover-bg,theme(colors.sky.50)),var(--quick-links-hover-bg,theme(colors.sky.50)))_padding-box,linear-gradient(to_top,theme(colors.indigo.400),theme(colors.cyan.400),theme(colors.sky.500))_border-box] group-hover:opacity-100 dark:[--quick-links-hover-bg:theme(colors.slate.800)]" />
+          <div className="relative">
+            <h3 className="font-display text-base font-medium text-slate-900 dark:text-white">
+              GitHub Repository
+            </h3>
+            <p className="mt-1 text-sm text-slate-600 dark:text-slate-400">
+              Source code, issues, and contributions.
+            </p>
+          </div>
+        </Link>
+      </div>
+    </div>
+  )
+}
+
+export default Page
diff --git a/src/app/comparison/layout.jsx b/src/app/comparison/layout.jsx
new file mode 100644
index 0000000..b9d1c77
--- /dev/null
+++ b/src/app/comparison/layout.jsx
@@ -0,0 +1,4 @@
+import { MarketingPage } from '@/components/MarketingPage'
+
+const Layout = ({ children }) => <MarketingPage>{children}</MarketingPage>
+export default Layout
diff --git a/src/app/docs/layout.jsx b/src/app/docs/layout.jsx
index a0cc982..9913d20 100644
--- a/src/app/docs/layout.jsx
+++ b/src/app/docs/layout.jsx
@@ -1,4 +1,3 @@
-'use client'
 import { DocsPage } from '@/components/DocsPage'
 
 const Layout = ({ children }) => {
diff --git a/src/app/events/events.json b/src/app/events/events.json
index 53c1846..76572c0 100644
--- a/src/app/events/events.json
+++ b/src/app/events/events.json
@@ -1,38 +1,26 @@
 [
     {
-        "date": "10-02-2020",
-        "title": "GopherCon Africa",
-        "description": "GoFr received an amazing response at GopherCon Africa! We showcased our seamless database integration, HTTP/gRPC support, observability, and WebSockets.",
-        "imageSrc": "https://media.discordapp.net/attachments/1230609009162059836/1301136150156677141/1729836948894.jpeg?ex=67620038&is=6760aeb8&hm=4cbee5de4bec5f526b941db402a3d1607c990054c3cf1853edb4934c70f776ba&=&format=webp&width=2160&height=944"
-    },
-    {
-        "date": "2021",
-        "title": "Open Source India 2024",
-        "description": "At Open Source India in Bengaluru, we kicked off with an amazing response at our booth on 23rd and an interactive Developer’s Meet on Oct 24th. It was a pleasure connecting with everyone at our booth, where demos highlighted GoFr’s innovative approach to writing microservices, making backend development simpler and more efficient.",
-        "imageSrc": "https://media.discordapp.net/attachments/1230609009162059836/1301136149749698650/1729836948365.jpeg?ex=67620038&is=6760aeb8&hm=f43bbf9dacbc631f36dfa7ae4402f61caaddcde1c8e4357236418d11c86d8006&=&format=webp&width=1418&height=1056"
+        "date": "23-24th November, 2024",
+        "title": "GoFr Hackathon",
+        "description": "GoFr Hackathon was a major success with participants building innovative solutions using the GoFr framework. It was an exciting two-day event where developers and tech enthusiasts came together to collaborate and create.",
+        "imageSrc": "/events/hackathon.jpg"
     },
     {
-        "date": "2022",
-        "title": "GoFr is on a roll with its workshops!",
-        "description": "Past two months, we’ve hosted workshops at top colleges such as IIT BHU, IIIT Sri City, Thapar University, JIIT Noida, NIT Jalandhar, and NIT Nagpur. At Gravitas in VIT Vellore, we proudly supported the Hack the Hackathon event, where students explored GoFr and contributed innovative ideas to enhance the framework.",
-        "imageSrc": "https://media.discordapp.net/attachments/1230609050899710052/1301491118780973137/WhatsApp_Image_2024-10-30_at_15.47.27.jpeg?ex=6761f94f&is=6760a7cf&hm=4bc52e39b921aeb00e444522fa49744dcbfa9d6fb7e35b1d3b2c167b6b6111d9&=&format=webp&width=1408&height=1056"
+        "date": "23-24th October, 2024",
+        "title": "Open Source India",
+        "description": "At Open Source India, we had an amazing experience connecting with the open-source community. The event featured various sessions, demos, and showcases on GoFr, highlighting its role in simplifying backend development and its microservice approach.",
+        "imageSrc": "/events/OpenSourceIndia.jpeg"
     },
     {
-        "date": "2020",
+        "date": "18-19th October, 2024",
         "title": "GopherCon Africa",
-        "description": "GoFr received an amazing response at GopherCon Africa! We showcased our seamless database integration, HTTP/gRPC support, observability, and WebSockets.",
-        "imageSrc": "https://media.discordapp.net/attachments/1230609009162059836/1301136150156677141/1729836948894.jpeg?ex=67620038&is=6760aeb8&hm=4cbee5de4bec5f526b941db402a3d1607c990054c3cf1853edb4934c70f776ba&=&format=webp&width=2160&height=944"
-    },
-    {
-        "date": "2021",
-        "title": "Open Source India 2024",
-        "description": "At Open Source India in Bengaluru, we kicked off with an amazing response at our booth on 23rd and an interactive Developer’s Meet on Oct 24th. It was a pleasure connecting with everyone at our booth, where demos highlighted GoFr’s innovative approach to writing microservices, making backend development simpler and more efficient.",
-        "imageSrc": "https://media.discordapp.net/attachments/1230609009162059836/1301136149749698650/1729836948365.jpeg?ex=67620038&is=6760aeb8&hm=f43bbf9dacbc631f36dfa7ae4402f61caaddcde1c8e4357236418d11c86d8006&=&format=webp&width=1418&height=1056"
+        "description": "At GopherCon Africa, GoFr stood out with its cutting-edge tools and integration features, making backend development easier. We showcased GoFr's capabilities in working with databases, observability tools, and its seamless HTTP/gRPC support.",
+        "imageSrc": "/events/gopherconAfrica.jpeg"
     },
     {
-        "date": "2022",
-        "title": "GoFr is on a roll with its workshops!",
-        "description": "Past two months, we’ve hosted workshops at top colleges such as IIT BHU, IIIT Sri City, Thapar University, JIIT Noida, NIT Jalandhar, and NIT Nagpur. At Gravitas in VIT Vellore, we proudly supported the Hack the Hackathon event, where students explored GoFr and contributed innovative ideas to enhance the framework.",
-        "imageSrc": "https://media.discordapp.net/attachments/1230609050899710052/1301491118780973137/WhatsApp_Image_2024-10-30_at_15.47.27.jpeg?ex=6761f94f&is=6760a7cf&hm=4bc52e39b921aeb00e444522fa49744dcbfa9d6fb7e35b1d3b2c167b6b6111d9&=&format=webp&width=1408&height=1056"
+        "date": "September 2024",
+        "title": "GoFr Workshops",
+        "description": "GoFr workshops are held regularly to engage with developers and tech enthusiasts. We’ve conducted workshops across multiple cities such as IIT BHU, IIIT Sri City, Thapar University, JIIT Noida, NIT Jalandhar, and NIT Nagpur offering hands-on experiences and deep dives into GoFr’s powerful features.",
+        "imageSrc": "/events/WorkShop.jpeg"
     }
 ]
diff --git a/src/app/events/layout.jsx b/src/app/events/layout.jsx
new file mode 100644
index 0000000..cd3a11c
--- /dev/null
+++ b/src/app/events/layout.jsx
@@ -0,0 +1,27 @@
+import React from 'react'
+
+export const metadata = {
+  title: 'GoFr Events — Conferences, Meetups & Talks',
+  description:
+    'Upcoming and past GoFr events: conference talks, meetups, workshops, and community gatherings about the opinionated Go microservice framework.',
+  metadataBase: new URL('https://gofr.dev'),
+  alternates: { canonical: '/events' },
+  openGraph: {
+    type: 'website',
+    url: 'https://gofr.dev/events',
+    title: 'GoFr Events',
+    description:
+      'Upcoming and past GoFr events: talks, meetups, workshops, and community gatherings.',
+    images: [{ url: '/opengraph-image.png', width: 1200, height: 630 }],
+  },
+  twitter: {
+    card: 'summary_large_image',
+    site: '@gofr_dev',
+    title: 'GoFr Events',
+    description: 'Talks, meetups, workshops, and community gatherings.',
+    images: ['/twitter-image.png'],
+  },
+}
+
+const Layout = ({ children }) => children
+export default Layout
diff --git a/src/app/examples/examples.json b/src/app/examples/examples.json
new file mode 100644
index 0000000..bdc4972
--- /dev/null
+++ b/src/app/examples/examples.json
@@ -0,0 +1,19 @@
+[
+  { "title": "HTTP Server", "description": "Basic REST API server with CRUD endpoints, Redis caching, and structured responses.", "tags": ["REST", "Getting Started"], "href": "https://github.com/gofr-dev/gofr/tree/main/examples/http-server", "featured": true },
+  { "title": "gRPC Server", "description": "Build a gRPC service with protocol buffers, streaming, and automatic observability.", "tags": ["gRPC", "Communication"], "href": "https://github.com/gofr-dev/gofr/tree/main/examples/grpc", "featured": true },
+  { "title": "Publisher", "description": "Publish messages to Kafka, Google Pub/Sub, NATS, or MQTT with a unified API.", "tags": ["Pub/Sub", "Messaging"], "href": "https://github.com/gofr-dev/gofr/tree/main/examples/using-publisher", "featured": true },
+  { "title": "Subscriber", "description": "Subscribe to message topics with automatic offset management and error handling.", "tags": ["Pub/Sub", "Messaging"], "href": "https://github.com/gofr-dev/gofr/tree/main/examples/using-subscriber" },
+  { "title": "HTTP Server with Redis", "description": "REST API backed by Redis for caching and session management.", "tags": ["REST", "Redis", "Database"], "href": "https://github.com/gofr-dev/gofr/tree/main/examples/http-server-using-redis" },
+  { "title": "REST Handlers", "description": "Auto-generate CRUD endpoints by implementing the REST interface.", "tags": ["REST", "Getting Started"], "href": "https://github.com/gofr-dev/gofr/tree/main/examples/using-add-rest-handlers" },
+  { "title": "Data Migrations", "description": "Run versioned schema migrations across MySQL, PostgreSQL, Redis, and MongoDB.", "tags": ["Database", "Migrations"], "href": "https://github.com/gofr-dev/gofr/tree/main/examples/using-migrations" },
+  { "title": "GraphQL API", "description": "Schema-first GraphQL with resolvers, playground, and built-in observability.", "tags": ["GraphQL", "Communication"], "href": "https://github.com/gofr-dev/gofr/tree/main/examples/using-graphql" },
+  { "title": "WebSocket", "description": "Real-time bidirectional communication with WebSocket support.", "tags": ["WebSocket", "Communication"], "href": "https://github.com/gofr-dev/gofr/tree/main/examples/using-web-socket" },
+  { "title": "Cron Jobs", "description": "Schedule recurring tasks with cron expressions and automatic metrics.", "tags": ["Background", "Scheduling"], "href": "https://github.com/gofr-dev/gofr/tree/main/examples/using-cron-jobs" },
+  { "title": "Custom Metrics", "description": "Publish application-specific Prometheus metrics alongside built-in observability.", "tags": ["Observability", "Metrics"], "href": "https://github.com/gofr-dev/gofr/tree/main/examples/using-custom-metrics" },
+  { "title": "HTTP Service Communication", "description": "Make inter-service HTTP calls with circuit breaker and retry support.", "tags": ["Communication", "Resilience"], "href": "https://github.com/gofr-dev/gofr/tree/main/examples/using-http-service" },
+  { "title": "Auth Middleware", "description": "Protect endpoints with Basic Auth, API Key, or OAuth middleware.", "tags": ["Security", "Middleware"], "href": "https://github.com/gofr-dev/gofr/tree/main/examples/using-http-auth-middleware" },
+  { "title": "File Handling", "description": "Upload, download, and manage files with local, S3, GCS, or FTP backends.", "tags": ["Files", "Storage"], "href": "https://github.com/gofr-dev/gofr/tree/main/examples/using-add-filestore" },
+  { "title": "File Binding", "description": "Bind uploaded files directly to structs for type-safe file processing.", "tags": ["Files", "Data Binding"], "href": "https://github.com/gofr-dev/gofr/tree/main/examples/using-file-bind" },
+  { "title": "HTML Templates", "description": "Serve server-rendered HTML pages with Go template support.", "tags": ["Templates", "Frontend"], "href": "https://github.com/gofr-dev/gofr/tree/main/examples/using-html-template" },
+  { "title": "CLI Application", "description": "Build command-line tools with subcommands, flags, and structured output.", "tags": ["CLI", "Tools"], "href": "https://github.com/gofr-dev/gofr/tree/main/examples/sample-cmd" }
+]
diff --git a/src/app/examples/layout.jsx b/src/app/examples/layout.jsx
new file mode 100644
index 0000000..3df491d
--- /dev/null
+++ b/src/app/examples/layout.jsx
@@ -0,0 +1,27 @@
+import React from 'react'
+
+export const metadata = {
+  title: 'GoFr Examples — REST, gRPC, Pub/Sub, GraphQL, WebSocket',
+  description:
+    'Real-world GoFr examples covering REST APIs, gRPC, Pub/Sub (Kafka, NATS, Google Pub/Sub), GraphQL, WebSockets, cron jobs, migrations, observability, and more.',
+  metadataBase: new URL('https://gofr.dev'),
+  alternates: { canonical: '/examples' },
+  openGraph: {
+    type: 'website',
+    url: 'https://gofr.dev/examples',
+    title: 'GoFr Examples — REST, gRPC, Pub/Sub, GraphQL, WebSocket',
+    description:
+      'Runnable Go microservice examples: REST, gRPC, Pub/Sub, GraphQL, WebSocket, cron, migrations, observability.',
+    images: [{ url: '/opengraph-image.png', width: 1200, height: 630 }],
+  },
+  twitter: {
+    card: 'summary_large_image',
+    site: '@gofr_dev',
+    title: 'GoFr Examples',
+    description: 'Runnable Go microservice examples covering all major patterns.',
+    images: ['/twitter-image.png'],
+  },
+}
+
+const Layout = ({ children }) => children
+export default Layout
diff --git a/src/app/examples/page.jsx b/src/app/examples/page.jsx
new file mode 100644
index 0000000..e02fe8d
--- /dev/null
+++ b/src/app/examples/page.jsx
@@ -0,0 +1,178 @@
+'use client'
+
+import { useState } from 'react'
+import Link from 'next/link'
+import examples from './examples.json'
+
+const tagColors = {
+  'REST': 'bg-emerald-500/10 text-emerald-400',
+  'gRPC': 'bg-violet-500/10 text-violet-400',
+  'Pub/Sub': 'bg-sky-500/10 text-sky-400',
+  'Messaging': 'bg-sky-500/10 text-sky-400',
+  'Database': 'bg-amber-500/10 text-amber-400',
+  'Redis': 'bg-red-500/10 text-red-400',
+  'Communication': 'bg-blue-500/10 text-blue-400',
+  'Migrations': 'bg-amber-500/10 text-amber-400',
+  'GraphQL': 'bg-pink-500/10 text-pink-400',
+  'WebSocket': 'bg-indigo-500/10 text-indigo-400',
+  'Background': 'bg-slate-500/10 text-slate-400',
+  'Scheduling': 'bg-slate-500/10 text-slate-400',
+  'Observability': 'bg-cyan-500/10 text-cyan-400',
+  'Metrics': 'bg-cyan-500/10 text-cyan-400',
+  'Resilience': 'bg-orange-500/10 text-orange-400',
+  'Security': 'bg-red-500/10 text-red-400',
+  'Middleware': 'bg-purple-500/10 text-purple-400',
+  'Files': 'bg-teal-500/10 text-teal-400',
+  'Storage': 'bg-teal-500/10 text-teal-400',
+  'Data Binding': 'bg-lime-500/10 text-lime-400',
+  'Templates': 'bg-rose-500/10 text-rose-400',
+  'Frontend': 'bg-rose-500/10 text-rose-400',
+  'CLI': 'bg-slate-500/10 text-slate-300',
+  'Tools': 'bg-slate-500/10 text-slate-400',
+  'Getting Started': 'bg-emerald-500/10 text-emerald-400',
+}
+
+const allTags = [...new Set(examples.flatMap((e) => e.tags))]
+
+export default function ExamplesPage() {
+  let [activeTag, setActiveTag] = useState(null)
+
+  let filtered = activeTag
+    ? examples.filter((e) => e.tags.includes(activeTag))
+    : examples
+
+  let featured = examples.filter((e) => e.featured)
+
+  return (
+    <div className="min-h-screen bg-slate-900">
+      <div className="mx-auto max-w-5xl px-4 py-16 sm:px-6 lg:px-8">
+        <div className="text-center">
+          <h1 className="font-display text-4xl font-bold tracking-tight text-white">
+            Examples & Recipes
+          </h1>
+          <p className="mt-3 text-lg text-slate-400">
+            Learn GoFr by example. Each recipe is a working project you can clone and run.
+          </p>
+          {/* Quick clone snippet — answers the "ok how do I run these?" question */}
+          {/* immediately, without making the visitor hunt for instructions. */}
+          <div className="mx-auto mt-6 max-w-2xl">
+            <div className="flex items-center gap-3 rounded-lg border border-slate-800 bg-slate-950/60 p-3 text-left font-mono text-xs text-slate-400">
+              <span className="flex-none select-none text-slate-600">$</span>
+              {/* whitespace-nowrap so the command never breaks mid-word; */}
+              {/* the code element scrolls horizontally if it's too long. */}
+              <code className="min-w-0 flex-1 overflow-x-auto whitespace-nowrap">
+                git clone https://github.com/gofr-dev/gofr
+              </code>
+              <Link
+                href="https://github.com/codespaces/new?repo=gofr-dev/gofr"
+                target="_blank"
+                rel="noopener noreferrer"
+                className="inline-flex flex-none items-center gap-1 rounded-md bg-slate-800 px-2.5 py-1 text-[11px] font-medium text-slate-300 transition-colors hover:bg-slate-700 hover:text-white"
+              >
+                <svg className="h-3 w-3" viewBox="0 0 16 16" fill="currentColor">
+                  <path d="M2 5a3 3 0 0 1 3-3h6a3 3 0 0 1 3 3v3a3 3 0 0 1-3 3H5a3 3 0 0 1-3-3V5Zm3-1.5A1.5 1.5 0 0 0 3.5 5v3A1.5 1.5 0 0 0 5 9.5h6A1.5 1.5 0 0 0 12.5 8V5A1.5 1.5 0 0 0 11 3.5H5Z" />
+                  <path d="M0 11.25A2.25 2.25 0 0 1 2.25 9h11.5A2.25 2.25 0 0 1 16 11.25v1.5A2.25 2.25 0 0 1 13.75 15H2.25A2.25 2.25 0 0 1 0 12.75v-1.5Z" />
+                </svg>
+                Codespaces
+              </Link>
+            </div>
+            <p className="mt-2 text-center text-xs text-slate-500">
+              Examples live under <code className="font-mono">gofr/examples</code> — pick any subfolder and run <code className="font-mono">go run main.go</code>.
+            </p>
+          </div>
+        </div>
+
+        {/* Featured */}
+        {!activeTag && (
+          <div className="mt-12">
+            <h2 className="text-sm font-semibold uppercase tracking-wider text-slate-500">
+              Start here
+            </h2>
+            <div className="mt-4 grid gap-4 sm:grid-cols-3">
+              {featured.map((example) => (
+                <Link
+                  key={example.title}
+                  href={example.href}
+                  target="_blank"
+                  className="group relative block rounded-xl border border-sky-500/30 bg-sky-500/5 p-5 transition-all hover:border-transparent"
+                >
+                  <div className="absolute -inset-px rounded-xl border-2 border-transparent opacity-0 transition-opacity [background:linear-gradient(var(--quick-links-hover-bg,theme(colors.sky.50)),var(--quick-links-hover-bg,theme(colors.sky.50)))_padding-box,linear-gradient(to_top,theme(colors.indigo.400),theme(colors.cyan.400),theme(colors.sky.500))_border-box] group-hover:opacity-100 dark:[--quick-links-hover-bg:theme(colors.slate.800)]" />
+                  <div className="relative">
+                    <h3 className="font-display text-base font-medium text-white">{example.title}</h3>
+                    <p className="mt-1 text-sm text-slate-400">{example.description}</p>
+                    <div className="mt-3 flex flex-wrap gap-1.5">
+                      {example.tags.map((tag) => (
+                        <span key={tag} className={`rounded-full px-2 py-0.5 text-[10px] font-medium ${tagColors[tag] || 'bg-slate-800 text-slate-400'}`}>
+                          {tag}
+                        </span>
+                      ))}
+                    </div>
+                  </div>
+                </Link>
+              ))}
+            </div>
+          </div>
+        )}
+
+        {/* Tag filter */}
+        <div className="mt-10 flex flex-wrap gap-2">
+          <button
+            onClick={() => setActiveTag(null)}
+            className={`rounded-full px-3 py-1 text-xs font-medium transition-colors ${
+              !activeTag ? 'bg-sky-500 text-white' : 'bg-slate-800 text-slate-400 hover:text-white'
+            }`}
+          >
+            All
+          </button>
+          {allTags.map((tag) => (
+            <button
+              key={tag}
+              onClick={() => setActiveTag(activeTag === tag ? null : tag)}
+              className={`rounded-full px-3 py-1 text-xs font-medium transition-colors ${
+                activeTag === tag ? 'bg-sky-500 text-white' : 'bg-slate-800 text-slate-400 hover:text-white'
+              }`}
+            >
+              {tag}
+            </button>
+          ))}
+        </div>
+
+        {/* All examples */}
+        <div className="mt-6 grid gap-3 sm:grid-cols-2 lg:grid-cols-3">
+          {filtered.map((example) => (
+            <Link
+              key={example.title}
+              href={example.href}
+              target="_blank"
+              className="group relative block rounded-xl border border-slate-800 p-5 transition-all hover:border-transparent"
+            >
+              <div className="absolute -inset-px rounded-xl border-2 border-transparent opacity-0 transition-opacity [background:linear-gradient(var(--quick-links-hover-bg,theme(colors.sky.50)),var(--quick-links-hover-bg,theme(colors.sky.50)))_padding-box,linear-gradient(to_top,theme(colors.indigo.400),theme(colors.cyan.400),theme(colors.sky.500))_border-box] group-hover:opacity-100 dark:[--quick-links-hover-bg:theme(colors.slate.800)]" />
+              <div className="relative">
+                <h3 className="font-display text-sm font-medium text-white">{example.title}</h3>
+                <p className="mt-1 text-xs text-slate-400 line-clamp-2">{example.description}</p>
+                <div className="mt-3 flex flex-wrap gap-1">
+                  {example.tags.map((tag) => (
+                    <span key={tag} className={`rounded-full px-2 py-0.5 text-[10px] font-medium ${tagColors[tag] || 'bg-slate-800 text-slate-400'}`}>
+                      {tag}
+                    </span>
+                  ))}
+                </div>
+              </div>
+            </Link>
+          ))}
+        </div>
+
+        {/* CTA */}
+        <div className="mt-12 text-center">
+          <Link
+            href="https://github.com/gofr-dev/gofr/tree/main/examples"
+            target="_blank"
+            className="text-sm text-slate-400 transition-colors hover:text-sky-400"
+          >
+            Browse all examples on GitHub →
+          </Link>
+        </div>
+      </div>
+    </div>
+  )
+}
diff --git a/src/app/faq/layout.jsx b/src/app/faq/layout.jsx
new file mode 100644
index 0000000..af09d65
--- /dev/null
+++ b/src/app/faq/layout.jsx
@@ -0,0 +1,5 @@
+import { MarketingPage } from '@/components/MarketingPage'
+
+const Layout = ({ children }) => <MarketingPage>{children}</MarketingPage>
+
+export default Layout
diff --git a/src/app/layout.jsx b/src/app/layout.jsx
index 280c313..a1d1fea 100644
--- a/src/app/layout.jsx
+++ b/src/app/layout.jsx
@@ -22,6 +22,73 @@ const lexend = localFont({
   variable: '--font-lexend',
 })
 
+// Site-wide defaults. Per-route metadata (page.jsx `metadata` exports
+// or Markdoc `nextjs.metadata` frontmatter) overrides the title /
+// description / openGraph.{title,description,url} on a per-page basis;
+// site-wide values like the social image, the Twitter handles, and
+// type=website inherit through unless explicitly overridden.
+//
+// Important: this used to be hardcoded as <meta> tags inside the
+// <head> JSX, which silently overrode every per-page metadata setting
+// — every subpage was sharing the home page's social card. Moving it
+// into the metadata export lets Next's metadata-merge actually do its
+// job.
+export const metadata = {
+  metadataBase: new URL('https://gofr.dev'),
+  title: {
+    default: 'GoFr — An Opinionated Go Framework',
+    template: '%s | GoFr',
+  },
+  description:
+    'An Opinionated Go Framework for accelerated microservice development. Built-in observability, 15+ datasources, gRPC, GraphQL, WebSockets, and pub/sub.',
+  // Canonical intentionally omitted from the root layout — setting it
+  // to '/' would brand every subpage as a duplicate of the home page.
+  // Per-page metadata sets its own canonical via `alternates.canonical`
+  // (or via Next's URL-based default when metadataBase is set).
+  robots: {
+    index: true,
+    follow: true,
+    googleBot: {
+      index: true,
+      follow: true,
+      'max-snippet': -1,
+      'max-image-preview': 'large',
+      'max-video-preview': -1,
+    },
+  },
+  openGraph: {
+    type: 'website',
+    siteName: 'GoFr',
+    title: 'GoFr — An Opinionated Go Framework',
+    description:
+      'An Opinionated Go Framework for accelerated microservice development. Built-in observability, 15+ datasources, gRPC, GraphQL, WebSockets, and pub/sub.',
+    url: 'https://gofr.dev/',
+    images: [
+      {
+        url: '/opengraph-image.png',
+        width: 1200,
+        height: 630,
+        alt: 'GoFr — An Opinionated Go Framework',
+      },
+    ],
+  },
+  twitter: {
+    card: 'summary_large_image',
+    site: '@gofr_dev',
+    creator: '@gofr_dev',
+    title: 'GoFr — An Opinionated Go Framework',
+    description:
+      'An Opinionated Go Framework for accelerated microservice development. Built-in observability, 15+ datasources, gRPC, GraphQL, WebSockets, and pub/sub.',
+    images: ['/twitter-image.png'],
+  },
+  verification: {
+    google: [
+      'MVkGpVWwO1qPJIoXAKXQs5b6oKwxLAMLWtDDMeD23hE',
+      '9TFTpJ19XHm0dVVKTF5l6OTMLcahEn0M3aZFZ14gRFI',
+    ],
+  },
+}
+
 export default function RootLayout({ children }) {
   return (
     <html
@@ -30,37 +97,20 @@ export default function RootLayout({ children }) {
       suppressHydrationWarning
     >
       <head>
-        <meta name="google-site-verification" content="MVkGpVWwO1qPJIoXAKXQs5b6oKwxLAMLWtDDMeD23hE" />
-        <meta
-          name="google-site-verification"
-          content="9TFTpJ19XHm0dVVKTF5l6OTMLcahEn0M3aZFZ14gRFI"
-        />
-        <meta
-          property="og:title"
-          content="GoFr - An opinionated Go Framework"
-        />
-        <meta
-          property="og:description"
-          content="For accelerated microservice development"
-        ></meta>
-        <meta property="og:url" content="https://gofr.dev/"></meta>
-        <meta property="og:type" content="website"></meta>
+        {/* AI / LLM discoverability. Two signals every page emits: */}
+        {/*  - `rel="alternate"` with text/plain + text/markdown so */}
+        {/*    crawlers that follow rel-alternate links pick them up. */}
+        {/*  - The original "ai" + "llm" rel values are not yet a W3C */}
+        {/*    standard but match the convention emerging across sites */}
+        {/*    that have published llms.txt — costs nothing to emit. */}
+        {/* The hreflang on rel="alternate" is intentionally omitted */}
+        {/* because these resources are language-neutral indexes. */}
+        <link rel="alternate" type="text/plain" href="/llms.txt" title="LLM index (llmstxt.org)" />
+        <link rel="alternate" type="text/plain" href="/llms-full.txt" title="LLM full content dump" />
+        <link rel="alternate" type="text/markdown" href="/AGENTS.md" title="AI assistant context" />
+        <link rel="llm" type="text/plain" href="/llms.txt" />
+        <link rel="ai-context" type="text/markdown" href="/AGENTS.md" />
 
-        {/* <script
-          async
-          src="https://www.googletagmanager.com/gtag/js?id=G-QEC53YYXB8"
-        ></script>
-        <script
-          dangerouslySetInnerHTML={{
-            __html: `window.dataLayer = window.dataLayer || [];
-          function gtag(){
-            window.dataLayer.push(arguments)
-          }
-          gtag('js', new Date());
-          gtag('config', 'G-QEC53YYXB8');
-          `,
-          }}
-        /> */}
         <GoogleTagManager gtmId="GTM-5G6KD5VJ" />
       </head>
 
diff --git a/src/app/learn/layout.jsx b/src/app/learn/layout.jsx
new file mode 100644
index 0000000..b9d1c77
--- /dev/null
+++ b/src/app/learn/layout.jsx
@@ -0,0 +1,4 @@
+import { MarketingPage } from '@/components/MarketingPage'
+
+const Layout = ({ children }) => <MarketingPage>{children}</MarketingPage>
+export default Layout
diff --git a/src/app/migrate/layout.jsx b/src/app/migrate/layout.jsx
new file mode 100644
index 0000000..b9d1c77
--- /dev/null
+++ b/src/app/migrate/layout.jsx
@@ -0,0 +1,4 @@
+import { MarketingPage } from '@/components/MarketingPage'
+
+const Layout = ({ children }) => <MarketingPage>{children}</MarketingPage>
+export default Layout
diff --git a/src/app/not-found.jsx b/src/app/not-found.jsx
index c27e552..87ffd53 100644
--- a/src/app/not-found.jsx
+++ b/src/app/not-found.jsx
@@ -1,24 +1,95 @@
+'use client'
+
 import Link from 'next/link'
+import { usePathname } from 'next/navigation'
+import { Search } from '@/components/Search'
+
+// Useful 404 — gives the visitor what they probably wanted (search,
+// quick start, examples, community) instead of a dead end. Common
+// pattern on framework sites: every dead link should still help.
+const helpfulLinks = [
+  {
+    title: 'Quick Start',
+    description: 'Build your first GoFr server in under 5 minutes.',
+    href: '/docs/quick-start/introduction',
+  },
+  {
+    title: 'Documentation',
+    description: 'Full reference: HTTP, gRPC, GraphQL, datasources, more.',
+    href: '/docs',
+  },
+  {
+    title: 'Examples',
+    description: 'Working projects you can clone and run.',
+    href: '/examples',
+  },
+]
 
 export default function NotFound() {
+  const pathname = usePathname() || ''
+  // Pre-fill issue body with the broken path so reports are actionable.
+  const issueUrl = `https://github.com/gofr-dev/gofr/issues/new?title=${encodeURIComponent(
+    `Broken link: ${pathname}`,
+  )}&body=${encodeURIComponent(
+    `The path \`${pathname}\` returns 404 on gofr.dev.\n\nReferrer: <please paste>`,
+  )}`
+
   return (
-    <div className="h-[70vh] min-w-0 max-w-2xl flex-auto px-4 py-16 lg:max-w-none lg:pl-8 lg:pr-0 xl:px-16">
-      <div className="flex h-full flex-col items-center justify-center text-center">
-        <p className="font-display text-sm font-medium text-slate-900 dark:text-white">
-          404
-        </p>
-        <h1 className="mt-3 font-display text-3xl tracking-tight text-slate-900 dark:text-white">
-          Page not found
-        </h1>
-        <p className="mt-2 text-sm text-slate-500 dark:text-slate-400">
-          Sorry, we couldn’t find the page you’re looking for.
-        </p>
-        <Link
-          href="/"
-          className="mt-8 text-sm font-medium text-slate-900 dark:text-white"
-        >
-          Go back home
-        </Link>
+    <div className="min-h-[70vh] bg-slate-900">
+      <div className="mx-auto max-w-3xl px-4 py-16 sm:px-6 lg:px-8">
+        <div className="text-center">
+          <p className="font-mono text-xs uppercase tracking-wider text-slate-500">
+            404
+          </p>
+          <h1 className="mt-2 font-display text-4xl font-bold tracking-tight text-white">
+            We couldn’t find that page
+          </h1>
+          {pathname && (
+            <p className="mt-2 text-sm text-slate-500">
+              <code className="rounded bg-slate-800 px-2 py-0.5 text-xs text-slate-400">
+                {pathname}
+              </code>{' '}
+              isn’t a route we recognize.
+            </p>
+          )}
+        </div>
+
+        {/* Search — the most useful thing on a 404. */}
+        <div className="mt-10">
+          <Search />
+        </div>
+
+        <div className="mt-10 grid gap-3 sm:grid-cols-2">
+          {helpfulLinks.map((l) => (
+            <Link
+              key={l.href}
+              href={l.href}
+              className="group rounded-xl border border-slate-800 p-5 transition-colors hover:border-sky-500/50"
+            >
+              <p className="font-display text-sm font-medium text-white">
+                {l.title}
+              </p>
+              <p className="mt-1 text-xs text-slate-400">{l.description}</p>
+            </Link>
+          ))}
+        </div>
+
+        <div className="mt-10 flex flex-col items-center gap-3 text-center">
+          <Link
+            href="/"
+            className="rounded-full bg-sky-300 px-4 py-2 text-sm font-semibold text-slate-900 hover:bg-sky-200"
+          >
+            Go to homepage
+          </Link>
+          <Link
+            href={issueUrl}
+            target="_blank"
+            rel="noopener noreferrer"
+            className="text-xs text-slate-500 hover:text-slate-300"
+          >
+            Report this broken link →
+          </Link>
+        </div>
       </div>
     </div>
   )
diff --git a/src/app/page.jsx b/src/app/page.jsx
index 64000bd..6910075 100644
--- a/src/app/page.jsx
+++ b/src/app/page.jsx
@@ -1,32 +1,119 @@
 import { HomePage } from '@/components/HomePage'
 
 export const metadata = {
-  title: 'GoFr - An opinionated Go Framework',
+  title: 'GoFr — An Opinionated Go Framework',
   description:
-    'GoFr is an opinionated Go framework within the CNCF Landscape, designed for accelerated microservice development. It features built-in observability tools that export traces, metrics, and logs, enhancing monitoring capabilities. By minimizing boilerplate code, GoFr boosts developer productivity and supports multiple data sources. Some Key features include simplified pub/sub, filesystem operations, cron jobs, WebSocket integration, data migrations, and remote log-level change.',
+    'An Opinionated Go Framework for accelerated microservice development. Built-in observability, 15+ datasources, gRPC, GraphQL, WebSockets, and pub/sub.',
   metadataBase: new URL('https://gofr.dev'),
+  alternates: {
+    canonical: '/',
+  },
   keywords: [
     'gofr',
     'go framework',
     'golang framework',
+    'go web framework',
     'golang web framework',
-    'http services',
-    'gin gonic',
-    'go fiber',
-    'fiber',
-    'fiber app',
-    'fiber logs',
-    'go recover',
-    'fiber set',
-    'fiber router',
+    'go microservice framework',
+    'golang microservice framework',
+    'opinionated go framework',
+    'production go framework',
+    'go framework with observability',
+    'go framework opentelemetry',
+    'go framework kubernetes',
+    'go grpc framework',
+    'go graphql server',
+    'go websocket server',
+    'go pubsub framework',
   ],
+  openGraph: {
+    type: 'website',
+    url: 'https://gofr.dev/',
+    siteName: 'GoFr',
+    title: 'GoFr — An Opinionated Go Framework',
+    description:
+      'An Opinionated Go Framework for accelerated microservice development. Built-in observability, 15+ datasources, gRPC, GraphQL, WebSockets, and pub/sub.',
+    images: [
+      {
+        url: '/opengraph-image.png',
+        width: 1200,
+        height: 630,
+        alt: 'GoFr — An Opinionated Go Framework',
+      },
+    ],
+  },
+  twitter: {
+    card: 'summary_large_image',
+    site: '@gofr_dev',
+    creator: '@gofr_dev',
+    title: 'GoFr — An Opinionated Go Framework',
+    description:
+      'An Opinionated Go Framework for accelerated microservice development. Built-in observability, 15+ datasources, gRPC, GraphQL, WebSockets, and pub/sub.',
+    images: ['/twitter-image.png'],
+  },
   other: {
     'go-import': 'gofr.dev git https://github.com/gofr-dev/gofr',
   },
 }
 
+// SoftwareApplication + Organization schema makes GoFr eligible for
+// Google's software rich result and gives AI search engines a clean,
+// attributable description of what GoFr is and where to find it.
+const softwareApplicationLd = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: 'GoFr',
+  applicationCategory: 'DeveloperApplication',
+  operatingSystem: 'Linux, macOS, Windows',
+  description:
+    'An opinionated Go framework for production microservice development with built-in observability, 15+ datasource integrations, gRPC, GraphQL, WebSockets, and zero-boilerplate REST handlers.',
+  url: 'https://gofr.dev',
+  programmingLanguage: 'Go',
+  license: 'https://github.com/gofr-dev/gofr/blob/main/LICENSE',
+  codeRepository: 'https://github.com/gofr-dev/gofr',
+  offers: {
+    '@type': 'Offer',
+    price: '0',
+    priceCurrency: 'USD',
+  },
+  author: {
+    '@type': 'Organization',
+    name: 'GoFr',
+    url: 'https://gofr.dev',
+  },
+}
+
+const organizationLd = {
+  '@context': 'https://schema.org',
+  '@type': 'Organization',
+  name: 'GoFr',
+  url: 'https://gofr.dev',
+  logo: 'https://gofr.dev/img/gofr-logo.svg',
+  sameAs: [
+    'https://github.com/gofr-dev/gofr',
+    'https://twitter.com/gofr_dev',
+    'https://www.linkedin.com/company/gofr-dev',
+    'https://discord.gg/5ACeSKGt37',
+    'https://www.reddit.com/r/gofr/',
+  ],
+}
+
 const Home = () => {
-  return <HomePage />
+  return (
+    <>
+      <script
+        type="application/ld+json"
+        dangerouslySetInnerHTML={{
+          __html: JSON.stringify(softwareApplicationLd),
+        }}
+      />
+      <script
+        type="application/ld+json"
+        dangerouslySetInnerHTML={{ __html: JSON.stringify(organizationLd) }}
+      />
+      <HomePage />
+    </>
+  )
 }
 
 export default Home
diff --git a/src/app/pkg/gofr/datasource/arangodb/page.jsx b/src/app/pkg/gofr/datasource/arangodb/page.jsx
index f8bffb5..77f6662 100644
--- a/src/app/pkg/gofr/datasource/arangodb/page.jsx
+++ b/src/app/pkg/gofr/datasource/arangodb/page.jsx
@@ -1,16 +1,11 @@
-import React from 'react';
+import { PkgRedirect } from '@/components/PkgRedirect'
 
 
-const Page = () => {
-    return (
-        <div className={`flex justify-center items-center min-h-[70vh]`}>
-            <div className={`text-4xl font-semibold flex gap-3 flex-wrap justify-center`}>
-                <span>
-                </span>
-                <span className={`text-sky-400`}></span>
-            </div>
-        </div>
-    );
-};
+export const metadata = {
+  title: 'gofr/datasource/arangodb — GoFr Go Package',
+  description: 'Go module path for gofr/datasource/arangodb. This redirect-only page sends visitors to the GoFr documentation for setup, configuration, and usage examples.',
+}
 
-export default Page;
\ No newline at end of file
+export default function Page() {
+  return <PkgRedirect name="gofr/datasource/arangodb" docsPath="/docs/datasources/arangodb" />
+}
diff --git a/src/app/pkg/gofr/datasource/cassandra/page.jsx b/src/app/pkg/gofr/datasource/cassandra/page.jsx
index f8bffb5..897cb9b 100644
--- a/src/app/pkg/gofr/datasource/cassandra/page.jsx
+++ b/src/app/pkg/gofr/datasource/cassandra/page.jsx
@@ -1,16 +1,11 @@
-import React from 'react';
+import { PkgRedirect } from '@/components/PkgRedirect'
 
 
-const Page = () => {
-    return (
-        <div className={`flex justify-center items-center min-h-[70vh]`}>
-            <div className={`text-4xl font-semibold flex gap-3 flex-wrap justify-center`}>
-                <span>
-                </span>
-                <span className={`text-sky-400`}></span>
-            </div>
-        </div>
-    );
-};
+export const metadata = {
+  title: 'gofr/datasource/cassandra — GoFr Go Package',
+  description: 'Go module path for gofr/datasource/cassandra. This redirect-only page sends visitors to the GoFr documentation for setup, configuration, and usage examples.',
+}
 
-export default Page;
\ No newline at end of file
+export default function Page() {
+  return <PkgRedirect name="gofr/datasource/cassandra" docsPath="/docs/datasources/cassandra" />
+}
diff --git a/src/app/pkg/gofr/datasource/clickhouse/page.jsx b/src/app/pkg/gofr/datasource/clickhouse/page.jsx
index f8bffb5..fb5137e 100644
--- a/src/app/pkg/gofr/datasource/clickhouse/page.jsx
+++ b/src/app/pkg/gofr/datasource/clickhouse/page.jsx
@@ -1,16 +1,11 @@
-import React from 'react';
+import { PkgRedirect } from '@/components/PkgRedirect'
 
 
-const Page = () => {
-    return (
-        <div className={`flex justify-center items-center min-h-[70vh]`}>
-            <div className={`text-4xl font-semibold flex gap-3 flex-wrap justify-center`}>
-                <span>
-                </span>
-                <span className={`text-sky-400`}></span>
-            </div>
-        </div>
-    );
-};
+export const metadata = {
+  title: 'gofr/datasource/clickhouse — GoFr Go Package',
+  description: 'Go module path for gofr/datasource/clickhouse. This redirect-only page sends visitors to the GoFr documentation for setup, configuration, and usage examples.',
+}
 
-export default Page;
\ No newline at end of file
+export default function Page() {
+  return <PkgRedirect name="gofr/datasource/clickhouse" docsPath="/docs/datasources/clickhouse" />
+}
diff --git a/src/app/pkg/gofr/datasource/couchbase/page.jsx b/src/app/pkg/gofr/datasource/couchbase/page.jsx
index f8bffb5..f9ce3a9 100644
--- a/src/app/pkg/gofr/datasource/couchbase/page.jsx
+++ b/src/app/pkg/gofr/datasource/couchbase/page.jsx
@@ -1,16 +1,11 @@
-import React from 'react';
+import { PkgRedirect } from '@/components/PkgRedirect'
 
 
-const Page = () => {
-    return (
-        <div className={`flex justify-center items-center min-h-[70vh]`}>
-            <div className={`text-4xl font-semibold flex gap-3 flex-wrap justify-center`}>
-                <span>
-                </span>
-                <span className={`text-sky-400`}></span>
-            </div>
-        </div>
-    );
-};
+export const metadata = {
+  title: 'gofr/datasource/couchbase — GoFr Go Package',
+  description: 'Go module path for gofr/datasource/couchbase. This redirect-only page sends visitors to the GoFr documentation for setup, configuration, and usage examples.',
+}
 
-export default Page;
\ No newline at end of file
+export default function Page() {
+  return <PkgRedirect name="gofr/datasource/couchbase" docsPath="/docs/datasources/couchbase" />
+}
diff --git a/src/app/pkg/gofr/datasource/dbresolver/page.jsx b/src/app/pkg/gofr/datasource/dbresolver/page.jsx
index f8bffb5..703cce1 100644
--- a/src/app/pkg/gofr/datasource/dbresolver/page.jsx
+++ b/src/app/pkg/gofr/datasource/dbresolver/page.jsx
@@ -1,16 +1,11 @@
-import React from 'react';
+import { PkgRedirect } from '@/components/PkgRedirect'
 
 
-const Page = () => {
-    return (
-        <div className={`flex justify-center items-center min-h-[70vh]`}>
-            <div className={`text-4xl font-semibold flex gap-3 flex-wrap justify-center`}>
-                <span>
-                </span>
-                <span className={`text-sky-400`}></span>
-            </div>
-        </div>
-    );
-};
+export const metadata = {
+  title: 'gofr/datasource/dbresolver — GoFr Go Package',
+  description: 'Go module path for gofr/datasource/dbresolver. This redirect-only page sends visitors to the GoFr documentation for setup, configuration, and usage examples.',
+}
 
-export default Page;
\ No newline at end of file
+export default function Page() {
+  return <PkgRedirect name="gofr/datasource/dbresolver" docsPath="/docs/datasources/getting-started" />
+}
diff --git a/src/app/pkg/gofr/datasource/dgraph/page.jsx b/src/app/pkg/gofr/datasource/dgraph/page.jsx
index f8bffb5..a4ab6ef 100644
--- a/src/app/pkg/gofr/datasource/dgraph/page.jsx
+++ b/src/app/pkg/gofr/datasource/dgraph/page.jsx
@@ -1,16 +1,11 @@
-import React from 'react';
+import { PkgRedirect } from '@/components/PkgRedirect'
 
 
-const Page = () => {
-    return (
-        <div className={`flex justify-center items-center min-h-[70vh]`}>
-            <div className={`text-4xl font-semibold flex gap-3 flex-wrap justify-center`}>
-                <span>
-                </span>
-                <span className={`text-sky-400`}></span>
-            </div>
-        </div>
-    );
-};
+export const metadata = {
+  title: 'gofr/datasource/dgraph — GoFr Go Package',
+  description: 'Go module path for gofr/datasource/dgraph. This redirect-only page sends visitors to the GoFr documentation for setup, configuration, and usage examples.',
+}
 
-export default Page;
\ No newline at end of file
+export default function Page() {
+  return <PkgRedirect name="gofr/datasource/dgraph" docsPath="/docs/datasources/dgraph" />
+}
diff --git a/src/app/pkg/gofr/datasource/elasticsearch/page.jsx b/src/app/pkg/gofr/datasource/elasticsearch/page.jsx
index f8bffb5..8309246 100644
--- a/src/app/pkg/gofr/datasource/elasticsearch/page.jsx
+++ b/src/app/pkg/gofr/datasource/elasticsearch/page.jsx
@@ -1,16 +1,11 @@
-import React from 'react';
+import { PkgRedirect } from '@/components/PkgRedirect'
 
 
-const Page = () => {
-    return (
-        <div className={`flex justify-center items-center min-h-[70vh]`}>
-            <div className={`text-4xl font-semibold flex gap-3 flex-wrap justify-center`}>
-                <span>
-                </span>
-                <span className={`text-sky-400`}></span>
-            </div>
-        </div>
-    );
-};
+export const metadata = {
+  title: 'gofr/datasource/elasticsearch — GoFr Go Package',
+  description: 'Go module path for gofr/datasource/elasticsearch. This redirect-only page sends visitors to the GoFr documentation for setup, configuration, and usage examples.',
+}
 
-export default Page;
\ No newline at end of file
+export default function Page() {
+  return <PkgRedirect name="gofr/datasource/elasticsearch" docsPath="/docs/datasources/elasticsearch" />
+}
diff --git a/src/app/pkg/gofr/datasource/file/azure/page.jsx b/src/app/pkg/gofr/datasource/file/azure/page.jsx
index f8bffb5..f24729c 100644
--- a/src/app/pkg/gofr/datasource/file/azure/page.jsx
+++ b/src/app/pkg/gofr/datasource/file/azure/page.jsx
@@ -1,16 +1,11 @@
-import React from 'react';
+import { PkgRedirect } from '@/components/PkgRedirect'
 
 
-const Page = () => {
-    return (
-        <div className={`flex justify-center items-center min-h-[70vh]`}>
-            <div className={`text-4xl font-semibold flex gap-3 flex-wrap justify-center`}>
-                <span>
-                </span>
-                <span className={`text-sky-400`}></span>
-            </div>
-        </div>
-    );
-};
+export const metadata = {
+  title: 'gofr/datasource/file/azure — GoFr Go Package',
+  description: 'Go module path for gofr/datasource/file/azure. This redirect-only page sends visitors to the GoFr documentation for setup, configuration, and usage examples.',
+}
 
-export default Page;
\ No newline at end of file
+export default function Page() {
+  return <PkgRedirect name="gofr/datasource/file/azure" docsPath="/docs/datasources/getting-started" />
+}
diff --git a/src/app/pkg/gofr/datasource/file/ftp/page.jsx b/src/app/pkg/gofr/datasource/file/ftp/page.jsx
index f8bffb5..c789025 100644
--- a/src/app/pkg/gofr/datasource/file/ftp/page.jsx
+++ b/src/app/pkg/gofr/datasource/file/ftp/page.jsx
@@ -1,16 +1,11 @@
-import React from 'react';
+import { PkgRedirect } from '@/components/PkgRedirect'
 
 
-const Page = () => {
-    return (
-        <div className={`flex justify-center items-center min-h-[70vh]`}>
-            <div className={`text-4xl font-semibold flex gap-3 flex-wrap justify-center`}>
-                <span>
-                </span>
-                <span className={`text-sky-400`}></span>
-            </div>
-        </div>
-    );
-};
+export const metadata = {
+  title: 'gofr/datasource/file/ftp — GoFr Go Package',
+  description: 'Go module path for gofr/datasource/file/ftp. This redirect-only page sends visitors to the GoFr documentation for setup, configuration, and usage examples.',
+}
 
-export default Page;
\ No newline at end of file
+export default function Page() {
+  return <PkgRedirect name="gofr/datasource/file/ftp" docsPath="/docs/datasources/getting-started" />
+}
diff --git a/src/app/pkg/gofr/datasource/file/gcs/page.jsx b/src/app/pkg/gofr/datasource/file/gcs/page.jsx
index f8bffb5..17da850 100644
--- a/src/app/pkg/gofr/datasource/file/gcs/page.jsx
+++ b/src/app/pkg/gofr/datasource/file/gcs/page.jsx
@@ -1,16 +1,11 @@
-import React from 'react';
+import { PkgRedirect } from '@/components/PkgRedirect'
 
 
-const Page = () => {
-    return (
-        <div className={`flex justify-center items-center min-h-[70vh]`}>
-            <div className={`text-4xl font-semibold flex gap-3 flex-wrap justify-center`}>
-                <span>
-                </span>
-                <span className={`text-sky-400`}></span>
-            </div>
-        </div>
-    );
-};
+export const metadata = {
+  title: 'gofr/datasource/file/gcs — GoFr Go Package',
+  description: 'Go module path for gofr/datasource/file/gcs. This redirect-only page sends visitors to the GoFr documentation for setup, configuration, and usage examples.',
+}
 
-export default Page;
\ No newline at end of file
+export default function Page() {
+  return <PkgRedirect name="gofr/datasource/file/gcs" docsPath="/docs/datasources/getting-started" />
+}
diff --git a/src/app/pkg/gofr/datasource/file/s3/page.jsx b/src/app/pkg/gofr/datasource/file/s3/page.jsx
index f8bffb5..fc0599d 100644
--- a/src/app/pkg/gofr/datasource/file/s3/page.jsx
+++ b/src/app/pkg/gofr/datasource/file/s3/page.jsx
@@ -1,16 +1,11 @@
-import React from 'react';
+import { PkgRedirect } from '@/components/PkgRedirect'
 
 
-const Page = () => {
-    return (
-        <div className={`flex justify-center items-center min-h-[70vh]`}>
-            <div className={`text-4xl font-semibold flex gap-3 flex-wrap justify-center`}>
-                <span>
-                </span>
-                <span className={`text-sky-400`}></span>
-            </div>
-        </div>
-    );
-};
+export const metadata = {
+  title: 'gofr/datasource/file/s3 — GoFr Go Package',
+  description: 'Go module path for gofr/datasource/file/s3. This redirect-only page sends visitors to the GoFr documentation for setup, configuration, and usage examples.',
+}
 
-export default Page;
\ No newline at end of file
+export default function Page() {
+  return <PkgRedirect name="gofr/datasource/file/s3" docsPath="/docs/datasources/getting-started" />
+}
diff --git a/src/app/pkg/gofr/datasource/file/sftp/page.jsx b/src/app/pkg/gofr/datasource/file/sftp/page.jsx
index f8bffb5..7b06789 100644
--- a/src/app/pkg/gofr/datasource/file/sftp/page.jsx
+++ b/src/app/pkg/gofr/datasource/file/sftp/page.jsx
@@ -1,16 +1,11 @@
-import React from 'react';
+import { PkgRedirect } from '@/components/PkgRedirect'
 
 
-const Page = () => {
-    return (
-        <div className={`flex justify-center items-center min-h-[70vh]`}>
-            <div className={`text-4xl font-semibold flex gap-3 flex-wrap justify-center`}>
-                <span>
-                </span>
-                <span className={`text-sky-400`}></span>
-            </div>
-        </div>
-    );
-};
+export const metadata = {
+  title: 'gofr/datasource/file/sftp — GoFr Go Package',
+  description: 'Go module path for gofr/datasource/file/sftp. This redirect-only page sends visitors to the GoFr documentation for setup, configuration, and usage examples.',
+}
 
-export default Page;
\ No newline at end of file
+export default function Page() {
+  return <PkgRedirect name="gofr/datasource/file/sftp" docsPath="/docs/datasources/getting-started" />
+}
diff --git a/src/app/pkg/gofr/datasource/kv-store/badger/page.jsx b/src/app/pkg/gofr/datasource/kv-store/badger/page.jsx
index f8bffb5..3c138e3 100644
--- a/src/app/pkg/gofr/datasource/kv-store/badger/page.jsx
+++ b/src/app/pkg/gofr/datasource/kv-store/badger/page.jsx
@@ -1,16 +1,11 @@
-import React from 'react';
+import { PkgRedirect } from '@/components/PkgRedirect'
 
 
-const Page = () => {
-    return (
-        <div className={`flex justify-center items-center min-h-[70vh]`}>
-            <div className={`text-4xl font-semibold flex gap-3 flex-wrap justify-center`}>
-                <span>
-                </span>
-                <span className={`text-sky-400`}></span>
-            </div>
-        </div>
-    );
-};
+export const metadata = {
+  title: 'gofr/datasource/kv-store/badger — GoFr Go Package',
+  description: 'Go module path for gofr/datasource/kv-store/badger. Redirects to the GoFr documentation for setup, configuration, and usage examples.',
+}
 
-export default Page;
\ No newline at end of file
+export default function Page() {
+  return <PkgRedirect name="gofr/datasource/kv-store/badger" docsPath="/docs/datasources/getting-started" />
+}
diff --git a/src/app/pkg/gofr/datasource/kv-store/nats/page.jsx b/src/app/pkg/gofr/datasource/kv-store/nats/page.jsx
index f8bffb5..1b56d1f 100644
--- a/src/app/pkg/gofr/datasource/kv-store/nats/page.jsx
+++ b/src/app/pkg/gofr/datasource/kv-store/nats/page.jsx
@@ -1,16 +1,11 @@
-import React from 'react';
+import { PkgRedirect } from '@/components/PkgRedirect'
 
 
-const Page = () => {
-    return (
-        <div className={`flex justify-center items-center min-h-[70vh]`}>
-            <div className={`text-4xl font-semibold flex gap-3 flex-wrap justify-center`}>
-                <span>
-                </span>
-                <span className={`text-sky-400`}></span>
-            </div>
-        </div>
-    );
-};
+export const metadata = {
+  title: 'gofr/datasource/kv-store/nats — GoFr Go Package',
+  description: 'Go module path for gofr/datasource/kv-store/nats. This redirect-only page sends visitors to the GoFr documentation for setup, configuration, and usage examples.',
+}
 
-export default Page;
\ No newline at end of file
+export default function Page() {
+  return <PkgRedirect name="gofr/datasource/kv-store/nats" docsPath="/docs/datasources/getting-started" />
+}
diff --git a/src/app/pkg/gofr/datasource/mongo/page.jsx b/src/app/pkg/gofr/datasource/mongo/page.jsx
index f8bffb5..c27b598 100644
--- a/src/app/pkg/gofr/datasource/mongo/page.jsx
+++ b/src/app/pkg/gofr/datasource/mongo/page.jsx
@@ -1,16 +1,11 @@
-import React from 'react';
+import { PkgRedirect } from '@/components/PkgRedirect'
 
 
-const Page = () => {
-    return (
-        <div className={`flex justify-center items-center min-h-[70vh]`}>
-            <div className={`text-4xl font-semibold flex gap-3 flex-wrap justify-center`}>
-                <span>
-                </span>
-                <span className={`text-sky-400`}></span>
-            </div>
-        </div>
-    );
-};
+export const metadata = {
+  title: 'gofr/datasource/mongo — GoFr Go Package',
+  description: 'Go module path for gofr/datasource/mongo. This redirect-only page sends visitors to the GoFr documentation for setup, configuration, and usage examples.',
+}
 
-export default Page;
\ No newline at end of file
+export default function Page() {
+  return <PkgRedirect name="gofr/datasource/mongo" docsPath="/docs/datasources/mongodb" />
+}
diff --git a/src/app/pkg/gofr/datasource/opentsdb/page.jsx b/src/app/pkg/gofr/datasource/opentsdb/page.jsx
index f8bffb5..2a8e699 100644
--- a/src/app/pkg/gofr/datasource/opentsdb/page.jsx
+++ b/src/app/pkg/gofr/datasource/opentsdb/page.jsx
@@ -1,16 +1,11 @@
-import React from 'react';
+import { PkgRedirect } from '@/components/PkgRedirect'
 
 
-const Page = () => {
-    return (
-        <div className={`flex justify-center items-center min-h-[70vh]`}>
-            <div className={`text-4xl font-semibold flex gap-3 flex-wrap justify-center`}>
-                <span>
-                </span>
-                <span className={`text-sky-400`}></span>
-            </div>
-        </div>
-    );
-};
+export const metadata = {
+  title: 'gofr/datasource/opentsdb — GoFr Go Package',
+  description: 'Go module path for gofr/datasource/opentsdb. This redirect-only page sends visitors to the GoFr documentation for setup, configuration, and usage examples.',
+}
 
-export default Page;
\ No newline at end of file
+export default function Page() {
+  return <PkgRedirect name="gofr/datasource/opentsdb" docsPath="/docs/datasources/opentsdb" />
+}
diff --git a/src/app/pkg/gofr/datasource/oracle/page.jsx b/src/app/pkg/gofr/datasource/oracle/page.jsx
index f8bffb5..8b32fce 100644
--- a/src/app/pkg/gofr/datasource/oracle/page.jsx
+++ b/src/app/pkg/gofr/datasource/oracle/page.jsx
@@ -1,16 +1,11 @@
-import React from 'react';
+import { PkgRedirect } from '@/components/PkgRedirect'
 
 
-const Page = () => {
-    return (
-        <div className={`flex justify-center items-center min-h-[70vh]`}>
-            <div className={`text-4xl font-semibold flex gap-3 flex-wrap justify-center`}>
-                <span>
-                </span>
-                <span className={`text-sky-400`}></span>
-            </div>
-        </div>
-    );
-};
+export const metadata = {
+  title: 'gofr/datasource/oracle — GoFr Go Package',
+  description: 'Go module path for gofr/datasource/oracle. This redirect-only page sends visitors to the GoFr documentation for setup, configuration, and usage examples.',
+}
 
-export default Page;
\ No newline at end of file
+export default function Page() {
+  return <PkgRedirect name="gofr/datasource/oracle" docsPath="/docs/datasources/oracle" />
+}
diff --git a/src/app/pkg/gofr/datasource/pubsub/eventhub/page.jsx b/src/app/pkg/gofr/datasource/pubsub/eventhub/page.jsx
index f8bffb5..300992d 100644
--- a/src/app/pkg/gofr/datasource/pubsub/eventhub/page.jsx
+++ b/src/app/pkg/gofr/datasource/pubsub/eventhub/page.jsx
@@ -1,16 +1,11 @@
-import React from 'react';
+import { PkgRedirect } from '@/components/PkgRedirect'
 
 
-const Page = () => {
-    return (
-        <div className={`flex justify-center items-center min-h-[70vh]`}>
-            <div className={`text-4xl font-semibold flex gap-3 flex-wrap justify-center`}>
-                <span>
-                </span>
-                <span className={`text-sky-400`}></span>
-            </div>
-        </div>
-    );
-};
+export const metadata = {
+  title: 'gofr/datasource/pubsub/eventhub — GoFr Go Package',
+  description: 'Go module path for gofr/datasource/pubsub/eventhub. Redirects to the GoFr documentation for setup, configuration, and usage examples.',
+}
 
-export default Page;
\ No newline at end of file
+export default function Page() {
+  return <PkgRedirect name="gofr/datasource/pubsub/eventhub" docsPath="/docs/datasources/getting-started" />
+}
diff --git a/src/app/pkg/gofr/datasource/pubsub/nats/page.jsx b/src/app/pkg/gofr/datasource/pubsub/nats/page.jsx
index f8bffb5..55e6a29 100644
--- a/src/app/pkg/gofr/datasource/pubsub/nats/page.jsx
+++ b/src/app/pkg/gofr/datasource/pubsub/nats/page.jsx
@@ -1,16 +1,11 @@
-import React from 'react';
+import { PkgRedirect } from '@/components/PkgRedirect'
 
 
-const Page = () => {
-    return (
-        <div className={`flex justify-center items-center min-h-[70vh]`}>
-            <div className={`text-4xl font-semibold flex gap-3 flex-wrap justify-center`}>
-                <span>
-                </span>
-                <span className={`text-sky-400`}></span>
-            </div>
-        </div>
-    );
-};
+export const metadata = {
+  title: 'gofr/datasource/pubsub/nats — GoFr Go Package',
+  description: 'Go module path for gofr/datasource/pubsub/nats. This redirect-only page sends visitors to the GoFr documentation for setup, configuration, and usage examples.',
+}
 
-export default Page;
\ No newline at end of file
+export default function Page() {
+  return <PkgRedirect name="gofr/datasource/pubsub/nats" docsPath="/docs/datasources/getting-started" />
+}
diff --git a/src/app/pkg/gofr/datasource/pubsub/sqs/page.jsx b/src/app/pkg/gofr/datasource/pubsub/sqs/page.jsx
index f8bffb5..b1d0add 100644
--- a/src/app/pkg/gofr/datasource/pubsub/sqs/page.jsx
+++ b/src/app/pkg/gofr/datasource/pubsub/sqs/page.jsx
@@ -1,16 +1,11 @@
-import React from 'react';
+import { PkgRedirect } from '@/components/PkgRedirect'
 
 
-const Page = () => {
-    return (
-        <div className={`flex justify-center items-center min-h-[70vh]`}>
-            <div className={`text-4xl font-semibold flex gap-3 flex-wrap justify-center`}>
-                <span>
-                </span>
-                <span className={`text-sky-400`}></span>
-            </div>
-        </div>
-    );
-};
+export const metadata = {
+  title: 'gofr/datasource/pubsub/sqs — GoFr Go Package',
+  description: 'Go module path for gofr/datasource/pubsub/sqs. This redirect-only page sends visitors to the GoFr documentation for setup, configuration, and usage examples.',
+}
 
-export default Page;
\ No newline at end of file
+export default function Page() {
+  return <PkgRedirect name="gofr/datasource/pubsub/sqs" docsPath="/docs/datasources/getting-started" />
+}
diff --git a/src/app/pkg/gofr/datasource/scylladb/page.jsx b/src/app/pkg/gofr/datasource/scylladb/page.jsx
index f8bffb5..10bd8c4 100644
--- a/src/app/pkg/gofr/datasource/scylladb/page.jsx
+++ b/src/app/pkg/gofr/datasource/scylladb/page.jsx
@@ -1,16 +1,11 @@
-import React from 'react';
+import { PkgRedirect } from '@/components/PkgRedirect'
 
 
-const Page = () => {
-    return (
-        <div className={`flex justify-center items-center min-h-[70vh]`}>
-            <div className={`text-4xl font-semibold flex gap-3 flex-wrap justify-center`}>
-                <span>
-                </span>
-                <span className={`text-sky-400`}></span>
-            </div>
-        </div>
-    );
-};
+export const metadata = {
+  title: 'gofr/datasource/scylladb — GoFr Go Package',
+  description: 'Go module path for gofr/datasource/scylladb. This redirect-only page sends visitors to the GoFr documentation for setup, configuration, and usage examples.',
+}
 
-export default Page;
\ No newline at end of file
+export default function Page() {
+  return <PkgRedirect name="gofr/datasource/scylladb" docsPath="/docs/datasources/scylladb" />
+}
diff --git a/src/app/pkg/gofr/datasource/solr/page.jsx b/src/app/pkg/gofr/datasource/solr/page.jsx
index f8bffb5..8a25315 100644
--- a/src/app/pkg/gofr/datasource/solr/page.jsx
+++ b/src/app/pkg/gofr/datasource/solr/page.jsx
@@ -1,16 +1,11 @@
-import React from 'react';
+import { PkgRedirect } from '@/components/PkgRedirect'
 
 
-const Page = () => {
-    return (
-        <div className={`flex justify-center items-center min-h-[70vh]`}>
-            <div className={`text-4xl font-semibold flex gap-3 flex-wrap justify-center`}>
-                <span>
-                </span>
-                <span className={`text-sky-400`}></span>
-            </div>
-        </div>
-    );
-};
+export const metadata = {
+  title: 'gofr/datasource/solr — GoFr Go Package',
+  description: 'Go module path for gofr/datasource/solr. This redirect-only page sends visitors to the GoFr documentation for setup, configuration, and usage examples.',
+}
 
-export default Page;
\ No newline at end of file
+export default function Page() {
+  return <PkgRedirect name="gofr/datasource/solr" docsPath="/docs/datasources/solr" />
+}
diff --git a/src/app/pkg/gofr/datasource/surrealdb/page.jsx b/src/app/pkg/gofr/datasource/surrealdb/page.jsx
index f8bffb5..89481c9 100644
--- a/src/app/pkg/gofr/datasource/surrealdb/page.jsx
+++ b/src/app/pkg/gofr/datasource/surrealdb/page.jsx
@@ -1,16 +1,11 @@
-import React from 'react';
+import { PkgRedirect } from '@/components/PkgRedirect'
 
 
-const Page = () => {
-    return (
-        <div className={`flex justify-center items-center min-h-[70vh]`}>
-            <div className={`text-4xl font-semibold flex gap-3 flex-wrap justify-center`}>
-                <span>
-                </span>
-                <span className={`text-sky-400`}></span>
-            </div>
-        </div>
-    );
-};
+export const metadata = {
+  title: 'gofr/datasource/surrealdb — GoFr Go Package',
+  description: 'Go module path for gofr/datasource/surrealdb. This redirect-only page sends visitors to the GoFr documentation for setup, configuration, and usage examples.',
+}
 
-export default Page;
\ No newline at end of file
+export default function Page() {
+  return <PkgRedirect name="gofr/datasource/surrealdb" docsPath="/docs/datasources/surrealdb" />
+}
diff --git a/src/app/pkg/layout.jsx b/src/app/pkg/layout.jsx
new file mode 100644
index 0000000..d4f5abc
--- /dev/null
+++ b/src/app/pkg/layout.jsx
@@ -0,0 +1,21 @@
+// Routes under /pkg/** exist only to serve the Go module-import path
+// convention (gofr.dev/pkg/...). When a human or crawler hits one,
+// PkgRedirect bounces them to the equivalent /docs URL via JS.
+//
+// We don't want these vanity URLs in search results: they have no
+// meaningful content and competing with the real /docs pages would
+// dilute SERP rank. `robots: noindex, nofollow` keeps them out.
+//
+// They're also excluded from sitemap.xml in src/app/sitemap.js so
+// crawlers never discover them via that route.
+export const metadata = {
+  robots: {
+    index: false,
+    follow: false,
+    googleBot: { index: false, follow: false },
+  },
+}
+
+export default function Layout({ children }) {
+  return children
+}
diff --git a/src/app/releases/layout.jsx b/src/app/releases/layout.jsx
index 568878a..1d96595 100644
--- a/src/app/releases/layout.jsx
+++ b/src/app/releases/layout.jsx
@@ -1,8 +1,22 @@
 'use client'
-import { ReleasesPage } from '@/components/ReleasesPage'
+
+import { useEffect } from 'react'
+import { useRouter } from 'next/navigation'
 
 const Layout = ({ children }) => {
-  return <ReleasesPage>{children}</ReleasesPage>
+  const router = useRouter()
+
+  useEffect(() => {
+    router.replace('/changelog')
+  }, [router])
+
+  return (
+    <div className="flex min-h-[70vh] items-center justify-center">
+      <p className="text-slate-500">
+        Redirecting to changelog...
+      </p>
+    </div>
+  )
 }
 
 export default Layout
diff --git a/src/app/roadmap/layout.jsx b/src/app/roadmap/layout.jsx
new file mode 100644
index 0000000..421a319
--- /dev/null
+++ b/src/app/roadmap/layout.jsx
@@ -0,0 +1,27 @@
+import React from 'react'
+
+export const metadata = {
+  title: 'GoFr Roadmap — What\u2019s Next',
+  description:
+    'GoFr roadmap, generated automatically from open milestones and enhancement-labeled issues on GitHub. Browse what the maintainers and community are working on next.',
+  metadataBase: new URL('https://gofr.dev'),
+  alternates: { canonical: '/roadmap' },
+  openGraph: {
+    type: 'website',
+    url: 'https://gofr.dev/roadmap',
+    title: 'GoFr Roadmap — What\u2019s Next',
+    description:
+      'Open milestones and enhancement issues, surfaced live from the GoFr repo.',
+    images: [{ url: '/opengraph-image.png', width: 1200, height: 630 }],
+  },
+  twitter: {
+    card: 'summary_large_image',
+    site: '@gofr_dev',
+    title: 'GoFr Roadmap',
+    description: 'What\u2019s next for GoFr — pulled live from GitHub.',
+    images: ['/twitter-image.png'],
+  },
+}
+
+const Layout = ({ children }) => children
+export default Layout
diff --git a/src/app/roadmap/page.jsx b/src/app/roadmap/page.jsx
new file mode 100644
index 0000000..76d8da3
--- /dev/null
+++ b/src/app/roadmap/page.jsx
@@ -0,0 +1,287 @@
+'use client'
+
+import { useMemo, useState } from 'react'
+import Link from 'next/link'
+import data from '@/data/roadmap.json'
+
+// Color hint per label group — keeps tags scannable without inventing
+// a new color system. Anything not listed falls back to slate.
+const labelTone = (l) => {
+  const x = l.toLowerCase()
+  if (/^enhancement$/.test(x)) return 'bg-emerald-500/10 text-emerald-400'
+  if (/datasource|database|sql|redis|mongo|cassandra|clickhouse|kafka|pub|nats/.test(x))
+    return 'bg-amber-500/10 text-amber-400'
+  if (/observ|trace|metric|log/.test(x)) return 'bg-cyan-500/10 text-cyan-400'
+  if (/service|http|grpc|graphql|websocket/.test(x)) return 'bg-violet-500/10 text-violet-400'
+  if (/security|auth|rbac|cors/.test(x)) return 'bg-red-500/10 text-red-400'
+  if (/cli|tools|devops|github_actions/.test(x)) return 'bg-sky-500/10 text-sky-400'
+  if (/good first issue|help wanted/.test(x)) return 'bg-pink-500/10 text-pink-400'
+  if (/bug|fix/.test(x)) return 'bg-orange-500/10 text-orange-400'
+  return 'bg-slate-500/10 text-slate-300'
+}
+
+function formatDate(s) {
+  if (!s) return ''
+  try {
+    return new Date(s).toLocaleDateString('en-US', {
+      year: 'numeric',
+      month: 'short',
+      day: 'numeric',
+    })
+  } catch {
+    return s
+  }
+}
+
+function timeAgo(s) {
+  if (!s) return ''
+  const d = new Date(s)
+  const days = Math.floor((Date.now() - d.getTime()) / 86_400_000)
+  if (days < 1) return 'today'
+  if (days < 2) return 'yesterday'
+  if (days < 30) return `${days}d ago`
+  const months = Math.floor(days / 30)
+  if (months < 12) return `${months}mo ago`
+  const years = Math.floor(days / 365)
+  return `${years}y ago`
+}
+
+function IssueCard({ item }) {
+  return (
+    <Link
+      href={item.url}
+      target="_blank"
+      rel="noopener noreferrer"
+      className="group relative block rounded-xl border border-slate-800 p-4 transition-colors hover:border-sky-500/40"
+    >
+      <div className="flex items-start gap-3">
+        <span className="mt-0.5 font-mono text-xs text-slate-600">#{item.number}</span>
+        <div className="min-w-0 flex-1">
+          <h3 className="text-sm font-medium text-slate-200 group-hover:text-sky-300">
+            {item.title}
+          </h3>
+          <div className="mt-2 flex flex-wrap items-center gap-1.5">
+            {item.labels.slice(0, 5).map((l) => (
+              <span
+                key={l}
+                className={`rounded-full px-2 py-0.5 text-[11px] sm:text-[10px] font-medium ${labelTone(l)}`}
+              >
+                {l}
+              </span>
+            ))}
+          </div>
+          <div className="mt-2 flex items-center gap-3 text-xs sm:text-[11px] text-slate-500">
+            <span>updated {timeAgo(item.updated_at)}</span>
+            {item.comments > 0 && (
+              <span>· {item.comments} comment{item.comments === 1 ? '' : 's'}</span>
+            )}
+          </div>
+        </div>
+      </div>
+    </Link>
+  )
+}
+
+export default function RoadmapPage() {
+  const milestones = data?.milestones ?? []
+  const items = data?.items ?? []
+  const fetchedAt = data?.fetchedAt
+  const repo = data?.repo || 'gofr-dev/gofr'
+
+  // Filter chips: "All" + each unique label + a "No milestone" toggle.
+  const allLabels = useMemo(() => {
+    const counts = {}
+    for (const i of items) for (const l of i.labels) counts[l] = (counts[l] || 0) + 1
+    return Object.entries(counts)
+      .sort((a, b) => b[1] - a[1])
+      .slice(0, 10)
+      .map(([l]) => l)
+  }, [items])
+
+  const [active, setActive] = useState(null) // active label filter or null
+
+  const visible = useMemo(
+    () => (active ? items.filter((i) => i.labels.includes(active)) : items),
+    [items, active],
+  )
+
+  // Group visible items: each milestone → its items, then a final
+  // bucket for items that aren't on any milestone yet.
+  const grouped = useMemo(() => {
+    const byMs = new Map()
+    for (const m of milestones) byMs.set(m.title, { milestone: m, items: [] })
+    const noMs = []
+    for (const it of visible) {
+      if (it.milestone && byMs.has(it.milestone)) byMs.get(it.milestone).items.push(it)
+      else noMs.push(it)
+    }
+    const groups = [...byMs.values()].filter((g) => g.items.length)
+    if (noMs.length) groups.push({ milestone: null, items: noMs })
+    return groups
+  }, [milestones, visible])
+
+  return (
+    <div className="min-h-screen bg-slate-900">
+      <div className="mx-auto max-w-5xl px-4 py-16 sm:px-6 lg:px-8">
+        {/* Header */}
+        <div className="text-center">
+          <h1 className="font-display text-4xl font-bold tracking-tight text-white">
+            Roadmap
+          </h1>
+          <p className="mt-3 text-lg text-slate-400">
+            GoFr already powers production microservices today. The
+            roadmap covers what&rsquo;s being added next &mdash; more datasources,
+            integrations, protocols, and operational ergonomics.
+          </p>
+          <p className="mt-2 text-xs text-slate-500">
+            Generated automatically from open issues on{' '}
+            <Link
+              href={`https://github.com/${repo}/issues`}
+              target="_blank"
+              rel="noopener noreferrer"
+              className="text-sky-400 hover:text-sky-300"
+            >
+              {repo}
+            </Link>
+            {fetchedAt && (
+              <>
+                {' '}
+                · last refreshed {formatDate(fetchedAt)}
+              </>
+            )}
+            .
+          </p>
+        </div>
+
+        {/* Empty state */}
+        {items.length === 0 && (
+          <div className="mt-12 rounded-xl border border-slate-800 p-8 text-center text-slate-400">
+            No roadmap items right now. The roadmap is built from open
+            issues labeled <code className="font-mono">enhancement</code>{' '}
+            (or <code className="font-mono">roadmap</code>) on{' '}
+            <Link
+              href={`https://github.com/${repo}/issues`}
+              target="_blank"
+              rel="noopener noreferrer"
+              className="text-sky-400 hover:text-sky-300"
+            >
+              {repo}
+            </Link>
+            . Open one to suggest a feature.
+          </div>
+        )}
+
+        {/* Milestone progress strip */}
+        {milestones.length > 0 && (
+          <div className="mt-12">
+            <h2 className="text-sm font-semibold uppercase tracking-wider text-slate-500">
+              Milestones
+            </h2>
+            <div className="mt-3 grid gap-3 sm:grid-cols-2">
+              {milestones.map((m) => (
+                <Link
+                  key={m.title}
+                  href={m.url}
+                  target="_blank"
+                  rel="noopener noreferrer"
+                  className="group rounded-xl border border-slate-800 p-4 transition-colors hover:border-sky-500/40"
+                >
+                  <div className="flex items-center justify-between">
+                    <h3 className="font-display text-sm font-medium text-white group-hover:text-sky-300">
+                      {m.title}
+                    </h3>
+                    <span className="text-xs text-slate-500">
+                      {m.due_on ? `due ${formatDate(m.due_on)}` : 'no due date'}
+                    </span>
+                  </div>
+                  {m.description && (
+                    <p className="mt-1 line-clamp-2 text-xs text-slate-400">
+                      {m.description}
+                    </p>
+                  )}
+                  <div className="mt-3">
+                    <div className="h-1.5 w-full overflow-hidden rounded-full bg-slate-800">
+                      <div
+                        className="h-full bg-sky-400"
+                        style={{ width: `${m.progress}%` }}
+                      />
+                    </div>
+                    <p className="mt-1.5 text-xs sm:text-[11px] text-slate-500">
+                      {m.closed_issues} of {m.open_issues + m.closed_issues}{' '}
+                      done · {m.progress}%
+                    </p>
+                  </div>
+                </Link>
+              ))}
+            </div>
+          </div>
+        )}
+
+        {/* Filter chips */}
+        {items.length > 0 && allLabels.length > 0 && (
+          <div className="mt-12 flex flex-wrap gap-2">
+            <button
+              onClick={() => setActive(null)}
+              className={`rounded-full px-3 py-1 text-xs font-medium transition-colors ${
+                !active
+                  ? 'bg-sky-500 text-white'
+                  : 'bg-slate-800 text-slate-400 hover:text-white'
+              }`}
+            >
+              All ({items.length})
+            </button>
+            {allLabels.map((l) => {
+              const count = items.filter((i) => i.labels.includes(l)).length
+              return (
+                <button
+                  key={l}
+                  onClick={() => setActive(active === l ? null : l)}
+                  className={`rounded-full px-3 py-1 text-xs font-medium transition-colors ${
+                    active === l
+                      ? 'bg-sky-500 text-white'
+                      : 'bg-slate-800 text-slate-400 hover:text-white'
+                  }`}
+                >
+                  {l} ({count})
+                </button>
+              )
+            })}
+          </div>
+        )}
+
+        {/* Grouped issues */}
+        <div className="mt-8 space-y-12">
+          {grouped.map((g) => (
+            <section key={g.milestone?.title || 'no-milestone'}>
+              {g.milestone && (
+                <h2 className="font-display text-lg font-semibold text-white">
+                  {g.milestone.title}
+                </h2>
+              )}
+              {g.milestone?.description && (
+                <p className="mt-1 text-sm text-slate-400">{g.milestone.description}</p>
+              )}
+              <div className="mt-4 grid gap-3 sm:grid-cols-2">
+                {g.items.map((item) => (
+                  <IssueCard key={item.number} item={item} />
+                ))}
+              </div>
+            </section>
+          ))}
+        </div>
+
+        {/* CTA */}
+        <div className="mt-12 text-center">
+          <Link
+            href={`https://github.com/${repo}/issues/new/choose`}
+            target="_blank"
+            rel="noopener noreferrer"
+            className="inline-flex items-center gap-1.5 rounded-full bg-sky-300 px-4 py-2 text-sm font-semibold text-slate-900 hover:bg-sky-200"
+          >
+            Suggest a feature →
+          </Link>
+        </div>
+      </div>
+    </div>
+  )
+}
diff --git a/src/app/showcase/companies.json b/src/app/showcase/companies.json
new file mode 100644
index 0000000..edaa288
--- /dev/null
+++ b/src/app/showcase/companies.json
@@ -0,0 +1,11 @@
+[
+  { "name": "American Express", "industry": "Financial Services" },
+  { "name": "IBM", "industry": "Technology" },
+  { "name": "McAfee", "industry": "Cybersecurity" },
+  { "name": "Blinkit", "industry": "E-commerce" },
+  { "name": "Walmart", "industry": "Retail" },
+  { "name": "Doceree", "industry": "AdTech" },
+  { "name": "Mydbops", "industry": "Database Consulting" },
+  { "name": "Guidewire", "industry": "Insurance Technology" },
+  { "name": "Weave", "industry": "Technology" }
+]
diff --git a/src/app/showcase/layout.jsx b/src/app/showcase/layout.jsx
new file mode 100644
index 0000000..82dd83a
--- /dev/null
+++ b/src/app/showcase/layout.jsx
@@ -0,0 +1,27 @@
+import React from 'react'
+
+export const metadata = {
+  title: 'GoFr Showcase — Companies & Engineers Using GoFr in Production',
+  description:
+    'Discover the engineers and companies running GoFr in production. From Fortune 500 enterprises to indie teams, see who is using the opinionated Go microservice framework.',
+  metadataBase: new URL('https://gofr.dev'),
+  alternates: { canonical: '/showcase' },
+  openGraph: {
+    type: 'website',
+    url: 'https://gofr.dev/showcase',
+    title: 'GoFr Showcase — Engineers Using GoFr in Production',
+    description:
+      'Companies and engineers running GoFr in production microservices, from Fortune 500 enterprises to indie teams.',
+    images: [{ url: '/opengraph-image.png', width: 1200, height: 630 }],
+  },
+  twitter: {
+    card: 'summary_large_image',
+    site: '@gofr_dev',
+    title: 'GoFr Showcase',
+    description: 'Engineers and companies using GoFr in production.',
+    images: ['/twitter-image.png'],
+  },
+}
+
+const Layout = ({ children }) => children
+export default Layout
diff --git a/src/app/showcase/page.jsx b/src/app/showcase/page.jsx
new file mode 100644
index 0000000..b0a0c68
--- /dev/null
+++ b/src/app/showcase/page.jsx
@@ -0,0 +1,153 @@
+'use client'
+
+import { useEffect, useState } from 'react'
+import Image from 'next/image'
+import Link from 'next/link'
+import { formatNumber } from '@/lib/common'
+import companies from './companies.json'
+import testimonials from '../../../utils/testimonials.json'
+
+import company1 from '@/images/doceree.svg'
+import company2 from '@/images/americanExpress.svg'
+import company3 from '@/images/ibm.svg'
+import company4 from '@/images/mydbops.svg'
+import company5 from '@/images/guidewire.svg'
+import company6 from '@/images/weave.svg'
+import company8 from '@/images/blinkit.svg'
+import company10 from '@/images/mcafee.svg'
+import company11 from '@/images/walmart.svg'
+
+const logoMap = {
+  'American Express': company2,
+  'IBM': company3,
+  'McAfee': company10,
+  'Blinkit': company8,
+  'Walmart': company11,
+  'Doceree': company1,
+  'Mydbops': company4,
+  'Guidewire': company5,
+  'Weave': company6,
+}
+
+export default function ShowcasePage() {
+  // Display the cached count if available; otherwise leave empty rather
+  // than show a stale fallback ("3500+" was years out of date).
+  const [githubStars, setGithubStars] = useState(null)
+
+  useEffect(() => {
+    let cached = localStorage.getItem('githubStars')
+    if (cached) {
+      setGithubStars(formatNumber(Number(cached)))
+      return
+    }
+    // No cached value — fetch live so first-time visitors see a number.
+    fetch('https://api.github.com/repos/gofr-dev/gofr')
+      .then((r) => (r.ok ? r.json() : null))
+      .then((d) => {
+        if (d?.watchers) {
+          setGithubStars(formatNumber(d.watchers))
+          try { localStorage.setItem('githubStars', String(d.watchers)) } catch {}
+        }
+      })
+      .catch(() => {})
+  }, [])
+
+  return (
+    <div className="min-h-screen bg-slate-900">
+      <div className="mx-auto max-w-5xl px-4 py-16 sm:px-6 lg:px-8">
+        {/* Hero */}
+        <div className="text-center">
+          <h1 className="font-display text-4xl font-bold tracking-tight text-white">
+            Used by engineers around the world
+          </h1>
+          {githubStars && (
+            <div className="mt-4 inline-flex items-center gap-2 rounded-full bg-slate-800 px-4 py-2 text-sm text-slate-300">
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="#fcd34d" className="h-4 w-4">
+                <path fillRule="evenodd" d="M10.868 2.884c-.321-.772-1.415-.772-1.736 0l-1.83 4.401-4.753.381c-.833.067-1.171 1.107-.536 1.651l3.62 3.102-1.106 4.637c-.194.813.691 1.456 1.405 1.02L10 15.591l4.069 2.485c.713.436 1.598-.207 1.404-1.02l-1.106-4.637 3.62-3.102c.635-.544.297-1.584-.536-1.65l-4.752-.382-1.831-4.401z" clipRule="evenodd" />
+              </svg>
+              {githubStars} stars on GitHub
+            </div>
+          )}
+        </div>
+
+        {/* Company Grid */}
+        <div className="mt-16 grid grid-cols-2 gap-4 sm:grid-cols-3 md:grid-cols-5">
+          {companies.map((company) => (
+            <div
+              key={company.name}
+              className="group relative flex flex-col items-center rounded-xl border border-slate-800 p-6 transition-all hover:border-transparent"
+            >
+              <div className="absolute -inset-px rounded-xl border-2 border-transparent opacity-0 transition-opacity [background:linear-gradient(var(--quick-links-hover-bg,theme(colors.sky.50)),var(--quick-links-hover-bg,theme(colors.sky.50)))_padding-box,linear-gradient(to_top,theme(colors.indigo.400),theme(colors.cyan.400),theme(colors.sky.500))_border-box] group-hover:opacity-100 dark:[--quick-links-hover-bg:theme(colors.slate.800)]" />
+              <div className="relative">
+                {logoMap[company.name] && (
+                  <Image
+                    src={logoMap[company.name]}
+                    alt={company.name}
+                    width={120}
+                    height={40}
+                    className="h-10 w-auto object-contain"
+                  />
+                )}
+                <p className="mt-3 text-center text-xs text-slate-500">{company.industry}</p>
+              </div>
+            </div>
+          ))}
+        </div>
+
+        {/* Testimonials */}
+        <div className="mt-20">
+          <h2 className="text-center font-display text-2xl font-bold text-white">
+            What Engineers Say
+          </h2>
+          <div className="mt-8 grid gap-6 md:columns-2 md:grid-cols-2">
+            {testimonials.map((t, i) => (
+              <div
+                key={i}
+                className="rounded-xl border border-slate-800 p-6"
+              >
+                <p className="text-sm leading-relaxed text-slate-400">
+                  &ldquo;{t.quote}&rdquo;
+                </p>
+                <div className="mt-4 flex items-center gap-3">
+                  {t.profile && (
+                    <Image
+                      src={t.profile}
+                      alt={t.author}
+                      width={36}
+                      height={36}
+                      className="rounded-full"
+                      unoptimized
+                    />
+                  )}
+                  <div>
+                    <p className="text-sm font-medium text-white">{t.author}</p>
+                    <p className="text-xs text-slate-500">{t.role}</p>
+                  </div>
+                </div>
+              </div>
+            ))}
+          </div>
+        </div>
+
+        {/* CTA — asking for a testimonial rather than a company logo */}
+        {/* keeps the credibility signal individual-developer-shaped */}
+        {/* (which matches who actually adopts GoFr) instead of pushing */}
+        {/* contributors to get corporate sign-off they may not have. */}
+        <div className="mt-16 text-center">
+          <p className="text-slate-400">Using GoFr in production?</p>
+          <Link
+            href="https://github.com/gofr-dev/gofr/issues/new?title=Testimonial:+How+I+use+GoFr&body=Name:+%0ARole+/+team:+%0AHow+we+use+GoFr:+%0AHappy+to+be+quoted+publicly:+yes/no"
+            target="_blank"
+            className="mt-2 inline-flex items-center gap-1.5 text-sm font-medium text-sky-400 hover:text-sky-300"
+          >
+            Share a testimonial
+            <svg className="h-3.5 w-3.5" viewBox="0 0 12 12" fill="none">
+              <path d="M3.5 3.5h5v5" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" />
+              <path d="M8.5 3.5L3 9" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" />
+            </svg>
+          </Link>
+        </div>
+      </div>
+    </div>
+  )
+}
diff --git a/src/app/sitemap.js b/src/app/sitemap.js
new file mode 100644
index 0000000..0a2ab06
--- /dev/null
+++ b/src/app/sitemap.js
@@ -0,0 +1,106 @@
+import { execSync } from 'node:child_process'
+import fs from 'node:fs'
+import path from 'node:path'
+import fg from 'fast-glob'
+
+// Dynamic sitemap. With Next.js `output: 'export'`, this runs at build
+// time and emits `out/sitemap.xml`. Routes are discovered by globbing
+// the app router so new pages appear automatically.
+//
+// Per the 2025-26 SEO research:
+//   - Google actively uses <lastmod> when it's accurate; we derive
+//     each route's lastmod from `git log` (or fs mtime as fallback).
+//   - <changefreq> and <priority> are explicitly ignored by Google
+//     and largely ignored by Bing, so we don't emit them. (Next's
+//     sitemap helper expects them as optional fields.)
+
+const SITE_URL = 'https://gofr.dev'
+
+// Files to include even though they're not Next.js routes — published
+// at the public root with their own meaning. Without listing them
+// here, the sitemap silently omits them.
+const STATIC_FILES = ['/llms.txt', '/llms-full.txt', '/AGENTS.md', '/robots.txt']
+
+const EXCLUDED_PATTERNS = [
+  /\/api\//,
+  /\/certificate\//,
+  /\/hackathon\b/,
+  // /pkg/** are JS-redirect stubs to the real /docs/** pages, kept
+  // for the gofr.dev/pkg/... Go-module import path convention. They
+  // have no SEO content (PkgRedirect just sets window.location), and
+  // listing them as crawl targets dilutes the real docs in SERPs.
+  /^\/pkg\//,
+  // /cli/gofr is similar — a metadata-only landing for `go install`
+  // discoverability, not a navigable page.
+  /^\/cli\//,
+  // /releases is a redirect to /changelog, no unique content.
+  /^\/releases$/,
+]
+
+function pageFileToRoute(absFile) {
+  const repoRoot = path.resolve(process.cwd())
+  const rel = path
+    .relative(path.join(repoRoot, 'src/app'), absFile)
+    .replace(/\\/g, '/')
+  const route = '/' + rel.replace(/\/?page\.(md|jsx|tsx|ts|js)$/, '')
+  if (route === '/' || route === '') return '/'
+  return route
+}
+
+// Last commit date for a file (ISO). Falls back to fs mtime when git
+// is unavailable (CI sandboxes, untracked files, etc.). Honest
+// "last actually edited" beats "last built" — Google trains on the
+// signal and discounts sitemaps that bump every URL on every build.
+function lastModForFile(absFile) {
+  try {
+    const out = execSync(`git log -1 --format=%cI -- "${absFile}"`, {
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'ignore'],
+    }).trim()
+    if (out) return new Date(out)
+  } catch {
+    // git unavailable or file untracked — fall through.
+  }
+  try {
+    return fs.statSync(absFile).mtime
+  } catch {
+    return new Date()
+  }
+}
+
+export default async function sitemap() {
+  const repoRoot = path.resolve(process.cwd())
+  const files = await fg(
+    ['src/app/**/page.md', 'src/app/**/page.jsx', 'src/app/**/page.tsx'],
+    { cwd: repoRoot, absolute: true, ignore: ['**/node_modules/**'] },
+  )
+
+  const seen = new Set()
+  const entries = []
+
+  for (const absFile of files) {
+    const route = pageFileToRoute(absFile)
+    if (EXCLUDED_PATTERNS.some((re) => re.test(route))) continue
+    if (route.includes('[')) continue
+    if (seen.has(route)) continue
+    seen.add(route)
+
+    entries.push({
+      url: SITE_URL + route,
+      lastModified: lastModForFile(absFile),
+    })
+  }
+
+  for (const file of STATIC_FILES) {
+    const absFile = path.join(repoRoot, 'public', file.replace(/^\//, ''))
+    if (!fs.existsSync(absFile)) continue
+    if (seen.has(file)) continue
+    seen.add(file)
+    entries.push({
+      url: SITE_URL + file,
+      lastModified: lastModForFile(absFile),
+    })
+  }
+
+  return entries
+}
diff --git a/src/app/sitemap.xml b/src/app/sitemap.xml
deleted file mode 100644
index 9b5e3a3..0000000
--- a/src/app/sitemap.xml
+++ /dev/null
@@ -1,189 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
-	<url>
-		<loc>https://gofr.dev/</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>1.0</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.9</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/advanced-guide/handling-file</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.7</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/advanced-guide/injecting-databases-drivers</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.7</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/quick-start/connecting-redis</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.8</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/advanced-guide/using-publisher-subscriber</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.7</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/advanced-guide/dealing-with-sql</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.7</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/advanced-guide/key-value-store</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.7</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/quick-start/introduction</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.8</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/quick-start/configuration</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.8</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/quick-start/connecting-mysql</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.8</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/quick-start/observability</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.8</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/quick-start/add-rest-handlers</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.8</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/advanced-guide/using-cron</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.7</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/advanced-guide/overriding-default</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.7</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/advanced-guide/remote-log-level-change</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.7</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/advanced-guide/publishing-custom-metrics</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.7</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/advanced-guide/custom-spans-in-tracing</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.7</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/advanced-guide/middlewares</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.7</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/advanced-guide/http-communication</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.7</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/advanced-guide/http-authentication</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.7</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/advanced-guide/circuit-breaker</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.7</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/advanced-guide/monitoring-service-health</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.7</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/advanced-guide/handling-data-migrations</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.7</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/advanced-guide/grpc</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.7</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/advanced-guide/swagger-documentation</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.7</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/advanced-guide/gofr-errors</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.7</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/advanced-guide/websocket</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.7</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/references/context</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.6</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/references/configs</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.6</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-	<url>
-		<loc>https://gofr.dev/docs/references/testing</loc>
-		<lastmod>2024-10-09T13:34:20+00:00</lastmod>
-		<priority>0.6</priority>
-		<changefreq>weekly</changefreq>
-	</url>
-</urlset>
\ No newline at end of file
diff --git a/src/app/team/layout.jsx b/src/app/team/layout.jsx
new file mode 100644
index 0000000..142e88f
--- /dev/null
+++ b/src/app/team/layout.jsx
@@ -0,0 +1,38 @@
+import React from 'react'
+
+export const metadata = {
+  title: 'Team — The People Behind GoFr',
+  description:
+    'The creator and maintainers behind GoFr, plus the broader community of contributors who ship the framework.',
+  metadataBase: new URL('https://gofr.dev'),
+  alternates: { canonical: '/team' },
+  openGraph: {
+    type: 'website',
+    url: 'https://gofr.dev/team',
+    title: 'Team — The People Behind GoFr',
+    description:
+      'Creator, maintainers, and contributors building GoFr.',
+    images: [{ url: '/opengraph-image.png', width: 1200, height: 630 }],
+  },
+  twitter: {
+    card: 'summary_large_image',
+    site: '@gofr_dev',
+    title: 'GoFr Team',
+    description: 'The people behind GoFr.',
+    images: ['/twitter-image.png'],
+  },
+}
+
+// Preconnect to GitHub's avatar CDN — every team card and every
+// contributor avatar dot pulls from avatars.githubusercontent.com,
+// so opening the connection early saves ~200-400ms of DNS+TLS RTT
+// per visitor on first paint of the contributor wall.
+const Layout = ({ children }) => (
+  <>
+    <link rel="preconnect" href="https://avatars.githubusercontent.com" crossOrigin="anonymous" />
+    <link rel="dns-prefetch" href="https://avatars.githubusercontent.com" />
+    {children}
+  </>
+)
+
+export default Layout
diff --git a/src/app/team/page.jsx b/src/app/team/page.jsx
new file mode 100644
index 0000000..cd4a0e4
--- /dev/null
+++ b/src/app/team/page.jsx
@@ -0,0 +1,292 @@
+'use client'
+
+import Link from 'next/link'
+import data from '@/data/team-enriched.json'
+
+// Initials avatar fallback for team members without a GitHub handle
+// (so we don't pull a profile photo). Matches the existing design
+// vocabulary — slate surface, large display font.
+function InitialsAvatar({ name, className = '' }) {
+  const initials = (name || '?')
+    .split(/\s+/)
+    .filter(Boolean)
+    .map((w) => w[0])
+    .slice(0, 2)
+    .join('')
+    .toUpperCase()
+  return (
+    <div
+      className={`flex items-center justify-center rounded-full bg-slate-800 text-slate-300 ${className}`}
+      aria-hidden="true"
+    >
+      <span className="font-display text-lg font-semibold">{initials}</span>
+    </div>
+  )
+}
+
+function GithubIcon(props) {
+  return (
+    <svg viewBox="0 0 16 16" fill="currentColor" {...props}>
+      <path d="M8 0C3.58 0 0 3.58 0 8C0 11.54 2.29 14.53 5.47 15.59C5.87 15.66 6.02 15.42 6.02 15.21C6.02 15.02 6.01 14.39 6.01 13.72C4 14.09 3.48 13.23 3.32 12.78C3.23 12.55 2.84 11.84 2.5 11.65C2.22 11.5 1.82 11.13 2.49 11.12C3.12 11.11 3.57 11.7 3.72 11.94C4.44 13.15 5.59 12.81 6.05 12.6C6.12 12.08 6.33 11.73 6.56 11.53C4.78 11.33 2.92 10.64 2.92 7.58C2.92 6.71 3.23 5.99 3.74 5.43C3.66 5.23 3.38 4.41 3.82 3.31C3.82 3.31 4.49 3.1 6.02 4.13C6.66 3.95 7.34 3.86 8.02 3.86C8.7 3.86 9.38 3.95 10.02 4.13C11.55 3.09 12.22 3.31 12.22 3.31C12.66 4.41 12.38 5.23 12.3 5.43C12.81 5.99 13.12 6.7 13.12 7.58C13.12 10.65 11.25 11.33 9.47 11.53C9.76 11.78 10.01 12.26 10.01 13.01C10.01 14.08 10 14.94 10 15.21C10 15.42 10.15 15.67 10.55 15.59C13.71 14.53 16 11.53 16 8C16 3.58 12.42 0 8 0Z" />
+    </svg>
+  )
+}
+
+function LinkedinIcon(props) {
+  return (
+    <svg viewBox="0 0 24 24" fill="currentColor" {...props}>
+      <path d="M20.447 20.452h-3.554v-5.569c0-1.328-.027-3.037-1.852-3.037-1.853 0-2.136 1.445-2.136 2.939v5.667H9.351V9h3.414v1.561h.046c.477-.9 1.637-1.85 3.37-1.85 3.601 0 4.267 2.37 4.267 5.455v6.286zM5.337 7.433c-1.144 0-2.063-.926-2.063-2.065 0-1.138.92-2.063 2.063-2.063 1.14 0 2.064.925 2.064 2.063 0 1.139-.925 2.065-2.064 2.065zm1.782 13.019H3.555V9h3.564v11.452zM22.225 0H1.771C.792 0 0 .774 0 1.729v20.542C0 23.227.792 24 1.771 24h20.451C23.2 24 24 23.227 24 22.271V1.729C24 .774 23.2 0 22.222 0h.003z" />
+    </svg>
+  )
+}
+
+function TeamCard({ member }) {
+  const gh = member.github_data
+  // Photo precedence: explicit `photo` in team.json (e.g. for members
+  // without a GitHub handle) → GitHub avatar → initials fallback.
+  const avatar = member.photo || gh?.avatar_url
+
+  return (
+    <div className="group relative flex flex-col rounded-2xl border border-slate-800 bg-slate-900/40 p-6 transition-colors hover:border-sky-500/40 hover:bg-slate-900/70">
+      {/* Header row: avatar + identity. Left-aligned reads better */}
+      {/* than centred when there's location prose below. */}
+      <div className="flex items-center gap-4">
+        {avatar ? (
+          // eslint-disable-next-line @next/next/no-img-element
+          <img
+            src={avatar}
+            alt={`${member.name} avatar`}
+            width={72}
+            height={72}
+            className="h-[72px] w-[72px] flex-none rounded-full bg-slate-800 object-cover ring-1 ring-slate-700 transition-all group-hover:ring-2 group-hover:ring-sky-400"
+            loading="lazy"
+          />
+        ) : (
+          <InitialsAvatar name={member.name} className="h-[72px] w-[72px] flex-none" />
+        )}
+        <div className="min-w-0">
+          <p className="font-display text-base font-semibold text-white">
+            {member.name}
+          </p>
+          <p className="mt-0.5 text-[11px] font-medium uppercase tracking-wider text-sky-400">
+            {member.role}
+          </p>
+          {gh?.location && (
+            <p className="mt-1 truncate text-xs text-slate-500">
+              {gh.location}
+            </p>
+          )}
+        </div>
+      </div>
+
+      <div className="mt-5 flex items-center gap-3 border-t border-slate-800/80 pt-4">
+        {gh?.profile_url && (
+          <Link
+            href={gh.profile_url}
+            target="_blank"
+            rel="noopener noreferrer"
+            aria-label={`${member.name} on GitHub`}
+            className="inline-flex min-h-[36px] min-w-[36px] items-center justify-center p-2 -m-2 text-slate-500 transition-colors hover:text-slate-300"
+          >
+            <GithubIcon className="h-4 w-4" />
+          </Link>
+        )}
+        {member.linkedin && (
+          <Link
+            href={member.linkedin}
+            target="_blank"
+            rel="noopener noreferrer"
+            aria-label={`${member.name} on LinkedIn`}
+            className="inline-flex min-h-[36px] min-w-[36px] items-center justify-center p-2 -m-2 text-slate-500 transition-colors hover:text-blue-400"
+          >
+            <LinkedinIcon className="h-4 w-4" />
+          </Link>
+        )}
+      </div>
+    </div>
+  )
+}
+
+// Order the core team for display: Creator pinned first, then
+// Maintainers sorted by their commit count to gofr-dev/gofr (highest
+// first). Anyone without a contribution number sinks to the bottom of
+// the maintainer block. Source-of-truth ordering in team.json is left
+// alone so this is purely a render-time sort.
+function sortTeam(team) {
+  const isCreator = (m) => /creator/i.test(m.role || '')
+  const commits = (m) => m.github_data?.gofr_contributions ?? -1
+
+  return [...team].sort((a, b) => {
+    if (isCreator(a) && !isCreator(b)) return -1
+    if (!isCreator(a) && isCreator(b)) return 1
+    return commits(b) - commits(a)
+  })
+}
+
+export default function TeamPage() {
+  const team = sortTeam(data?.team ?? [])
+  const contributors = data?.contributors ?? []
+
+  return (
+    <div className="min-h-screen bg-slate-900">
+      <div className="mx-auto max-w-5xl px-4 py-16 sm:px-6 lg:px-8">
+        {/* Header */}
+        <div className="text-center">
+          <h1 className="font-display text-4xl font-bold tracking-tight text-white">
+            The team
+          </h1>
+          <p className="mt-3 text-lg text-slate-400">
+            GoFr is built by a small core team and a wider community of
+            contributors. Here are the people behind it.
+          </p>
+        </div>
+
+        {/* Core team — auto-derives column count from team.length so */}
+        {/* small teams stay centered (e.g. 3 → grid-cols-3, 4 → -4). */}
+        <div className="mt-12">
+          <div
+            className={`mx-auto grid gap-4 sm:grid-cols-2 ${
+              team.length <= 3
+                ? 'lg:grid-cols-3 lg:max-w-3xl'
+                : team.length === 4
+                ? 'lg:grid-cols-4'
+                : 'lg:grid-cols-3'
+            }`}
+          >
+            {team.map((m) => (
+              <TeamCard key={m.name} member={m} />
+            ))}
+          </div>
+        </div>
+
+        {/* Top contributors — visual hierarchy step between the */}
+        {/* maintainer cards above (large, with bio + socials) and */}
+        {/* the full contributor flow below (40px avatar wall). */}
+        {/* */}
+        {/* Ranking is a composite score computed at fetch time: */}
+        {/*   1·commits + 5·PRs merged + 2·reviews + 0.5·comments */}
+        {/* The fetch script (utils/fetch-team.mjs) scores the top 15 */}
+        {/* by raw commit count and re-sorts by composite, so a heavy */}
+        {/* reviewer with modest commits surfaces above a one-time */}
+        {/* bulk-commit author. The footnote under the heading sets */}
+        {/* expectations about what's measured. */}
+        {contributors.length > 0 && (
+          <div className="mt-20">
+            <h2 className="text-center font-display text-2xl font-bold text-white">
+              Top contributors
+            </h2>
+            <p className="mt-2 text-center text-sm text-slate-400">
+              Ranked by GitHub-visible contributions to{' '}
+              <Link
+                href="https://github.com/gofr-dev/gofr"
+                target="_blank"
+                rel="noopener noreferrer"
+                className="text-sky-400 hover:text-sky-300"
+              >
+                gofr-dev/gofr
+              </Link>
+              {' '}— commits, merged PRs, reviews, and comments combined.
+            </p>
+
+            <div className="mx-auto mt-8 grid max-w-4xl gap-3 sm:grid-cols-2 md:grid-cols-3 lg:grid-cols-5">
+              {contributors.slice(0, 5).map((c) => {
+                // Build a tiny secondary line that surfaces whichever
+                // signal is non-zero beyond commits — keeps the card
+                // honest without crowding the layout.
+                const extras = []
+                if (c.prs_merged) extras.push(`${c.prs_merged} PR${c.prs_merged === 1 ? '' : 's'}`)
+                if (c.reviews_authored) extras.push(`${c.reviews_authored} review${c.reviews_authored === 1 ? '' : 's'}`)
+                return (
+                  <Link
+                    key={c.login}
+                    href={c.profile_url}
+                    target="_blank"
+                    rel="noopener noreferrer"
+                    className="group flex flex-col items-center rounded-xl border border-slate-800 bg-slate-900/40 p-4 text-center transition-colors hover:border-sky-500/40"
+                    title={`${c.contributions} commits · ${c.prs_merged || 0} PRs · ${c.reviews_authored || 0} reviews · ${c.comments_authored || 0} comments`}
+                  >
+                    {/* eslint-disable-next-line @next/next/no-img-element */}
+                    <img
+                      src={c.avatar_url}
+                      alt={`${c.login} avatar`}
+                      width={64}
+                      height={64}
+                      className="h-16 w-16 rounded-full bg-slate-800 ring-1 ring-slate-700 transition-all group-hover:ring-2 group-hover:ring-sky-400"
+                      loading="lazy"
+                    />
+                    <p className="mt-3 truncate font-display text-sm font-semibold text-white">
+                      {c.login}
+                    </p>
+                    <p className="mt-1 text-[11px] uppercase tracking-wider text-sky-400">
+                      {c.contributions} commits
+                    </p>
+                    {extras.length > 0 && (
+                      <p className="mt-0.5 text-[10px] text-slate-500">
+                        {extras.join(' · ')}
+                      </p>
+                    )}
+                  </Link>
+                )
+              })}
+            </div>
+          </div>
+        )}
+
+        {/* Contributors grid */}
+        {contributors.length > 0 && (
+          <div className="mt-16">
+            <h2 className="text-center font-display text-2xl font-bold text-white">
+              {contributors.length}+ contributors
+            </h2>
+            <p className="mt-2 text-center text-sm text-slate-400">
+              Everyone who has shipped code, docs, or community work to{' '}
+              <Link
+                href="https://github.com/gofr-dev/gofr"
+                target="_blank"
+                rel="noopener noreferrer"
+                className="text-sky-400 hover:text-sky-300"
+              >
+                gofr-dev/gofr
+              </Link>
+              .
+            </p>
+
+            <div className="mt-8 flex flex-wrap justify-center gap-2">
+              {contributors.map((c) => (
+                <Link
+                  key={c.login}
+                  href={c.profile_url}
+                  target="_blank"
+                  rel="noopener noreferrer"
+                  title={`${c.login} · ${c.contributions} contributions`}
+                  className="group block"
+                >
+                  {/* eslint-disable-next-line @next/next/no-img-element */}
+                  <img
+                    src={c.avatar_url}
+                    alt={c.login}
+                    width={40}
+                    height={40}
+                    className="h-10 w-10 rounded-full bg-slate-800 ring-1 ring-slate-700 transition-all group-hover:ring-2 group-hover:ring-sky-400"
+                    loading="lazy"
+                  />
+                </Link>
+              ))}
+            </div>
+
+            <div className="mt-10 text-center">
+              <Link
+                href="https://github.com/gofr-dev/gofr/blob/main/CONTRIBUTING.md"
+                target="_blank"
+                rel="noopener noreferrer"
+                className="inline-flex items-center gap-1.5 rounded-full bg-sky-300 px-4 py-2 text-sm font-semibold text-slate-900 hover:bg-sky-200"
+              >
+                Contribute to GoFr →
+              </Link>
+            </div>
+          </div>
+        )}
+      </div>
+    </div>
+  )
+}
diff --git a/src/app/why-gofr/layout.jsx b/src/app/why-gofr/layout.jsx
new file mode 100644
index 0000000..b9d1c77
--- /dev/null
+++ b/src/app/why-gofr/layout.jsx
@@ -0,0 +1,4 @@
+import { MarketingPage } from '@/components/MarketingPage'
+
+const Layout = ({ children }) => <MarketingPage>{children}</MarketingPage>
+export default Layout
diff --git a/src/components/Accordion.jsx b/src/components/Accordion.jsx
index b7f7cf6..1c50850 100644
--- a/src/components/Accordion.jsx
+++ b/src/components/Accordion.jsx
@@ -41,8 +41,14 @@ const AccordionCard = ({ data }) => {
   }, [titleRef.current])
 
   return (
-    <div
-      className={`group relative flex cursor-pointer flex-col gap-1 overflow-hidden rounded-md border border-slate-200 p-2 transition-all duration-500 dark:border-slate-800`}
+    // Native <button> instead of <div onClick>: keyboard-activatable
+    // by default (Enter / Space), reachable in tab order, exposes
+    // role=button to assistive tech. aria-expanded mirrors the open
+    // state so screen readers announce open/closed correctly.
+    <button
+      type="button"
+      aria-expanded={isOpen}
+      className={`group relative flex w-full cursor-pointer flex-col gap-1 overflow-hidden rounded-md border border-slate-200 p-2 text-left transition-all duration-500 focus:outline-none focus-visible:ring-2 focus-visible:ring-sky-400 dark:border-slate-800`}
       style={{
         height: titleHeight + height,
       }}
@@ -69,18 +75,20 @@ const AccordionCard = ({ data }) => {
             <span ref={titleRef} className={`text-sm font-semibold md:text-xl`}>
               {data.title}
             </span>
-            <button>
-              <Image
-                src={ArrowRight}
-                alt={'arrow-right'}
-                width={20}
-                height={20}
-                className={`transition-all duration-500 ${
-                  isOpen ? 'rotate-90' : ''
-                }`}
-                unoptimized
-              />
-            </button>
+            {/* Decorative chevron — the parent <button> already */}
+            {/* handles activation. aria-hidden + alt="" prevents the */}
+            {/* image from being announced as a separate element. */}
+            <Image
+              src={ArrowRight}
+              alt=""
+              aria-hidden="true"
+              width={20}
+              height={20}
+              className={`transition-all duration-500 ${
+                isOpen ? 'rotate-90' : ''
+              }`}
+              unoptimized
+            />
           </div>
           <AnimateHeight
             onChange={(w) => {
@@ -96,6 +104,6 @@ const AccordionCard = ({ data }) => {
           </AnimateHeight>
         </div>
       </div>
-    </div>
+    </button>
   )
 }
diff --git a/src/components/Answer.jsx b/src/components/Answer.jsx
new file mode 100644
index 0000000..edd49c6
--- /dev/null
+++ b/src/components/Answer.jsx
@@ -0,0 +1,37 @@
+import clsx from 'clsx'
+
+import { Icon } from '@/components/Icon'
+
+// Answer renders a direct-answer callout intended to live at the top of a
+// page. AI search engines (Perplexity, ChatGPT, Claude, Gemini, Copilot)
+// quote the first authoritative paragraph; this block makes that paragraph
+// visually distinct without introducing a new design vocabulary. Reuses
+// the same surface treatment as Callout so it feels native.
+export function Answer({ children }) {
+  return (
+    <div
+      role="note"
+      aria-label="Direct answer"
+      className={clsx(
+        'my-6 flex rounded-3xl p-6',
+        'bg-sky-50 dark:bg-slate-800/60 dark:ring-1 dark:ring-slate-300/10',
+      )}
+    >
+      <Icon icon="lightbulb" className="h-8 w-8 flex-none" />
+      <div className="ml-4 flex-auto">
+        <p className="m-0 font-display text-xl text-sky-900 dark:text-sky-400">
+          Answer
+        </p>
+        <div
+          className={clsx(
+            'prose mt-2.5',
+            'text-sky-800 [--tw-prose-background:theme(colors.sky.50)] prose-a:text-sky-900 prose-code:text-sky-900',
+            'dark:text-slate-300 dark:prose-code:text-slate-300',
+          )}
+        >
+          {children}
+        </div>
+      </div>
+    </div>
+  )
+}
diff --git a/src/components/CompanyTrustedList.jsx b/src/components/CompanyTrustedList.jsx
index b6b6338..0b1952a 100644
--- a/src/components/CompanyTrustedList.jsx
+++ b/src/components/CompanyTrustedList.jsx
@@ -1,4 +1,4 @@
-import { formatGitHubStars } from '../../utils'
+import { CountUp } from '@/components/CountUp'
 import company1 from '@/images/doceree.svg'
 import company2 from '@/images/americanExpress.svg'
 import company3 from '@/images/ibm.svg'
@@ -6,56 +6,34 @@ import company4 from '@/images/mydbops.svg'
 import company5 from '@/images/guidewire.svg'
 import company6 from '@/images/weave.svg'
 import company8 from '@/images/blinkit.svg'
-import company9 from '@/images/zopsmart.svg'
 import company11 from '@/images/walmart.svg'
 import company10 from '@/images/mcafee.svg'
 import Image from 'next/image'
-import { useEffect, useState } from 'react'
 
 const imageLink = [
-  {
-    image: company2,
-  },
-  {
-    image: company3,
-  },
-  {
-    image: company10,
-  },
-  {
-    image: company8,
-  },
-  {
-    image: company11,
-  },
-  {
-    image: company1,
-  },
-  {
-    image: company4,
-  },
-  {
-    image: company5,
-  },
-  {
-    image: company6,
-  },
-  {
-    image: company9,
-  },
+  { image: company2,  name: 'American Express' },
+  { image: company3,  name: 'IBM' },
+  { image: company10, name: 'McAfee' },
+  { image: company8,  name: 'Blinkit' },
+  { image: company11, name: 'Walmart' },
+  { image: company1,  name: 'Doceree' },
+  { image: company4,  name: 'Mydbops' },
+  { image: company5,  name: 'Guidewire' },
+  { image: company6,  name: 'Weave' },
 ]
 
 export default function CompanyList() {
-  const [githubStars, setGithubStars] = useState('3500+')
-
-  useEffect(() => {
-    setGithubStars(formatGitHubStars('githubStars'))
-  }, [])
   return (
-    <div className="bg-gray-900 py-16 sm:py-10">
+    <div className="py-16 sm:py-10">
       <div className="mx-auto max-w-7xl px-6 lg:px-8">
         <h2 className="text-center text-lg/8 font-semibold text-white">
-          Trusted by {githubStars} Developers at Companies Like:
+          Trusted by{' '}
+          <CountUp
+            value={21500}
+            durationMs={1500}
+            format={(n) => `${n.toLocaleString()}+`}
+          />{' '}
+          Developers at Companies Like:
         </h2>
         <div className="mt-10 flex flex-wrap justify-center gap-x-0 gap-y-10 sm:max-w-none lg:mx-0">
           {imageLink.map((item, index) => (
@@ -64,7 +42,7 @@ export default function CompanyList() {
               className="flex max-h-12 w-1/4 justify-center sm:w-1/6 lg:w-1/5"
             >
               <Image
-                alt="Transistor"
+                alt={item.name}
                 src={item.image}
                 width={158}
                 height={48}
diff --git a/src/components/CountUp.jsx b/src/components/CountUp.jsx
new file mode 100644
index 0000000..ccc045e
--- /dev/null
+++ b/src/components/CountUp.jsx
@@ -0,0 +1,59 @@
+'use client'
+
+import { useEffect, useRef, useState } from 'react'
+
+// Counts up from 0 → `value` over `durationMs` once the element scrolls
+// into view. Eases out (cubic) so the count slows toward the final
+// number rather than stopping abruptly.
+//
+// `format` is called with the current number to render the displayed
+// string (e.g. add a "+" or commas). Defaults to localized integer.
+//
+// Honors `prefers-reduced-motion` — renders the final number
+// immediately with no animation.
+export function CountUp({ value, durationMs = 1500, format }) {
+  const ref = useRef(null)
+  const [n, setN] = useState(0)
+  const formatFn = format || ((x) => x.toLocaleString())
+
+  useEffect(() => {
+    if (typeof window === 'undefined') return
+    const reduce = window.matchMedia?.('(prefers-reduced-motion: reduce)').matches
+    if (reduce) {
+      setN(value)
+      return
+    }
+    const node = ref.current
+    if (!node) return
+    let raf = 0
+    let started = false
+    const start = (t0) => {
+      const tick = (now) => {
+        const elapsed = now - t0
+        const progress = Math.min(1, elapsed / durationMs)
+        // ease-out cubic
+        const eased = 1 - Math.pow(1 - progress, 3)
+        setN(Math.round(value * eased))
+        if (progress < 1) raf = requestAnimationFrame(tick)
+      }
+      raf = requestAnimationFrame(tick)
+    }
+    const obs = new IntersectionObserver(
+      ([entry]) => {
+        if (entry.isIntersecting && !started) {
+          started = true
+          start(performance.now())
+          obs.unobserve(node)
+        }
+      },
+      { threshold: 0.4 },
+    )
+    obs.observe(node)
+    return () => {
+      obs.disconnect()
+      if (raf) cancelAnimationFrame(raf)
+    }
+  }, [value, durationMs])
+
+  return <span ref={ref}>{formatFn(n)}</span>
+}
diff --git a/src/components/DBlistComponent.jsx b/src/components/DBlistComponent.jsx
index f188006..77fe018 100644
--- a/src/components/DBlistComponent.jsx
+++ b/src/components/DBlistComponent.jsx
@@ -14,57 +14,24 @@ import eventhub from '@/images/event_hub.svg'
 import Image from 'next/image'
 
 const imageLink = [
-  {
-    image: ftp,
-    link: '/docs/advanced-guide/handling-file',
-  },
-  {
-    image: clickHouse,
-    link: '/docs/advanced-guide/injecting-databases-drivers#clickhouse',
-  },
-  {
-    image: redis,
-    link: '/docs/quick-start/connecting-redis',
-  },
-  {
-    image: eventhub,
-    link: '/docs/advanced-guide/using-publisher-subscriber#publisher-subscriber'
-  },
-  {
-    image: mongoDb,
-    link: '/docs/advanced-guide/injecting-databases-drivers#mongo-db',
-  },
-  {
-    image: pubSub,
-    link: '/docs/advanced-guide/using-publisher-subscriber#google',
-  },
-  {
-    image: kafka,
-    link: '/docs/advanced-guide/using-publisher-subscriber#kafka',
-  },
-  {
-    image: sql,
-    link: '/docs/advanced-guide/dealing-with-sql',
-  },
-  {
-    image: cassandra,
-    link: '/docs/advanced-guide/injecting-databases-drivers#cassandra',
-  },
-  {
-    image: mqtt,
-    link: '/docs/advanced-guide/using-publisher-subscriber#mqtt',
-  },
-  {
-    image: Badger,
-    link: '/docs/advanced-guide/key-value-store#badger-db',
-  },
+  { image: ftp,        name: 'FTP',         link: '/docs/advanced-guide/handling-file' },
+  { image: clickHouse, name: 'ClickHouse',  link: '/docs/advanced-guide/injecting-databases-drivers#clickhouse' },
+  { image: redis,      name: 'Redis',       link: '/docs/quick-start/connecting-redis' },
+  { image: eventhub,   name: 'Azure Event Hub', link: '/docs/advanced-guide/using-publisher-subscriber#publisher-subscriber' },
+  { image: mongoDb,    name: 'MongoDB',     link: '/docs/advanced-guide/injecting-databases-drivers#mongo-db' },
+  { image: pubSub,     name: 'Google Pub/Sub', link: '/docs/advanced-guide/using-publisher-subscriber#google' },
+  { image: kafka,      name: 'Kafka',       link: '/docs/advanced-guide/using-publisher-subscriber#kafka' },
+  { image: sql,        name: 'SQL',         link: '/docs/advanced-guide/dealing-with-sql' },
+  { image: cassandra,  name: 'Cassandra',   link: '/docs/advanced-guide/injecting-databases-drivers#cassandra' },
+  { image: mqtt,       name: 'MQTT',        link: '/docs/advanced-guide/using-publisher-subscriber#mqtt' },
+  { image: Badger,     name: 'Badger',      link: '/docs/advanced-guide/key-value-store#badger-db' },
 ]
 
 const getAnimationDelay = (index) => `calc(30s / 11 * (11 - ${index + 1}) * -1)`
 
 const DBlistComponent = () => {
   return (
-    <div className="bg-gray-900 py-10">
+    <div className="py-10">
       <div className="mx-auto max-w-screen-2xl lg:px-8 xl:px-12">
         <div className="mx-auto max-w-2xl lg:max-w-none">
           <h2 className="text-center text-lg font-semibold leading-8 text-white">
@@ -78,9 +45,9 @@ const DBlistComponent = () => {
                 cursor: 'pointer',
               }
               return (
-                <Link href={item.link} key={idx}>
+                <Link href={item.link} key={idx} aria-label={item.name}>
                   <Image
-                    alt="Transistor"
+                    alt={item.name}
                     src={item.image}
                     width={158}
                     height={48}
diff --git a/src/components/DocStructuredData.jsx b/src/components/DocStructuredData.jsx
new file mode 100644
index 0000000..745bf41
--- /dev/null
+++ b/src/components/DocStructuredData.jsx
@@ -0,0 +1,109 @@
+'use client'
+
+import { usePathname } from 'next/navigation'
+import mtimes from '@/data/doc-mtimes.json'
+
+// Emits per-doc JSON-LD that AI Overviews and Google Search use to
+// decide whether a page is citable for a given query. Two schemas:
+//
+//   - TechArticle: tells the engine this is a technical doc page,
+//     authored by GoFr, published at the current URL with the page
+//     title as headline.
+//   - BreadcrumbList: gives the search result a clean trail
+//     (Docs › Advanced Guide › RBAC) so a click-through lands on the
+//     right place.
+//
+// Why `'use client'` for SEO content: Next 14 static export pre-
+// renders client components at build time, so the `<script>` ends up
+// in the HTML payload that Google/Perplexity/Claude crawlers read.
+// `usePathname()` resolves to the actual route during build, not at
+// runtime in the user's browser.
+const SITE_URL = 'https://gofr.dev'
+
+function humanizeSegment(seg) {
+  return seg
+    .split('-')
+    .map((s) => (s ? s[0].toUpperCase() + s.slice(1) : s))
+    .join(' ')
+}
+
+function buildBreadcrumbs(pathname, title) {
+  const segments = pathname.split('/').filter(Boolean)
+  const items = [
+    { name: 'Home', url: SITE_URL + '/' },
+  ]
+
+  let acc = ''
+  segments.forEach((seg, idx) => {
+    acc += '/' + seg
+    const isLast = idx === segments.length - 1
+    items.push({
+      name: isLast && title ? title : humanizeSegment(seg),
+      url: SITE_URL + acc,
+    })
+  })
+
+  return {
+    '@context': 'https://schema.org',
+    '@type': 'BreadcrumbList',
+    itemListElement: items.map((it, idx) => ({
+      '@type': 'ListItem',
+      position: idx + 1,
+      name: it.name,
+      item: it.url,
+    })),
+  }
+}
+
+export function DocStructuredData({ title, description, lastUpdated }) {
+  const pathname = usePathname() || '/'
+  const url = SITE_URL + pathname
+  // Auto-populate dateModified from the per-route mtime map when the
+  // caller didn't pass an explicit lastUpdated. This is the freshness
+  // signal Google's December 2025 core update started rewarding —
+  // missing dateModified meant every doc looked equally stale.
+  const dateModified = lastUpdated || mtimes[pathname] || null
+
+  const article = {
+    '@context': 'https://schema.org',
+    '@type': 'TechArticle',
+    headline: title,
+    description: description || undefined,
+    inLanguage: 'en',
+    isPartOf: {
+      '@type': 'WebSite',
+      name: 'GoFr',
+      url: SITE_URL,
+    },
+    mainEntityOfPage: {
+      '@type': 'WebPage',
+      '@id': url,
+    },
+    author: {
+      '@type': 'Organization',
+      name: 'GoFr',
+      url: SITE_URL,
+    },
+    publisher: {
+      '@type': 'Organization',
+      name: 'GoFr',
+      url: SITE_URL,
+    },
+    ...(dateModified && { dateModified }),
+  }
+
+  const breadcrumb = buildBreadcrumbs(pathname, title)
+
+  return (
+    <>
+      <script
+        type="application/ld+json"
+        dangerouslySetInnerHTML={{ __html: JSON.stringify(article) }}
+      />
+      <script
+        type="application/ld+json"
+        dangerouslySetInnerHTML={{ __html: JSON.stringify(breadcrumb) }}
+      />
+    </>
+  )
+}
diff --git a/src/components/DocsHeader.jsx b/src/components/DocsHeader.jsx
index 21d5c3c..755300c 100644
--- a/src/components/DocsHeader.jsx
+++ b/src/components/DocsHeader.jsx
@@ -15,13 +15,17 @@ export function DocsHeader({ title }) {
     return null
   }
 
+  // NOTE: do NOT render <title> or <meta description> from this
+  // component. Next.js's metadata API (per-page `metadata` exports
+  // and the Markdoc frontmatter → metadata bridge in next.config.mjs)
+  // already injects a single canonical pair into <head>. Rendering
+  // them here too produced duplicate <title>/<meta description>
+  // tags in the served HTML — Google was free to pick the wrong one,
+  // and the page-specific tag was being out-ranked by the site
+  // default. Keep this component purely for the visible header chrome
+  // (section eyebrow + h1).
   return (
     <header className="mb-9 space-y-1">
-      <title>{section.title + ' | ' + link?.title || ''}</title>
-      <meta
-        name="description"
-        content={link?.desc || section?.desc || 'Quick Start Guide with Gofr'}
-      ></meta>
       {section && (
         <p className="font-display text-sm font-medium text-sky-500">
           {section.title}
diff --git a/src/components/DocsLayout.jsx b/src/components/DocsLayout.jsx
index 81354d3..f484d83 100644
--- a/src/components/DocsLayout.jsx
+++ b/src/components/DocsLayout.jsx
@@ -1,17 +1,29 @@
 import { DocsHeader } from '@/components/DocsHeader'
+import { DocStructuredData } from '@/components/DocStructuredData'
+import { LastUpdatedByline } from '@/components/LastUpdatedByline'
 import { PrevNextLinks } from '@/components/PrevNextLinks'
 import { Prose } from '@/components/Prose'
 import { TableOfContents } from '@/components/TableOfContents'
 import { collectSections } from '@/lib/sections'
 
-export function DocsLayout({ children, frontmatter: { title }, nodes }) {
-  let tableOfContents = collectSections(nodes)
+export function DocsLayout({ children, frontmatter, nodes }) {
+  const { title, description } = frontmatter || {}
+  const tableOfContents = collectSections(nodes)
 
   return (
     <>
-      <div className="min-w-0 max-w-2xl flex-auto px-4 py-16 lg:max-w-none lg:pl-8 lg:pr-0 xl:px-16">
+      {/* JSON-LD (TechArticle + BreadcrumbList) for AI Overview / */}
+      {/* Google rich-result citation eligibility. Static-export */}
+      {/* pre-renders the script tag at build time, so the schema is */}
+      {/* in the HTML payload crawlers actually read. */}
+      <DocStructuredData title={title} description={description} />
+      <div className="min-w-0 max-w-2xl flex-auto px-4 py-16 lg:max-w-4xl lg:pl-8 lg:pr-0 xl:px-16">
         <article>
           <DocsHeader title={title} />
+          {/* Visible freshness byline — populated from per-route */}
+          {/* git mtime map at build time. Renders nothing if the */}
+          {/* route isn't in the map (e.g. brand-new untracked page). */}
+          <LastUpdatedByline />
           <Prose>{children}</Prose>
         </article>
         <PrevNextLinks />
diff --git a/src/components/EcosystemRecognition.jsx b/src/components/EcosystemRecognition.jsx
new file mode 100644
index 0000000..9ba867c
--- /dev/null
+++ b/src/components/EcosystemRecognition.jsx
@@ -0,0 +1,116 @@
+import Link from 'next/link'
+
+// Ecosystem credibility signals — independent recognition from
+// industry-standard sources. Stronger trust marker than a corporate
+// logo strip and doesn't imply any commercial endorsement.
+//
+// Each card now carries a concrete metadata line (where in the source
+// GoFr is listed) so the section reads as data rather than three
+// generic "we are listed" claims. The visual treatment was previously
+// thin — small monogram + thin border — which made the row feel like
+// a placeholder. Bigger card padding, an accent-tinted background
+// behind the monogram, and a labeled metadata pill give it weight
+// proportional to the credibility it represents.
+const items = [
+  {
+    name: 'ThoughtWorks Technology Radar',
+    blurb: 'Independent assessment by ThoughtWorks of GoFr as a Go microservice framework worth knowing.',
+    metaLabel: 'Section',
+    metaValue: 'Languages & Frameworks',
+    href: 'https://www.thoughtworks.com/en-in/radar/languages-and-frameworks/gofr',
+    label: 'TW',
+    accent: {
+      border: 'group-hover:border-rose-400/60',
+      tint: 'bg-rose-500/10 text-rose-300 border-rose-500/40',
+      meta: 'text-rose-300/80',
+    },
+  },
+  {
+    name: 'CNCF Landscape',
+    blurb: 'Listed in the Cloud Native Computing Foundation\u2019s open-source landscape index.',
+    metaLabel: 'Category',
+    metaValue: 'App Definition & Development',
+    href: 'https://landscape.cncf.io/?selected=go-fr',
+    label: 'CNCF',
+    accent: {
+      border: 'group-hover:border-sky-400/60',
+      tint: 'bg-sky-500/10 text-sky-300 border-sky-500/40',
+      meta: 'text-sky-300/80',
+    },
+  },
+  {
+    name: 'JetBrains',
+    blurb: 'Maintainer GoLand and IDE licenses sponsored under the JetBrains Open Source support program.',
+    metaLabel: 'Program',
+    metaValue: 'Open Source',
+    href: 'https://www.jetbrains.com/community/opensource/',
+    label: 'JB',
+    accent: {
+      border: 'group-hover:border-amber-400/60',
+      tint: 'bg-amber-500/10 text-amber-300 border-amber-500/40',
+      meta: 'text-amber-300/80',
+    },
+  },
+]
+
+export function EcosystemRecognition() {
+  return (
+    <section className="px-4 py-12 lg:px-8 xl:px-12">
+      <div className="mx-auto max-w-5xl">
+        <div className="mb-8 text-center">
+          <p className="text-xs font-semibold uppercase tracking-[0.2em] text-slate-500">
+            In the ecosystem
+          </p>
+          <h2 className="mt-2 font-display text-2xl font-semibold tracking-tight text-white">
+            Recognized where it counts
+          </h2>
+        </div>
+        <div className="grid gap-4 sm:grid-cols-3">
+          {items.map((it) => (
+            <Link
+              key={it.name}
+              href={it.href}
+              target="_blank"
+              rel="noopener noreferrer"
+              className={`group flex flex-col gap-4 rounded-2xl border border-slate-800 bg-slate-900/40 p-6 transition-all duration-300 hover:-translate-y-1 hover:bg-slate-900/70 ${it.accent.border}`}
+            >
+              <div className="flex items-center justify-between">
+                <span
+                  className={`flex h-11 w-11 flex-none items-center justify-center rounded-xl border font-mono text-xs font-semibold tracking-tight ${it.accent.tint}`}
+                  aria-hidden="true"
+                >
+                  {it.label}
+                </span>
+                <svg
+                  className="h-3.5 w-3.5 flex-none text-slate-600 transition-colors group-hover:text-slate-300"
+                  viewBox="0 0 12 12"
+                  fill="none"
+                  aria-hidden="true"
+                >
+                  <path d="M3.5 3.5h5v5" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" />
+                  <path d="M8.5 3.5L3 9" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" />
+                </svg>
+              </div>
+              <div>
+                <h3 className="font-display text-base font-semibold text-white">
+                  {it.name}
+                </h3>
+                <p className="mt-2 text-sm leading-snug text-slate-400">
+                  {it.blurb}
+                </p>
+              </div>
+              <div className="mt-auto flex items-baseline gap-2 border-t border-slate-800/80 pt-4">
+                <span className="text-[10px] font-semibold uppercase tracking-wider text-slate-500">
+                  {it.metaLabel}
+                </span>
+                <span className={`text-xs font-medium ${it.accent.meta}`}>
+                  {it.metaValue}
+                </span>
+              </div>
+            </Link>
+          ))}
+        </div>
+      </div>
+    </section>
+  )
+}
diff --git a/src/components/FadeInOnScroll.jsx b/src/components/FadeInOnScroll.jsx
new file mode 100644
index 0000000..d4b8cbd
--- /dev/null
+++ b/src/components/FadeInOnScroll.jsx
@@ -0,0 +1,53 @@
+'use client'
+
+import { useEffect, useRef, useState } from 'react'
+import clsx from 'clsx'
+
+// Bidirectional IntersectionObserver fade. A section fades up + in
+// when it scrolls into view and fades back out when it leaves —
+// so as you scroll the page the active section is always the one
+// at full opacity, and adjacent sections feel like they're breathing.
+//
+// Implementation:
+// - keep observing (no unobserve) so the fade reverses on scroll-back
+// - threshold ~15% of section visible counts as "in view"
+// - rootMargin shrinks the trigger zone so a tall section's edges
+//   fade rather than the entire section flipping at the very top edge
+//
+// Avoided framer-motion (~40 kB gz) for what is two CSS transitions.
+// Honors `prefers-reduced-motion` (renders fully visible, no anim).
+export function FadeInOnScroll({ children, className }) {
+  const ref = useRef(null)
+  // Default to `true` so SSR markup is fully visible — JS then takes
+  // over once hydrated. If JS never runs, page still reads correctly.
+  const [shown, setShown] = useState(true)
+
+  useEffect(() => {
+    if (typeof window === 'undefined') return
+    const reduce = window.matchMedia?.('(prefers-reduced-motion: reduce)').matches
+    if (reduce) return // already shown=true
+    const node = ref.current
+    if (!node) return
+    // Start hidden post-hydration; observer will reveal on entry.
+    setShown(false)
+    const obs = new IntersectionObserver(
+      ([entry]) => setShown(entry.isIntersecting),
+      { threshold: 0.15, rootMargin: '-5% 0px -5% 0px' },
+    )
+    obs.observe(node)
+    return () => obs.disconnect()
+  }, [])
+
+  return (
+    <div
+      ref={ref}
+      className={clsx(
+        'transition-all duration-700 ease-out',
+        shown ? 'translate-y-0 opacity-100' : 'translate-y-6 opacity-0',
+        className,
+      )}
+    >
+      {children}
+    </div>
+  )
+}
diff --git a/src/components/Faq.jsx b/src/components/Faq.jsx
new file mode 100644
index 0000000..bb83ab5
--- /dev/null
+++ b/src/components/Faq.jsx
@@ -0,0 +1,130 @@
+'use client'
+
+import { Children, isValidElement, useState } from 'react'
+import clsx from 'clsx'
+
+// Walks React children to find `<FaqItem question="…">` nodes and
+// extracts question + answer text for FAQPage JSON-LD. Markdoc emits
+// arbitrary nested wrappers (paragraph nodes, fragments) so we recurse
+// rather than only inspecting direct children.
+function extractFaqItems(children) {
+  const items = []
+
+  function visit(node) {
+    if (Array.isArray(node)) {
+      node.forEach(visit)
+      return
+    }
+    if (!isValidElement(node)) return
+
+    const q = node.props?.question
+    if (typeof q === 'string' && q.length > 0) {
+      const a = node.props.answer ?? toPlainText(node.props.children)
+      if (a) items.push({ question: q, answer: a })
+      return
+    }
+
+    if (node.props?.children) visit(node.props.children)
+  }
+
+  visit(children)
+  return items
+}
+
+function toPlainText(node) {
+  if (node == null) return ''
+  if (typeof node === 'string') return node
+  if (typeof node === 'number') return String(node)
+  if (Array.isArray(node)) return node.map(toPlainText).join('')
+  if (isValidElement(node)) return toPlainText(node.props?.children)
+  return ''
+}
+
+// FaqItem renders a single collapsible Q/A. Visual treatment matches the
+// existing card vocabulary (rounded-xl border, slate-200/slate-800).
+// JSON-LD for FAQPage schema is emitted by the parent FaqList so search
+// engines and AI engines can surface these questions as rich results.
+function FaqItem({ question, answer, children }) {
+  const [open, setOpen] = useState(false)
+  const body = answer ?? children
+
+  return (
+    <div className="not-prose rounded-xl border border-slate-200 dark:border-slate-800">
+      <button
+        type="button"
+        onClick={() => setOpen((v) => !v)}
+        aria-expanded={open}
+        className="flex w-full items-center justify-between gap-4 rounded-xl px-5 py-4 text-left text-sm font-medium text-slate-900 transition-colors hover:bg-slate-50 dark:text-white dark:hover:bg-slate-800/40"
+      >
+        <span>{question}</span>
+        <svg
+          aria-hidden="true"
+          viewBox="0 0 12 12"
+          className={clsx(
+            'h-3 w-3 flex-none text-slate-400 transition-transform',
+            open && 'rotate-180',
+          )}
+        >
+          <path
+            d="M2 4l4 4 4-4"
+            stroke="currentColor"
+            strokeWidth="1.5"
+            strokeLinecap="round"
+            strokeLinejoin="round"
+            fill="none"
+          />
+        </svg>
+      </button>
+      {open && (
+        <div className="prose-sm border-t border-slate-200 px-5 py-4 text-sm text-slate-700 dark:border-slate-800 dark:text-slate-400">
+          {body}
+        </div>
+      )}
+    </div>
+  )
+}
+
+// FaqList wraps a series of `{% faq %}` blocks and emits FAQPage JSON-LD.
+// AI search engines and Google's AI Overviews give significant weight to
+// pages that publish authoritative FAQPage schema.
+//
+// Items can be supplied explicitly via the `items` prop (Markdoc tag
+// attribute) OR inferred from FaqItem children. We prefer the explicit
+// list when provided and fall back to a walk so authors can just write
+// `{% faq %}{% faq-item question="…" %}…{% /faq-item %}{% /faq %}` and
+// schema emission Just Works.
+export function FaqList({ items = [], children }) {
+  const ldItems = items.length ? items : extractFaqItems(children)
+
+  const jsonLd = ldItems.length
+    ? {
+        '@context': 'https://schema.org',
+        '@type': 'FAQPage',
+        mainEntity: ldItems.map((it) => ({
+          '@type': 'Question',
+          name: it.question,
+          acceptedAnswer: {
+            '@type': 'Answer',
+            text: it.answer,
+          },
+        })),
+      }
+    : null
+
+  return (
+    <section className="my-10">
+      <h2 className="mb-4 font-display text-xl text-slate-900 dark:text-white">
+        Frequently asked
+      </h2>
+      <div className="not-prose flex flex-col gap-3">{children}</div>
+      {jsonLd && (
+        <script
+          type="application/ld+json"
+          dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }}
+        />
+      )}
+    </section>
+  )
+}
+
+export { FaqItem }
diff --git a/src/components/Fence.jsx b/src/components/Fence.jsx
index 2d4cc30..53231b2 100644
--- a/src/components/Fence.jsx
+++ b/src/components/Fence.jsx
@@ -2,37 +2,81 @@
 import { Fragment, useState } from 'react'
 import { Highlight, Prism } from 'prism-react-renderer'
 import bashLang from 'refractor/lang/bash'
-import FileCopyIcon from '@mui/icons-material/FileCopy'
-import DoneOutlinedIcon from '@mui/icons-material/DoneOutlined'
 import copy from 'copy-to-clipboard'
-import Tooltip from '@mui/material/Tooltip'
 
 bashLang(Prism)
 
+const languageNames = {
+  js: 'JavaScript', javascript: 'JavaScript',
+  ts: 'TypeScript', typescript: 'TypeScript',
+  go: 'Go', bash: 'Bash', sh: 'Shell', shell: 'Shell',
+  json: 'JSON', yaml: 'YAML', yml: 'YAML', sql: 'SQL',
+  protobuf: 'Protobuf', proto: 'Protobuf',
+  dockerfile: 'Dockerfile', graphql: 'GraphQL',
+  dotenv: '.env', env: '.env',
+  html: 'HTML', css: 'CSS', xml: 'XML', toml: 'TOML',
+}
+
+function CopyIcon(props) {
+  return (
+    <svg viewBox="0 0 16 16" fill="currentColor" {...props}>
+      <path d="M0 6.75C0 5.784.784 5 1.75 5h1.5a.75.75 0 0 1 0 1.5h-1.5a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-1.5a.75.75 0 0 1 1.5 0v1.5A1.75 1.75 0 0 1 9.25 16h-7.5A1.75 1.75 0 0 1 0 14.25Z" />
+      <path d="M5 1.75C5 .784 5.784 0 6.75 0h7.5C15.216 0 16 .784 16 1.75v7.5A1.75 1.75 0 0 1 14.25 11h-7.5A1.75 1.75 0 0 1 5 9.25Zm1.75-.25a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-7.5a.25.25 0 0 0-.25-.25Z" />
+    </svg>
+  )
+}
+
+function CheckIcon(props) {
+  return (
+    <svg viewBox="0 0 16 16" fill="currentColor" {...props}>
+      <path d="M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.75.75 0 0 1 1.06-1.06L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z" />
+    </svg>
+  )
+}
+
 export function Fence({ children, language }) {
+  // Defensive: a markdown author writing a code fence without a
+  // language tag (e.g. ``` instead of ```go) made prism-react-renderer
+  // crash the entire page prerender on `language.toLowerCase()`. Fall
+  // back to 'text' so a missing tag is a soft degrade (plain code
+  // block, no syntax highlight) instead of a hard build failure.
+  const lang = language || 'text'
   const [copied, setCopied] = useState(false)
+  const label = languageNames[lang] || lang
 
   const handleCopy = () => {
     copy(children.trimEnd())
     setCopied(true)
-    setTimeout(() => {
-      setCopied(false)
-    }, 1500)
+    setTimeout(() => setCopied(false), 1500)
   }
 
   return (
-    <div>
+    <div className="not-prose group relative my-5 rounded-lg bg-slate-900 dark:bg-slate-800/60 dark:ring-1 dark:ring-slate-300/10">
+      {/* Header with language label and copy */}
+      {lang !== 'doc' && (
+        <div className="flex items-center justify-between rounded-t-lg border-b border-slate-800 px-4 py-2 dark:border-slate-700/50">
+          <span className="font-mono text-xs text-slate-400">{label}</span>
+          <button
+            onClick={handleCopy}
+            className="flex items-center gap-1.5 text-xs text-slate-500 transition-colors hover:text-slate-300"
+          >
+            {copied ? (
+              <CheckIcon className="h-3.5 w-3.5 text-emerald-400" />
+            ) : (
+              <CopyIcon className="h-3.5 w-3.5" />
+            )}
+          </button>
+        </div>
+      )}
+
       <Highlight
         code={children.trimEnd()}
-        language={language}
-        theme={{
-          plain: {},
-          styles: [],
-        }}
+        language={lang}
+        theme={{ plain: {}, styles: [] }}
       >
         {({ className, style, tokens, getTokenProps }) => (
-          <pre className={`${className} flex`} style={style}>
-            <code style={{ width: 'calc(100% - 24px)', overflow: 'auto' }}>
+          <pre className={`${className} overflow-x-auto p-4 text-xs sm:text-[13px] leading-relaxed`} style={style}>
+            <code>
               {tokens.map((line, lineIndex) => (
                 <Fragment key={lineIndex}>
                   {line
@@ -44,26 +88,6 @@ export function Fence({ children, language }) {
                 </Fragment>
               ))}
             </code>
-            {language !== 'doc' && (
-              <div>
-                {copied ? (
-                  <Tooltip title="Copied!">
-                    <DoneOutlinedIcon
-                      fontSize="small"
-                      className=" text-green-500 transition duration-500 ease-in-out"
-                    />
-                  </Tooltip>
-                ) : (
-                  <Tooltip title="Copy">
-                    <FileCopyIcon
-                      fontSize="small"
-                      className={`cursor-pointer text-gray-500 transition duration-500 ease-in-out`}
-                      onClick={handleCopy}
-                    />
-                  </Tooltip>
-                )}
-              </div>
-            )}
           </pre>
         )}
       </Highlight>
diff --git a/src/components/Footer.jsx b/src/components/Footer.jsx
index e3a96ac..4778be8 100644
--- a/src/components/Footer.jsx
+++ b/src/components/Footer.jsx
@@ -1,8 +1,4 @@
-import React from 'react'
 import Link from 'next/link'
-import cloudNativeLandscapeSvg from '@/images/cloud-native-landscape.svg'
-import awesomeGo from '@/images/awesome-go.svg'
-import Image from 'next/image'
 import { RedditIcon } from './icons/RedditIcon'
 import { GithubIcon } from './icons/GithubIcon'
 import { DiscordIcon } from './icons/DiscordIcon'
@@ -10,76 +6,127 @@ import { LinkedinIcon } from './icons/LinkedinIcon'
 import { TwitterIcon } from './icons/TwitterIcon'
 import EmailIcon from './icons/EmailIcon'
 
-
-const socialMediaLinks = [
-  {
-    Icon: GithubIcon,
-    Link: 'https://github.com/gofr-dev/',
-  },
+// Grouped, center-aligned footer columns. Each column has 5 entries so
+// the visual height is balanced; uneven columns made "Resources" tower
+// over the others. "Framework" replaces "Product" — GoFr is open
+// source, not a commercial product, so the OSS-appropriate noun is
+// the framework itself.
+const columns = [
   {
-    Icon: DiscordIcon,
-    Link: 'https://discord.gg/5ACeSKGt37',
+    title: 'Framework',
+    links: [
+      { title: 'Quick Start', href: '/docs/quick-start/introduction' },
+      { title: 'Production Guides', href: '/docs/guides/deploying-to-kubernetes' },
+      { title: 'Examples', href: '/examples' },
+      { title: 'Changelog', href: '/changelog' },
+      { title: 'Roadmap', href: '/roadmap' },
+    ],
   },
   {
-    Icon: RedditIcon,
-    Link: 'https://www.reddit.com/r/gofr/',
+    title: 'Resources',
+    links: [
+      { title: 'Why GoFr', href: '/why-gofr' },
+      { title: 'Compare', href: '/comparison' },
+      { title: 'Migrate', href: '/migrate' },
+      { title: 'Learn', href: '/learn' },
+      { title: 'FAQ', href: '/faq' },
+    ],
   },
   {
-    Icon: LinkedinIcon,
-    Link: 'https://in.linkedin.com/company/gofr-dev',
+    title: 'Community',
+    links: [
+      { title: 'GitHub', href: 'https://github.com/gofr-dev/', external: true },
+      { title: 'Discord', href: 'https://discord.gg/5ACeSKGt37', external: true },
+      { title: 'Reddit', href: 'https://www.reddit.com/r/gofr/', external: true },
+      { title: 'X (Twitter)', href: 'https://twitter.com/gofr_dev', external: true },
+      { title: 'LinkedIn', href: 'https://in.linkedin.com/company/gofr-dev', external: true },
+    ],
   },
   {
-    Icon: TwitterIcon,
-    Link: 'https://twitter.com/gofr_dev',
-  },
-    {
-    Icon: EmailIcon,
-    Link: 'mailto:connect@gofr.dev',
+    title: 'Project',
+    links: [
+      { title: 'Team', href: '/team' },
+      { title: 'Showcase', href: '/showcase' },
+      { title: 'Events', href: '/events' },
+      // /llms.txt rather than AGENTS.md here: the hero already hands
+      // AGENTS.md to developers wiring Claude/Cursor. The footer is
+      // where AI search-engine crawlers and curious humans look for
+      // the broader curated link index, so we point them there.
+      { title: 'LLM index', href: '/llms.txt', external: true },
+      { title: 'Blog', href: 'https://medium.com/gofr', external: true },
+    ],
   },
 ]
 
-const footerLinks = [
-  // { title: 'Releases', link: '/releases' },
-  { title: 'Documentation', link: '/docs' },
-  { title: 'Blogs', link: 'https://medium.com/gofr', target_blank: true },
-  { title: 'Events', link: '/events' },
+const socialMediaLinks = [
+  { Icon: GithubIcon, href: 'https://github.com/gofr-dev/', label: 'GitHub' },
+  { Icon: DiscordIcon, href: 'https://discord.gg/5ACeSKGt37', label: 'Discord' },
+  { Icon: RedditIcon, href: 'https://www.reddit.com/r/gofr/', label: 'Reddit' },
+  { Icon: LinkedinIcon, href: 'https://in.linkedin.com/company/gofr-dev', label: 'LinkedIn' },
+  { Icon: TwitterIcon, href: 'https://twitter.com/gofr_dev', label: 'Twitter' },
+  { Icon: EmailIcon, href: 'mailto:connect@gofr.dev', label: 'Email' },
 ]
 
 function FooterUi() {
   return (
-    <footer className="border-t border-slate-800 px-4 py-2 dark:bg-slate-900">
-      <div className="mx-auto max-w-screen-2xl px-2 py-2 ">
-        <nav
-          aria-label="Footer"
-          className="relative z-10 flex justify-center gap-5 sm:space-x-12"
-        >
-          {footerLinks.map((item) => (
-            <div key={item.title} className="pb-2">
-              <Link
-                href={item.link}
-                target={item?.target_blank ? '_blank' : '_self'}
-                className="text-sm leading-6 text-slate-400 hover:text-slate-300"
-              >
-                {item.title}
-              </Link>
+    <footer className="border-t border-slate-200 dark:border-slate-800 dark:bg-slate-900">
+      {/* Top section: column grid, centered. */}
+      <div className="mx-auto max-w-5xl px-6 pb-10 pt-12 lg:px-8">
+        <div className="grid grid-cols-2 gap-8 text-center sm:grid-cols-4 sm:text-left">
+          {columns.map((col) => (
+            <div key={col.title}>
+              <h3 className="font-display text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400">
+                {col.title}
+              </h3>
+              <ul className="mt-4 space-y-2.5">
+                {col.links.map((link) => {
+                  // External links (and static files like /AGENTS.md)
+                  // need a plain <a>; next/link tries to client-side
+                  // route to in-app paths, which silently fails for
+                  // public/ static files.
+                  const Wrapper = link.external ? 'a' : Link
+                  return (
+                    <li key={link.title}>
+                      <Wrapper
+                        href={link.href}
+                        target={link.external ? '_blank' : undefined}
+                        rel={link.external ? 'noopener noreferrer' : undefined}
+                        className="text-sm text-slate-500 transition-colors hover:text-slate-700 dark:text-slate-400 dark:hover:text-slate-300"
+                      >
+                        {link.title}
+                      </Wrapper>
+                    </li>
+                  )
+                })}
+              </ul>
             </div>
           ))}
-        </nav>
-        <div className="mt-4 flex justify-center space-x-6">
-          {socialMediaLinks.map((item, idx) => {
-            const { Icon, Link: link } = item
-            return (
+        </div>
+      </div>
+
+      {/* Full-width divider — outside any max-w container so it spans */}
+      {/* the entire page like the top edge does. */}
+      <div className="border-t border-slate-200 dark:border-slate-800" />
+
+      {/* Bottom section: social icons only, centered. Language switcher */}
+      {/* and copyright/license line removed — visitors who want license */}
+      {/* info can find it in the linked GitHub repos. */}
+      <div className="mx-auto max-w-5xl px-6 pb-12 pt-6 lg:px-8">
+        <div className="flex flex-wrap items-center justify-center gap-x-5 gap-y-3">
+          <div className="flex items-center gap-4">
+            {socialMediaLinks.map(({ Icon, href, label }) => (
               <Link
-                key={link}
-                href={link}
-                className="text-gray-400 hover:text-gray-500"
+                key={label}
+                href={href}
                 target="_blank"
-                aria-label="social media link"
+                rel="noopener noreferrer"
+                aria-label={label}
+                className="text-slate-500 transition-colors hover:text-slate-700 dark:hover:text-slate-300"
               >
-                <Icon className="h-5 w-5 fill-slate-400 hover:fill-slate-300 dark:hover:fill-slate-300"></Icon>
+                <Icon className="h-4 w-4 fill-current" />
               </Link>
-            )
-          })}
+            ))}
+          </div>
         </div>
       </div>
     </footer>
diff --git a/src/components/Hero.jsx b/src/components/Hero.jsx
index 75c0f1d..85626c4 100644
--- a/src/components/Hero.jsx
+++ b/src/components/Hero.jsx
@@ -92,14 +92,27 @@ function TrafficLightsIcon(props) {
   )
 }
 
-export function Hero() {
+// Default English copy. Hero accepts an optional `t` prop so the same
+// component can be reused on localized landings (/es, /zh) without
+// forking the markup. When `t` is omitted the rendered HTML is byte-
+// equivalent to the original English hero.
+const DEFAULT_T = {
+  h1: 'An Opinionated Go Framework',
+  h2: 'For accelerated microservice development',
+  getStarted: 'Get Started',
+  viewOnGithub: 'View on GitHub',
+  evaluateLead: 'Want to evaluate and adopt GoFr at your org?',
+  evaluateCta: 'block our calendar.',
+}
+
+export function Hero({ t = DEFAULT_T, getStartedHref = '/docs' }) {
   const [activeTab, setActiveTab] = useState('main.go')
   const code = activeTab === 'main.go' ? mainGoCode : mainTestGoCode
 
   return (
     <div className="overflow-hidden bg-slate-900 dark:-mb-32 dark:mt-[-4.75rem] dark:pb-32 dark:pt-[4.75rem]">
       <div className="sm:px-2 lg:relative lg:px-0 lg:py-20">
-        <div className="x:px-12 mr-auto grid grid-cols-1 items-center gap-x-8 gap-y-16 px-4 lg:max-w-[100%] lg:grid-cols-2 lg:px-8 xl:gap-x-16">
+        <div className="mr-auto grid grid-cols-1 items-center gap-x-8 gap-y-16 px-4 lg:max-w-[100%] lg:grid-cols-2 lg:px-8 xl:gap-x-16">
           <div className="flex flex-col items-center gap-x-8 xl:flex-row xl:gap-x-16">
             <Image
               src={completeGofrLogo}
@@ -107,30 +120,32 @@ export function Hero() {
               height={150}
               unoptimized
               priority
+              className="motion-safe:animate-gentle-drift"
             />
             <div className="relative z-10">
               <Image
                 className="absolute bottom-full right-full -mb-56 -mr-72 opacity-50"
                 src={blurCyanImage}
                 alt=""
+                aria-hidden="true"
                 width={530}
                 height={530}
                 unoptimized
-                priority
+                loading="lazy"
               />
               <div className="relative text-center xl:text-left">
                 <h1 className="inline bg-gradient-to-r from-indigo-200 via-sky-400 to-indigo-200 bg-clip-text font-display text-5xl tracking-tight text-transparent">
-                  An Opinionated Go Framework
+                  {t.h1}
                 </h1>
-                <h2 className="mt-3 text-2xl tracking-tight text-slate-400">
-                  For accelerated microservice development
+                <h2 className="mt-3 text-2xl tracking-tight text-slate-300">
+                  {t.h2}
                 </h2>
-                <div className="mt-9 flex justify-center gap-4 xl:justify-start">
+                <div className="mt-8 flex justify-center gap-4 xl:justify-start">
                   <Link
                     className="rounded-full bg-sky-300 px-4 py-2 text-sm font-semibold text-slate-900 hover:bg-sky-200 focus:outline-none focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-sky-300/50 active:bg-sky-500"
-                    href="/docs"
+                    href={getStartedHref}
                   >
-                    Get Started
+                    {t.getStarted}
                   </Link>
                   <Link
                     className="flex items-center gap-1 rounded-full bg-white bg-opacity-[0.08] px-4 py-1 text-sm font-semibold text-white transition-all duration-200 hover:bg-opacity-[.15]"
@@ -144,23 +159,25 @@ export function Hero() {
                     >
                       <path d="M8 0C3.58 0 0 3.58 0 8C0 11.54 2.29 14.53 5.47 15.59C5.87 15.66 6.02 15.42 6.02 15.21C6.02 15.02 6.01 14.39 6.01 13.72C4 14.09 3.48 13.23 3.32 12.78C3.23 12.55 2.84 11.84 2.5 11.65C2.22 11.5 1.82 11.13 2.49 11.12C3.12 11.11 3.57 11.7 3.72 11.94C4.44 13.15 5.59 12.81 6.05 12.6C6.12 12.08 6.33 11.73 6.56 11.53C4.78 11.33 2.92 10.64 2.92 7.58C2.92 6.71 3.23 5.99 3.74 5.43C3.66 5.23 3.38 4.41 3.82 3.31C3.82 3.31 4.49 3.1 6.02 4.13C6.66 3.95 7.34 3.86 8.02 3.86C8.7 3.86 9.38 3.95 10.02 4.13C11.55 3.09 12.22 3.31 12.22 3.31C12.66 4.41 12.38 5.23 12.3 5.43C12.81 5.99 13.12 6.7 13.12 7.58C13.12 10.65 11.25 11.33 9.47 11.53C9.76 11.78 10.01 12.26 10.01 13.01C10.01 14.08 10 14.94 10 15.21C10 15.42 10.15 15.67 10.55 15.59C13.71 14.53 16 11.53 16 8C16 3.58 12.42 0 8 0Z"></path>
                     </svg>
-                    <span>View on GitHub</span>
+                    <span>{t.viewOnGithub}</span>
                   </Link>
                 </div>
-                <div
-                  className={`flex flex-wrap justify-center gap-x-1 pt-5 text-sm text-slate-400 xl:justify-start`}
-                >
+                {/* Tertiary CTA — matches prod: evaluation prospects */}
+                {/* hit the calendar booking link rather than the AI- */}
+                {/* assistant /llms.txt link. AI assistants find */}
+                {/* gofr.dev/llms.txt via the rel="alternate" link in */}
+                {/* the root layout's <head>; they don't need a */}
+                {/* hero CTA. Live calendar/eval traffic does. */}
+                <div className="mt-4 flex flex-wrap justify-center gap-x-1.5 text-xs text-slate-400 xl:justify-start">
                   <span>Want to evaluate and adopt GoFr at your org?</span>
-                  <Link
-                    href={
-                      'https://calendly.com/aryan-mehrotra-gofr/30min?month=2024-10'
-                    }
-                    target={'_blank'}
-                    className={`text-sky-400`}
+                  <a
+                    href="https://calendly.com/aryan-mehrotra-gofr/30min"
+                    target="_blank"
+                    rel="noopener noreferrer"
+                    className="text-sky-400 transition-colors hover:text-sky-300"
                   >
-                    {' '}
                     block our calendar.
-                  </Link>
+                  </a>
                 </div>
               </div>
             </div>
@@ -174,19 +191,21 @@ export function Hero() {
                 className="absolute -right-2 -top-64"
                 src={blurCyanImage}
                 alt=""
+                aria-hidden="true"
                 width={530}
                 height={530}
                 unoptimized
-                priority
+                loading="lazy"
               />
               <Image
                 className="absolute -bottom-40 -right-1"
                 src={blurIndigoImage}
                 alt=""
+                aria-hidden="true"
                 width={567}
                 height={567}
                 unoptimized
-                priority
+                loading="lazy"
               />
               <div className="absolute inset-0 rounded-2xl bg-gradient-to-tr from-sky-300 via-sky-300/70 to-blue-300 opacity-10 blur-lg" />
               <div className="absolute inset-0 rounded-2xl bg-gradient-to-tr from-sky-300 via-sky-300/70 to-blue-300 opacity-10" />
@@ -219,7 +238,7 @@ export function Hero() {
                     ))}
                   </div>
                   <div
-                    className={`mt-6 flex max-h-[315px] items-start px-1 px-4 text-sm ${
+                    className={`mt-6 flex max-h-[315px] items-start px-1 px-4 text-xs sm:text-sm ${
                       activeTab === 'main_test.go' ? 'overflow-auto' : ''
                     }`}
                   >
@@ -236,6 +255,11 @@ export function Hero() {
                         </Fragment>
                       ))}
                     </div>
+                    {/* Line-by-line stagger reveal (motion-safe). Each */}
+                    {/* `<div>` line below gets `animation-delay: i*60ms` */}
+                    {/* via inline style so the code "types in" on first */}
+                    {/* paint. Pure CSS — no React state, runs every */}
+                    {/* mount. Pauses under prefers-reduced-motion. */}
                     <Highlight
                       code={code}
                       language={codeLanguage}
@@ -256,16 +280,34 @@ export function Hero() {
                           style={style}
                         >
                           <code className="px-4">
-                            {tokens.map((line, lineIndex) => (
-                              <div key={lineIndex} {...getLineProps({ line })}>
-                                {line.map((token, tokenIndex) => (
-                                  <span
-                                    key={tokenIndex}
-                                    {...getTokenProps({ token })}
-                                  />
-                                ))}
-                              </div>
-                            ))}
+                            {tokens.map((line, lineIndex) => {
+                              const lp = getLineProps({ line })
+                              return (
+                                <div
+                                  key={lineIndex}
+                                  {...lp}
+                                  className={clsx(
+                                    lp.className,
+                                    // motion-safe: start opacity-0,
+                                    // animation reveals to 1.
+                                    // motion-reduce: skip both — line is
+                                    // visible at default opacity.
+                                    'motion-safe:animate-line-in motion-safe:opacity-0',
+                                  )}
+                                  style={{
+                                    ...(lp.style || {}),
+                                    animationDelay: `${lineIndex * 60}ms`,
+                                  }}
+                                >
+                                  {line.map((token, tokenIndex) => (
+                                    <span
+                                      key={tokenIndex}
+                                      {...getTokenProps({ token })}
+                                    />
+                                  ))}
+                                </div>
+                              )
+                            })}
                           </code>
                         </pre>
                       )}
diff --git a/src/components/HomePage.jsx b/src/components/HomePage.jsx
index 8683c1e..c29d23a 100644
--- a/src/components/HomePage.jsx
+++ b/src/components/HomePage.jsx
@@ -2,18 +2,32 @@
 import CompanyList from './CompanyTrustedList'
 import DBlistComponent from './DBlistComponent'
 import { Hero } from './Hero'
-// import { Testimonials } from './Testimonials'
 import { QuickLink } from '@/components/QuickLinks'
+import { EcosystemRecognition } from '@/components/EcosystemRecognition'
+import { FadeInOnScroll } from '@/components/FadeInOnScroll'
+import { StaggerChildren } from '@/components/StaggerChildren'
 import blurCyanImage from "@/images/blur-cyan.png";
 import Image from "next/image";
 import React from "react";
 import Testimonials from "@/components/Reviews";
+// Substance first: pitch the framework's value, then prove it. Hero →
+// features → datasources establishes what GoFr does and what it
+// integrates with; the trailing block (logos → ecosystem →
+// testimonials) is one cohesive credibility cluster instead of being
+// split across the page. DBlist + CompanyList share the same dark
+// `bg-gray-900` band, so the transition between them reads as one
+// continuous strip rather than two seams.
 export function HomePage() {
   return (
     <div className="m-auto w-auto max-w-screen-2xl">
+      {/* Density-matched section padding. Uniform `py-24` everywhere
+          made the page feel padded-for-padding's-sake when section
+          content was thin (a 100 px marquee strip, a 1-row logo wall).
+          The pattern Vercel / Stripe / Tailwind use is to scale
+          padding to content height: substantial sections breathe more,
+          thin sections sit closer together. */}
       <Hero />
-      <CompanyList />
-      <div className="not-prose my-12 grid grid-cols-1 gap-6 px-4 md:grid-cols-3 lg:px-8 xl:px-12">
+      <StaggerChildren className="not-prose grid grid-cols-1 gap-6 px-4 py-20 md:grid-cols-3 lg:px-8 xl:px-12">
         <QuickLink
           title="Battle-Tested at Enterprise Scale"
           description="Built over years running production workloads at great scale in a variety of industries."
@@ -44,21 +58,43 @@ export function HomePage() {
           description="GoFr catches panics and automatically recovers to maintain continuous availability of your server."
           icon="crash"
         />
+          {/* Decorative blur orb. `pointer-events-none` is critical: */}
+          {/* without it, this absolutely-positioned image floats over */}
+          {/* sections below the feature grid (DBlist, ecosystem cards, */}
+          {/* testimonials) and silently swallows their clicks. */}
+          {/* `select-none` prevents accidental drag-selection of the */}
+          {/* decorative image on touch devices. Hidden on small */}
+          {/* screens — purely decorative and overflows the viewport */}
+          {/* on mobile due to negative margins / absolute positioning. */}
+          {/* Dropped `unoptimized`: orb PNGs are 200+ KB each, letting */}
+          {/* Next.js serve WebP/AVIF cuts ~60-70% off the wire. Below */}
+          {/* the fold, so swap `priority` for native lazy loading. */}
+          {/* `unoptimized` is required: this site builds with */}
+          {/* output: 'export', which disables /_next/image. Without */}
+          {/* unoptimized, Next emits a /_next/image?url=... src that */}
+          {/* 404s in production and renders as a broken-image icon. */}
           <Image
-              className="absolute opacity-25 mt-80"
+              aria-hidden="true"
+              className="pointer-events-none absolute mt-80 hidden select-none opacity-25 sm:block"
               src={blurCyanImage}
               alt=""
-              width={'h-44'}
+              width={530}
+              height={530}
+              loading="lazy"
               unoptimized
-              priority
           />
-      </div>
 
-      <DBlistComponent />
-      {/*<div className="mx-4 flex flex-col {{ sm:flex-col xs:flex-col md:flex-row lg:flex-row }}  gap-x-8 overflow-y-auto pb-10 gap-y-16 lg:mx-8 xl:mx-12 xl:gap-x-16">*/}
-      {/*  <Testimonials />*/}
-      {/*</div>*/}
-        <Testimonials/>
+      </StaggerChildren>
+
+      {/* Thin marquee strip — minimal external padding (component */}
+      {/* already has its own internal padding). */}
+      <FadeInOnScroll className="py-8"><DBlistComponent /></FadeInOnScroll>
+      {/* Logo wall — medium. */}
+      <FadeInOnScroll className="py-12"><CompanyList /></FadeInOnScroll>
+      {/* 3 ecosystem cards — substantial. */}
+      <FadeInOnScroll className="py-20"><EcosystemRecognition /></FadeInOnScroll>
+      {/* Testimonials masonry — substantial. */}
+      <FadeInOnScroll className="py-20"><Testimonials /></FadeInOnScroll>
     </div>
   )
 }
diff --git a/src/components/HowTo.jsx b/src/components/HowTo.jsx
new file mode 100644
index 0000000..48fb202
--- /dev/null
+++ b/src/components/HowTo.jsx
@@ -0,0 +1,43 @@
+// HowTo wraps a short ordered procedure (e.g. "How to connect MySQL in GoFr").
+// Visually it is a styled ordered list reusing prose vocabulary; semantically
+// it emits HowTo JSON-LD so AI search engines and Google rich results can
+// surface the steps.
+export function HowTo({ name, description, steps = [], children }) {
+  const jsonLd =
+    steps && steps.length
+      ? {
+          '@context': 'https://schema.org',
+          '@type': 'HowTo',
+          name: name,
+          description: description,
+          step: steps.map((s, i) => ({
+            '@type': 'HowToStep',
+            position: i + 1,
+            name: s.name ?? `Step ${i + 1}`,
+            text: s.text,
+          })),
+        }
+      : null
+
+  return (
+    <section className="my-8">
+      {name && (
+        <h2 className="font-display text-xl text-slate-900 dark:text-white">
+          {name}
+        </h2>
+      )}
+      {description && (
+        <p className="mt-2 text-sm text-slate-700 dark:text-slate-400">
+          {description}
+        </p>
+      )}
+      <div className="mt-4">{children}</div>
+      {jsonLd && (
+        <script
+          type="application/ld+json"
+          dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }}
+        />
+      )}
+    </section>
+  )
+}
diff --git a/src/components/LastUpdatedByline.jsx b/src/components/LastUpdatedByline.jsx
new file mode 100644
index 0000000..7e0f928
--- /dev/null
+++ b/src/components/LastUpdatedByline.jsx
@@ -0,0 +1,38 @@
+'use client'
+
+import { usePathname } from 'next/navigation'
+import mtimes from '@/data/doc-mtimes.json'
+
+// Visible "Last updated" line under doc page titles. Date comes from
+// the per-route map generated by utils/generate-doc-mtimes.mjs at
+// build time (git log of the source page file). This is the freshness
+// signal Google's December 2025 core update started rewarding —
+// winners averaged 393 days since last update vs. losers' 500 days.
+//
+// Returns the ISO timestamp string and a formatted human-readable
+// string. The companion `<DocStructuredData lastUpdated={...} />`
+// uses the ISO form for schema.org dateModified.
+export function getLastUpdated(pathname) {
+  if (!pathname) return null
+  const iso = mtimes[pathname]
+  if (!iso) return null
+  return iso
+}
+
+export function LastUpdatedByline() {
+  const pathname = usePathname()
+  const iso = getLastUpdated(pathname)
+  if (!iso) return null
+
+  const formatted = new Date(iso).toLocaleDateString('en-US', {
+    year: 'numeric',
+    month: 'long',
+    day: 'numeric',
+  })
+
+  return (
+    <p className="mt-2 text-xs text-slate-500">
+      Last updated <time dateTime={iso}>{formatted}</time>
+    </p>
+  )
+}
diff --git a/src/components/LatestReleaseBadge.jsx b/src/components/LatestReleaseBadge.jsx
new file mode 100644
index 0000000..4ec54cd
--- /dev/null
+++ b/src/components/LatestReleaseBadge.jsx
@@ -0,0 +1,42 @@
+import Link from 'next/link'
+import releases from '@/app/changelog/releases.json'
+
+// Tiny inline release indicator. Reads the latest tagged release at
+// build time from releases.json and renders a subtle one-line link.
+// Placed under the Hero CTAs so visitors see "what's the latest" right
+// next to the Get Started button — without taking up a whole strip
+// across the top of the page.
+function relativeTime(dateStr) {
+  if (!dateStr) return ''
+  const d = new Date(dateStr)
+  const diffMs = Date.now() - d.getTime()
+  const days = Math.floor(diffMs / 86_400_000)
+  if (days < 1) return 'today'
+  if (days < 2) return 'yesterday'
+  if (days < 30) return `${days} days ago`
+  const months = Math.floor(days / 30)
+  if (months < 12) return `${months} month${months > 1 ? 's' : ''} ago`
+  const years = Math.floor(days / 365)
+  return `${years} year${years > 1 ? 's' : ''} ago`
+}
+
+export function LatestReleaseBadge({ alignClassName = '' }) {
+  const latest = Array.isArray(releases) && releases[0] ? releases[0] : null
+  if (!latest?.tag) return null
+
+  return (
+    <div
+      className={`flex flex-wrap items-center gap-x-1.5 text-xs text-slate-500 ${alignClassName}`}
+    >
+      <span>Latest release:</span>
+      <Link
+        href={`/changelog#${latest.tag}`}
+        className="font-mono text-slate-400 transition-colors hover:text-sky-300"
+      >
+        {latest.tag}
+      </Link>
+      <span className="text-slate-700">·</span>
+      <span>{relativeTime(latest.date)}</span>
+    </div>
+  )
+}
diff --git a/src/components/Layout.jsx b/src/components/Layout.jsx
index 8621a00..1e753ee 100644
--- a/src/components/Layout.jsx
+++ b/src/components/Layout.jsx
@@ -1,16 +1,100 @@
 'use client'
 
-import { useEffect, useState } from 'react'
+import React, { useEffect, useState } from 'react'
 import Link from 'next/link'
 import { usePathname } from 'next/navigation'
 import clsx from 'clsx'
 
 import { MobileNavigation } from '@/components/MobileNavigation'
 import { Search } from '@/components/Search'
+
 import { formatNumber } from '@/lib/common'
-import { ErrorBoundary } from './BugsnagWrapper'
 import FooterUi from '@/components/Footer'
-// import { HackathonLinkButton } from './goforgofr/HackathonLinkButton'
+import githubStarsData from '@/data/github-stars.json'
+
+// Lazy ErrorBoundary that defers @bugsnag/js (~30-40 kB shared) off
+// the critical path. Behaviour:
+//  - On idle (or after a short timeout) we dynamic-import the Bugsnag
+//    SDK + React plugin and swap the live boundary in via setState.
+//  - Until then, the fallback boundary catches errors and renders the
+//    FallbackComponent. If an error occurs before Bugsnag has loaded
+//    we accept the silent no-op on telemetry — the user-visible UX is
+//    identical (fallback still renders), only the report is lost.
+class FallbackErrorBoundary extends React.Component {
+  constructor(props) {
+    super(props)
+    this.state = { hasError: false }
+  }
+  static getDerivedStateFromError() {
+    return { hasError: true }
+  }
+  componentDidCatch() {
+    // Pre-Bugsnag: swallow. The user-visible fallback still renders.
+  }
+  render() {
+    if (this.state.hasError) {
+      const Fallback = this.props.FallbackComponent
+      return Fallback ? <Fallback /> : null
+    }
+    return this.props.children
+  }
+}
+
+function LazyBugsnagBoundary({ FallbackComponent, children }) {
+  const [LiveBoundary, setLiveBoundary] = useState(null)
+
+  useEffect(() => {
+    if (typeof window === 'undefined') return
+    let cancelled = false
+    const init = async () => {
+      try {
+        const [{ default: Bugsnag }, { default: BugsnagPluginReact }] =
+          await Promise.all([
+            import('@bugsnag/js'),
+            import('@bugsnag/plugin-react'),
+          ])
+        if (cancelled) return
+        Bugsnag.start({
+          apiKey: 'b6dc4b3bd26c10a6d7b062b15be8a26f',
+          plugins: [new BugsnagPluginReact()],
+        })
+        const Boundary = Bugsnag.getPlugin('react').createErrorBoundary(React)
+        setLiveBoundary(() => Boundary)
+      } catch {
+        // Network or chunk-load failure — keep using the fallback.
+      }
+    }
+
+    const ric = window.requestIdleCallback
+    if (typeof ric === 'function') {
+      const handle = ric(init, { timeout: 4000 })
+      return () => {
+        cancelled = true
+        if (typeof window.cancelIdleCallback === 'function') {
+          window.cancelIdleCallback(handle)
+        }
+      }
+    }
+    const t = setTimeout(init, 1500)
+    return () => {
+      cancelled = true
+      clearTimeout(t)
+    }
+  }, [])
+
+  if (LiveBoundary) {
+    return (
+      <LiveBoundary FallbackComponent={FallbackComponent}>
+        {children}
+      </LiveBoundary>
+    )
+  }
+  return (
+    <FallbackErrorBoundary FallbackComponent={FallbackComponent}>
+      {children}
+    </FallbackErrorBoundary>
+  )
+}
 
 export function GitHubIcon(props) {
   return (
@@ -20,38 +104,45 @@ export function GitHubIcon(props) {
   )
 }
 
+const navLinks = [
+  { title: 'Docs', href: '/docs', match: '/docs' },
+  { title: 'Changelog', href: '/changelog', match: '/changelog' },
+  { title: 'Examples', href: '/examples', match: '/examples' },
+]
+
 function Header() {
   let [isScrolled, setIsScrolled] = useState(false)
   let pathname = usePathname()
   const isCertificate = pathname.includes('certificate')
   const isEvents = pathname.includes('events')
-  const [githubStars, setGithubStars] = useState(null)
+  // Stars are baked in at build time by utils/fetch-github-stars.mjs
+  // so the Header renders the real number on first paint without an
+  // API round-trip. We optionally re-sync once per session in the
+  // background to keep long-lived browsers fresh — but never block.
+  const initialStars =
+    (githubStarsData && githubStarsData.stars) || null
+  const [githubStars, setGithubStars] = useState(initialStars)
 
   useEffect(() => {
-    const fetchRepoData = async () => {
-      try {
-        const response = await fetch(
-          'https://api.github.com/repos/gofr-dev/gofr',
-        )
-        if (!response.ok) {
-          throw new Error('Network response was not ok')
-        }
-        const data = await response.json()
-
-        if (data?.watchers) {
-          setGithubStars(data.watchers)
-          localStorage.setItem('githubStars', data.watchers)
-        }
-      } catch (error) {
-        console.error('Error fetching the repo data:', error)
-      }
-    }
-    fetchRepoData()
     function onScroll() {
       setIsScrolled(window.scrollY > 0)
     }
     onScroll()
     window.addEventListener('scroll', onScroll, { passive: true })
+
+    // Live refresh on every page load. The build-time snapshot in
+    // src/data/github-stars.json gives an instantly-correct first paint;
+    // this fetch then replaces it with the truly current number so the
+    // header stays real-time. Failures are silent — we keep the
+    // pre-paint number.
+    fetch('https://api.github.com/repos/gofr-dev/gofr')
+      .then((r) => (r.ok ? r.json() : null))
+      .then((data) => {
+        const live = data?.stargazers_count ?? data?.watchers
+        if (typeof live === 'number') setGithubStars(live)
+      })
+      .catch(() => {})
+
     return () => {
       window.removeEventListener('scroll', onScroll)
     }
@@ -71,7 +162,7 @@ function Header() {
           <MobileNavigation />
         </div>
       )}
-      <div className="relative flex flex-grow basis-0 items-center">
+      <div className="relative flex flex-grow basis-0 items-center gap-6">
         <Link href="/" aria-label="Home page" className="flex items-center">
           <span className="text-3xl font-bold italic text-sky-400">
             Go{' '}
@@ -80,6 +171,31 @@ function Header() {
             </span>
           </span>
         </Link>
+        {!isCertificate && (
+          <nav className="hidden lg:flex lg:items-center lg:gap-4">
+            {navLinks.map((link) => (
+              <Link
+                key={link.title}
+                href={link.href}
+                target={link.external ? '_blank' : undefined}
+                className={clsx(
+                  'text-xs transition-colors',
+                  link.match && pathname.startsWith(link.match)
+                    ? 'text-sky-400'
+                    : 'text-slate-400 hover:text-slate-300',
+                )}
+              >
+                {link.title}
+                {link.external && (
+                  <svg className="ml-0.5 inline-block h-3 w-3 opacity-50" fill="none" viewBox="0 0 12 12">
+                    <path d="M3.5 3.5h5v5" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" />
+                    <path d="M8.5 3.5L3 9" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" />
+                  </svg>
+                )}
+              </Link>
+            ))}
+          </nav>
+        )}
       </div>
       {!isCertificate && !isEvents && (
         <div className="-my-5 mr-6 sm:mr-8 md:mr-0">
@@ -93,7 +209,7 @@ function Header() {
           </h1>
         </div>
       )}
-      <div className="relative flex flex-grow basis-0 items-center justify-end gap-2 sm:gap-3 md:flex-grow">
+      <div className="relative flex flex-grow basis-0 items-center justify-end gap-3 sm:gap-4 md:flex-grow">
         <Link
           href="https://github.com/gofr-dev/gofr"
           className="group"
@@ -140,26 +256,29 @@ const ErrorView = () => (
 
 export function Layout({ children }) {
   const pathname = usePathname()
-  console.log(pathname)
-
-  const isHackathon = pathname === '/hackathon'
 
   return (
-    <ErrorBoundary FallbackComponent={ErrorView}>
+    <LazyBugsnagBoundary FallbackComponent={ErrorView}>
       <div className="flex w-full flex-col">
+        {/* Skip-to-main link — first focusable element so keyboard */}
+        {/* and screen-reader users can bypass the global nav per */}
+        {/* WCAG 2.4.1. Visually hidden until focused. */}
+        <a
+          href="#main"
+          className="sr-only focus:not-sr-only focus:absolute focus:left-4 focus:top-4 focus:z-50 focus:rounded-md focus:bg-sky-300 focus:px-3 focus:py-2 focus:text-sm focus:font-semibold focus:text-slate-900 focus:shadow-lg"
+        >
+          Skip to main content
+        </a>
         {pathname !== '/hackathon' && (
           <>
-            {/* <div className="relative z-50 sm:fixed sm:left-0 sm:right-0 sm:top-0">
-              <HackathonLinkButton />
-            </div> */}
             <div className="sticky left-0 right-0 top-0 z-40 sm:top-0">
               <Header />
             </div>
           </>
         )}
-        {children}
+        <main id="main">{children}</main>
         <FooterUi />
       </div>
-    </ErrorBoundary>
+    </LazyBugsnagBoundary>
   )
 }
diff --git a/src/components/MarketingPage.jsx b/src/components/MarketingPage.jsx
new file mode 100644
index 0000000..73db1ec
--- /dev/null
+++ b/src/components/MarketingPage.jsx
@@ -0,0 +1,15 @@
+// Wrapper for the SEO-only Markdoc pages (/why-gofr, /comparison/*,
+// /migrate/*, /learn, /faq). It supplies the flex container DocsLayout
+// expects, but unlike DocsPage it does NOT render a left sidebar — these
+// pages aren't core navigation, they're SEO landing content. Right-rail
+// "On this page" TOC from DocsLayout still renders. Cross-links to the
+// other SEO pages live in the global footer.
+export function MarketingPage({ children }) {
+  return (
+    <div>
+      <div className="relative mx-auto flex w-full max-w-screen-2xl flex-auto justify-center sm:px-2 lg:px-8 xl:px-12">
+        {children}
+      </div>
+    </div>
+  )
+}
diff --git a/src/components/MobileNavigation.jsx b/src/components/MobileNavigation.jsx
index c404f5c..4e0b6d7 100644
--- a/src/components/MobileNavigation.jsx
+++ b/src/components/MobileNavigation.jsx
@@ -49,6 +49,14 @@ function CloseOnNavigation({ close }) {
   return null
 }
 
+const siteLinks = [
+  { title: 'Docs', href: '/docs' },
+  { title: 'Changelog', href: '/changelog' },
+  { title: 'Examples', href: '/examples' },
+  { title: 'Showcase', href: '/showcase' },
+  { title: 'Blog', href: 'https://medium.com/gofr', external: true },
+]
+
 export function MobileNavigation() {
   let [isOpen, setIsOpen] = useState(false)
   let close = useCallback(() => setIsOpen(false), [setIsOpen])
@@ -82,7 +90,7 @@ export function MobileNavigation() {
         className="fixed inset-0 z-50 flex items-start overflow-y-auto bg-slate-900/50 pr-10 backdrop-blur lg:hidden"
         aria-label="Navigation"
       >
-        <Dialog.Panel className="min-h-full w-full max-w-xs bg-white px-4 pb-12 pt-5 dark:bg-slate-900 sm:px-6">
+        <Dialog.Panel className="min-h-full w-full max-w-[85vw] sm:max-w-xs bg-white px-4 pb-12 pt-5 dark:bg-slate-900 sm:px-6">
           <div className="flex items-center">
             <button
               type="button"
@@ -95,6 +103,28 @@ export function MobileNavigation() {
               <Logomark className="h-9 w-9" />
             </Link>
           </div>
+          <nav className="mt-5 border-b border-slate-200 pb-4 dark:border-slate-800">
+            <ul className="space-y-2">
+              {siteLinks.map((link) => (
+                <li key={link.title}>
+                  <Link
+                    href={link.href}
+                    target={link.external ? '_blank' : undefined}
+                    onClick={onLinkClick}
+                    className="flex items-center rounded-lg px-3 py-2 text-sm font-medium text-slate-700 hover:bg-slate-100 dark:text-slate-300 dark:hover:bg-slate-800"
+                  >
+                    {link.title}
+                    {link.external && (
+                      <svg className="ml-1 h-3 w-3 opacity-50" fill="none" viewBox="0 0 12 12">
+                        <path d="M3.5 3.5h5v5" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" />
+                        <path d="M8.5 3.5L3 9" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" />
+                      </svg>
+                    )}
+                  </Link>
+                </li>
+              ))}
+            </ul>
+          </nav>
           <Navigation className="mt-5 px-1" onLinkClick={onLinkClick} />
         </Dialog.Panel>
       </Dialog>
diff --git a/src/components/Navigation.jsx b/src/components/Navigation.jsx
index a3eafee..68e5e9a 100644
--- a/src/components/Navigation.jsx
+++ b/src/components/Navigation.jsx
@@ -1,3 +1,6 @@
+'use client'
+
+import { useState, useEffect } from 'react'
 import Link from 'next/link'
 import { usePathname } from 'next/navigation'
 import clsx from 'clsx'
@@ -7,37 +10,77 @@ import { navigation } from '@/lib/navigation'
 export function Navigation({ className, onLinkClick }) {
   let pathname = usePathname()
 
+  // Track which sections are expanded
+  let [expanded, setExpanded] = useState(() => {
+    let defaults = {}
+    for (let section of navigation) {
+      // Expand Quick Start by default
+      if (section.title.toLowerCase().includes('quick start')) {
+        defaults[section.title] = true
+      }
+    }
+    return defaults
+  })
+
+  // Auto-expand section containing active page
+  useEffect(() => {
+    let active = navigation.find((s) => s.links.find((l) => l.href === pathname))
+    if (active) {
+      setExpanded((prev) => ({ ...prev, [active.title]: true }))
+    }
+  }, [pathname])
+
   return (
     <nav className={clsx('text-base lg:text-sm', className)}>
-      <ul role="list" className="space-y-9">
-        {navigation.map((section) => (
-          <li key={section.title}>
-            <h2 className="font-display font-medium text-slate-900 dark:text-white">
-              {section.title}
-            </h2>
-            <ul
-              role="list"
-              className="mt-2 space-y-2 border-l-2 border-slate-100 dark:border-slate-800 lg:mt-4 lg:space-y-4 lg:border-slate-200"
-            >
-              {section.links.map((link) => (
-                <li key={link.href} className="relative">
-                  <Link
-                    href={link.href}
-                    onClick={onLinkClick}
-                    className={clsx(
-                      'block w-full pl-3.5 before:pointer-events-none before:absolute before:-left-1 before:top-1/2 before:h-1.5 before:w-1.5 before:-translate-y-1/2 before:rounded-full',
-                      link.href === pathname
-                        ? 'font-semibold text-sky-500 before:bg-sky-500'
-                        : 'text-slate-500 before:hidden before:bg-slate-300 hover:text-slate-600 hover:before:block dark:text-slate-400 dark:before:bg-slate-700 dark:hover:text-slate-300',
-                    )}
-                  >
-                    {link.title}
-                  </Link>
-                </li>
-              ))}
-            </ul>
-          </li>
-        ))}
+      <ul role="list" className="space-y-8">
+        {navigation.map((section) => {
+          let isOpen = expanded[section.title] ?? false
+
+          return (
+            <li key={section.title}>
+              <button
+                onClick={() => setExpanded((p) => ({ ...p, [section.title]: !p[section.title] }))}
+                className="flex w-full items-center justify-between text-left"
+              >
+                <h2 className="font-display text-sm font-semibold text-slate-900 dark:text-white">
+                  {section.title}
+                </h2>
+                <svg
+                  className={clsx(
+                    'h-3 w-3 flex-none text-slate-400 transition-transform duration-150',
+                    isOpen && 'rotate-90',
+                  )}
+                  viewBox="0 0 16 16" fill="none"
+                >
+                  <path d="M6 4l4 4-4 4" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" />
+                </svg>
+              </button>
+              {isOpen && (
+                <ul
+                  role="list"
+                  className="mt-3 border-l border-slate-200 dark:border-slate-800"
+                >
+                  {section.links.map((link) => (
+                    <li key={link.href}>
+                      <Link
+                        href={link.href}
+                        onClick={onLinkClick}
+                        className={clsx(
+                          '-ml-px block border-l py-1.5 pl-4 text-sm',
+                          link.href === pathname
+                            ? 'border-sky-500 font-semibold text-sky-500'
+                            : 'border-transparent text-slate-500 hover:border-slate-300 hover:text-slate-700 dark:text-slate-400 dark:hover:border-slate-600 dark:hover:text-slate-300',
+                        )}
+                      >
+                        {link.title}
+                      </Link>
+                    </li>
+                  ))}
+                </ul>
+              )}
+            </li>
+          )
+        })}
       </ul>
     </nav>
   )
diff --git a/src/components/PkgRedirect.jsx b/src/components/PkgRedirect.jsx
new file mode 100644
index 0000000..b27b0e1
--- /dev/null
+++ b/src/components/PkgRedirect.jsx
@@ -0,0 +1,50 @@
+'use client'
+
+import { useEffect } from 'react'
+import Link from 'next/link'
+
+export function PkgRedirect({ name, docsPath }) {
+  useEffect(() => {
+    if (docsPath) {
+      const timer = setTimeout(() => {
+        window.location.href = docsPath
+      }, 3000)
+      return () => clearTimeout(timer)
+    }
+  }, [docsPath])
+
+  return (
+    <div className="flex min-h-[60vh] items-center justify-center px-4">
+      <div className="text-center">
+        <p className="text-sm font-medium text-sky-500">Go Package</p>
+        <h1 className="mt-2 font-display text-2xl font-bold text-slate-900 dark:text-white">
+          {name}
+        </h1>
+        <p className="mt-3 text-slate-600 dark:text-slate-400">
+          This page exists for Go module import resolution.
+        </p>
+        {docsPath ? (
+          <Link
+            href={docsPath}
+            className="mt-4 inline-flex items-center gap-1.5 text-sm font-medium text-sky-500 hover:text-sky-600"
+          >
+            View documentation
+            <svg className="h-3.5 w-3.5" viewBox="0 0 16 16" fill="currentColor">
+              <path fillRule="evenodd" d="M2 8a.75.75 0 01.75-.75h8.69L8.22 4.03a.75.75 0 011.06-1.06l4.5 4.5a.75.75 0 010 1.06l-4.5 4.5a.75.75 0 01-1.06-1.06l3.22-3.22H2.75A.75.75 0 012 8z" clipRule="evenodd" />
+            </svg>
+          </Link>
+        ) : (
+          <Link
+            href="/docs/datasources/getting-started"
+            className="mt-4 inline-flex items-center gap-1.5 text-sm font-medium text-sky-500 hover:text-sky-600"
+          >
+            View datasource documentation
+            <svg className="h-3.5 w-3.5" viewBox="0 0 16 16" fill="currentColor">
+              <path fillRule="evenodd" d="M2 8a.75.75 0 01.75-.75h8.69L8.22 4.03a.75.75 0 011.06-1.06l4.5 4.5a.75.75 0 010 1.06l-4.5 4.5a.75.75 0 01-1.06-1.06l3.22-3.22H2.75A.75.75 0 012 8z" clipRule="evenodd" />
+            </svg>
+          </Link>
+        )}
+      </div>
+    </div>
+  )
+}
diff --git a/src/components/Prose.jsx b/src/components/Prose.jsx
index 765cde5..1fe1d63 100644
--- a/src/components/Prose.jsx
+++ b/src/components/Prose.jsx
@@ -7,9 +7,9 @@ export function Prose({ as, className, ...props }) {
     <Component
       className={clsx(
         className,
-        'prose prose-slate max-w-none dark:prose-invert dark:text-slate-400',
+        'prose prose-slate max-w-none dark:prose-invert dark:text-slate-300',
         // headings
-        'prose-headings:scroll-mt-28 prose-headings:font-display prose-headings:font-normal lg:prose-headings:scroll-mt-[8.5rem]',
+        'prose-headings:scroll-mt-28 prose-headings:font-display prose-headings:font-semibold lg:prose-headings:scroll-mt-[8.5rem]',
         // lead
         'prose-lead:text-slate-500 dark:prose-lead:text-slate-400',
         // links
@@ -17,9 +17,19 @@ export function Prose({ as, className, ...props }) {
         // link underline
         'prose-a:no-underline prose-a:shadow-[inset_0_-2px_0_0_var(--tw-prose-background,#fff),inset_0_calc(-1*(var(--tw-prose-underline-size,4px)+2px))_0_0_var(--tw-prose-underline,theme(colors.sky.300))] hover:prose-a:[--tw-prose-underline-size:6px] dark:[--tw-prose-background:theme(colors.slate.900)] dark:prose-a:shadow-[inset_0_calc(-1*var(--tw-prose-underline-size,2px))_0_0_var(--tw-prose-underline,theme(colors.sky.800))] dark:hover:prose-a:[--tw-prose-underline-size:6px]',
         // pre
-        'prose-pre:rounded-xl prose-pre:bg-slate-900 prose-pre:shadow-lg dark:prose-pre:bg-slate-800/60 dark:prose-pre:shadow-none dark:prose-pre:ring-1 dark:prose-pre:ring-slate-300/10',
+        'prose-pre:rounded-lg prose-pre:bg-slate-900 prose-pre:shadow-lg dark:prose-pre:bg-slate-800/60 dark:prose-pre:shadow-none dark:prose-pre:ring-1 dark:prose-pre:ring-slate-300/10',
+        // inline code
+        'prose-code:rounded prose-code:bg-slate-100 prose-code:px-1.5 prose-code:py-0.5 prose-code:text-[0.8125em] prose-code:font-medium prose-code:before:content-none prose-code:after:content-none dark:prose-code:bg-slate-800 dark:prose-code:text-slate-300',
         // hr
         'dark:prose-hr:border-slate-800',
+        // tables
+        'prose-table:text-sm',
+        'prose-thead:border-b prose-thead:border-slate-200 dark:prose-thead:border-slate-700',
+        'prose-th:py-2 prose-th:text-left prose-th:font-semibold prose-th:text-slate-900 dark:prose-th:text-slate-200',
+        'prose-td:py-2',
+        'prose-tr:border-b prose-tr:border-slate-100 dark:prose-tr:border-slate-800',
+        // images
+        'prose-img:rounded-lg',
       )}
       {...props}
     />
diff --git a/src/components/QuickLinks.jsx b/src/components/QuickLinks.jsx
index 3332d3a..07291bf 100644
--- a/src/components/QuickLinks.jsx
+++ b/src/components/QuickLinks.jsx
@@ -14,7 +14,7 @@ export function QuickLink({ title, description, icon, href }) {
   return (
     <Container 
       href={href}
-      className={`group relative rounded-xl border border-slate-200 dark:border-slate-800 block ${
+      className={`group relative block rounded-xl border border-slate-200 transition-transform duration-300 hover:-translate-y-1 dark:border-slate-800 ${
         href ? 'no-underline hover:cursor-pointer' : ''
       }`}
     >
diff --git a/src/components/Reviews.jsx b/src/components/Reviews.jsx
index fc005e0..81d9d51 100644
--- a/src/components/Reviews.jsx
+++ b/src/components/Reviews.jsx
@@ -5,11 +5,11 @@ import testimonials from 'utils/testimonials.json'
 
 export default function Testimonials() {
     return (
-        <div className="mx-10 bg-[#101827]">
+        <div className="mx-4 sm:mx-10">
             {/*<h2 className="text-center text-lg font-semibold leading-8 text-white mb-10">*/}
             {/*    User Testimonials*/}
             {/*</h2>*/}
-            <div className="md:columns-3">
+            <div className="sm:columns-2 md:columns-3">
                 {testimonials.map((testimonial, index) => (
                     <div key={index} className="group inline-block relative my-3 rounded-xl border cursor-default border-slate-200 dark:border-slate-800 p-1">
                         <div className="absolute -inset-px rounded-xl border-2 border-transparent opacity-0 [background:linear-gradient(var(--quick-links-hover-bg,theme(colors.sky.50)),var(--quick-links-hover-bg,theme(colors.sky.50)))_padding-box,linear-gradient(to_top,theme(colors.indigo.400),theme(colors.cyan.400),theme(colors.sky.500))_border-box] group-hover:opacity-100 dark:[--quick-links-hover-bg:theme(colors.slate.800)]" />
@@ -40,11 +40,11 @@ export default function Testimonials() {
                                     )}
 
                                     {/*<div className="h-10 w-10 rounded-full bg-gray-300"></div>*/}
-                                    <div>
-                                        <p className="font-medium text-slate-900 dark:text-white">
+                                    <div className="min-w-0">
+                                        <p className="font-medium text-slate-900 dark:text-white truncate">
                                             {testimonial?.author}
                                         </p>
-                                        <p className="text-sm text-slate-700 dark:text-slate-400">
+                                        <p className="text-sm text-slate-700 dark:text-slate-400 truncate">
                                             {testimonial?.role}
                                         </p>
                                     </div>
diff --git a/src/components/Search.jsx b/src/components/Search.jsx
index cab6634..83bff5e 100644
--- a/src/components/Search.jsx
+++ b/src/components/Search.jsx
@@ -50,7 +50,7 @@ function useAutocomplete({ close }) {
   let [autocomplete] = useState(() =>
     createAutocomplete({
       id,
-      placeholder: 'Find something...',
+      placeholder: 'Search docs...',
       defaultActiveItemId: 0,
       onStateChange({ state }) {
         setAutocompleteState(state)
@@ -67,12 +67,15 @@ function useAutocomplete({ close }) {
             {
               sourceId: 'documentation',
               getItems() {
-                return search(query, { limit: 5 })
+                let result = search(query, { limit: 8 })
+                // Handle both { items: [...] } and direct array formats
+                if (result && result.items) return result.items
+                if (Array.isArray(result)) return result
+                return []
               },
               getItemUrl({ item }) {
                 return item?.url || ''
               },
-
               onSelect: navigate,
             },
           ]
@@ -116,63 +119,44 @@ function LoadingIcon(props) {
 function HighlightQuery({ text, query }) {
   return (
     <Highlighter
-      highlightClassName="group-aria-selected:underline bg-transparent text-sky-600 dark:text-sky-400"
+      highlightClassName="bg-transparent text-sky-600 dark:text-sky-400 font-semibold"
       searchWords={[query]}
       autoEscape={true}
-      textToHighlight={text}
+      textToHighlight={text || ''}
     />
   )
 }
 
-function SearchResult({ result, autocomplete, collection, query, index }) {
+function SearchResult({ result, autocomplete, collection, query }) {
   let sectionTitle = navigation.find((section) =>
-    section.links.find((link) => link.href === result?.url.split('#')[0]),
+    section.links.find((link) => link.href === result?.url?.split('#')[0]),
   )?.title
 
   let hierarchy = [sectionTitle, result.pageTitle].filter(
-    (x) => typeof x === 'string',
+    (x) => typeof x === 'string' && x.trim() !== '',
   )
 
   const id = useId()
 
   return (
     <li
-      className="block cursor-default rounded-lg px-3 py-2 "
+      className="cursor-pointer rounded-lg px-3 py-2.5 transition-colors hover:bg-slate-100 dark:hover:bg-slate-700/30"
       aria-labelledby={`${id}-hierarchy ${id}-title`}
       {...autocomplete.getItemProps({
         item: result,
         source: collection.source,
       })}
-      onMouseEnter={(e) => {
-        e.currentTarget.classList.add('bg-slate-100', 'dark:bg-slate-700/30')
-        const titleEl = e.currentTarget.querySelector('[data-title]')
-        if (titleEl) {
-          titleEl.classList.add('text-sky-600', 'dark:text-sky-400')
-          titleEl.classList.remove('text-slate-700', 'dark:text-slate-300')
-        }
-      }}
-      onMouseLeave={(e) => {
-        e.currentTarget.classList.remove('bg-slate-100', 'dark:bg-slate-700/30')
-        const titleEl = e.currentTarget.querySelector('[data-title]')
-        if (titleEl) {
-          titleEl.classList.remove('text-sky-600', 'dark:text-sky-400')
-          titleEl.classList.add('text-slate-700', 'dark:text-slate-300')
-        }
-      }}
     >
       <div
         id={`${id}-title`}
-        data-title
-        aria-hidden="true"
-        className="text-sm text-slate-700 group-aria-selected:text-sky-600 dark:text-slate-300 dark:group-aria-selected:text-sky-400"
+        className="text-sm font-medium text-slate-700 dark:text-slate-300"
       >
         <HighlightQuery text={result.title} query={query} />
       </div>
       {hierarchy.length > 0 && (
         <div
           id={`${id}-hierarchy`}
-          aria-hidden="true"
-          className="mt-0.5 truncate whitespace-nowrap text-xs text-slate-500 dark:text-slate-400"
+          className="mt-0.5 truncate text-xs text-slate-500 dark:text-slate-400"
         >
           {hierarchy
             .filter((item) => item && item.trim().toLowerCase() !== 'untitled')
@@ -183,7 +167,7 @@ function SearchResult({ result, autocomplete, collection, query, index }) {
                   className={
                     itemIndex === items.length - 1
                       ? 'sr-only'
-                      : 'mx-2 text-slate-300 dark:text-slate-700'
+                      : 'mx-1.5 text-slate-300 dark:text-slate-600'
                   }
                 >
                   /
@@ -196,30 +180,44 @@ function SearchResult({ result, autocomplete, collection, query, index }) {
   )
 }
 
+// Extract items from various result formats
+function extractItems(collection) {
+  if (!collection || !collection.items) return []
+
+  let items = collection.items
+
+  // Handle nested format: items[0].items
+  if (items.length > 0 && items[0] && items[0].items && Array.isArray(items[0].items)) {
+    items = items[0].items
+  }
+
+  return items
+}
+
 function SearchResults({ autocomplete, query, collection }) {
-  if (collection.items[0].items.length === 0) {
+  let rawItems = extractItems(collection)
+
+  if (!rawItems || rawItems.length === 0) {
     return (
-      <p className="px-4 py-8 text-center text-sm text-slate-700 dark:text-slate-400">
-        Couldn't find what you are looking for?&nbsp;
+      <div className="px-4 py-8 text-center">
+        <p className="text-sm text-slate-500 dark:text-slate-400">
+          No results found for &ldquo;
+          <span className="font-medium text-slate-700 dark:text-slate-300">
+            {query}
+          </span>
+          &rdquo;
+        </p>
         <Link
           href="https://github.com/gofr-dev/gofr/issues"
           target="_blank"
-          className="underline"
+          className="mt-2 inline-block text-sm text-sky-500 hover:text-sky-600"
         >
-          Create an Issue on GitHub for &ldquo;
-          <span className="break-words text-slate-900 dark:text-white">
-            {query}
-          </span>
-          &rdquo;
+          Create an issue on GitHub
         </Link>
-      </p>
+      </div>
     )
   }
 
-  let rawItems = []
-
-  rawItems = collection.items[0].items
-
   let filtered = rawItems.filter(
     (item) =>
       item &&
@@ -228,30 +226,33 @@ function SearchResults({ autocomplete, query, collection }) {
       item.title.trim().toLowerCase() !== 'untitled',
   )
 
-  // if (filtered.length === 0) {
-  //   return (
-  //     <p className="px-4 py-8 text-center text-sm text-slate-700 dark:text-slate-400">
-  //       No results found for &ldquo;
-  //       <span className="break-words text-slate-900 dark:text-white">
-  //         {query}
-  //       </span>
-  //       &rdquo;
-  //     </p>
-  //   )
-  // }
+  // Proper URL deduplication
   let seenUrls = new Set()
   let deduped = []
   for (let item of filtered) {
-    // Only the part before the '#'
-    let baseUrl = item.url.split('#')
+    let baseUrl = item.url.split('#')[0]
     if (!seenUrls.has(baseUrl)) {
       seenUrls.add(baseUrl)
       deduped.push(item)
     }
   }
 
+  if (deduped.length === 0) {
+    return (
+      <div className="px-4 py-8 text-center">
+        <p className="text-sm text-slate-500 dark:text-slate-400">
+          No results found for &ldquo;
+          <span className="font-medium text-slate-700 dark:text-slate-300">
+            {query}
+          </span>
+          &rdquo;
+        </p>
+      </div>
+    )
+  }
+
   return (
-    <ul {...autocomplete.getListProps()}>
+    <ul {...autocomplete.getListProps()} className="divide-y divide-slate-100 dark:divide-slate-700/50">
       {deduped.map((result, index) => (
         <SearchResult
           key={`${result.url}-${index}`}
@@ -259,12 +260,12 @@ function SearchResults({ autocomplete, query, collection }) {
           autocomplete={autocomplete}
           collection={collection}
           query={query}
-          index={index}
         />
       ))}
     </ul>
   )
 }
+
 const SearchInput = forwardRef(function SearchInput(
   { autocomplete, autocompleteState, onClose },
   inputRef,
@@ -276,6 +277,7 @@ const SearchInput = forwardRef(function SearchInput(
       <SearchIcon className="pointer-events-none absolute left-4 top-0 h-full w-5 fill-slate-400 dark:fill-slate-500" />
       <input
         ref={inputRef}
+        aria-label="Search documentation"
         className={clsx(
           'flex-auto appearance-none bg-transparent pl-12 text-slate-900 outline-none placeholder:text-slate-400 focus:w-full focus:flex-none dark:text-white sm:text-sm [&::-webkit-search-cancel-button]:hidden [&::-webkit-search-decoration]:hidden [&::-webkit-search-results-button]:hidden [&::-webkit-search-results-decoration]:hidden',
           autocompleteState.status === 'stalled' ? 'pr-11' : 'pr-4',
@@ -287,8 +289,6 @@ const SearchInput = forwardRef(function SearchInput(
             !autocompleteState.isOpen &&
             autocompleteState.query === ''
           ) {
-            // In Safari, closing the dialog with the escape key can sometimes cause the scroll position to jump to the
-            // bottom of the page. This is a workaround for that until we can figure out a proper fix in Headless UI.
             if (document.activeElement instanceof HTMLElement) {
               document.activeElement.blur()
             }
@@ -370,7 +370,7 @@ function SearchDialog({ open, setOpen, className }) {
         <div className="fixed inset-0 bg-slate-900/50 backdrop-blur" />
 
         <div className="fixed inset-0 overflow-y-auto px-4 py-4 sm:px-6 sm:py-20 md:py-32 lg:px-8 lg:py-[15vh]">
-          <Dialog.Panel className="mx-auto transform-gpu overflow-hidden rounded-xl bg-white shadow-xl dark:bg-slate-800 dark:ring-1 dark:ring-slate-700 sm:max-w-xl">
+          <Dialog.Panel className="mx-auto transform-gpu overflow-hidden rounded-xl bg-white shadow-2xl ring-1 ring-slate-200 dark:bg-slate-800 dark:ring-slate-700 sm:max-w-xl">
             <div {...autocomplete.getRootProps({})}>
               <form
                 ref={formRef}
@@ -386,7 +386,7 @@ function SearchDialog({ open, setOpen, className }) {
                 />
                 <div
                   ref={panelRef}
-                  className="border-t border-slate-200 bg-white px-2 py-3 empty:hidden dark:border-slate-400/10 dark:bg-slate-800"
+                  className="max-h-[60vh] overflow-y-auto border-t border-slate-200 bg-white px-2 py-3 empty:hidden dark:border-slate-700 dark:bg-slate-800"
                   {...autocomplete.getPanelProps({})}
                 >
                   {autocompleteState.isOpen && (
@@ -399,6 +399,27 @@ function SearchDialog({ open, setOpen, className }) {
                 </div>
               </form>
             </div>
+            {/* Keyboard hints */}
+            <div className="flex items-center gap-4 border-t border-slate-200 px-4 py-2.5 dark:border-slate-700">
+              <div className="flex items-center gap-1.5 text-xs text-slate-400">
+                <kbd className="rounded border border-slate-200 px-1.5 py-0.5 font-mono text-[10px] dark:border-slate-600">
+                  &darr;&uarr;
+                </kbd>
+                <span>Navigate</span>
+              </div>
+              <div className="flex items-center gap-1.5 text-xs text-slate-400">
+                <kbd className="rounded border border-slate-200 px-1.5 py-0.5 font-mono text-[10px] dark:border-slate-600">
+                  Enter
+                </kbd>
+                <span>Open</span>
+              </div>
+              <div className="flex items-center gap-1.5 text-xs text-slate-400">
+                <kbd className="rounded border border-slate-200 px-1.5 py-0.5 font-mono text-[10px] dark:border-slate-600">
+                  Esc
+                </kbd>
+                <span>Close</span>
+              </div>
+            </div>
           </Dialog.Panel>
         </div>
       </Dialog>
diff --git a/src/components/SectionCards.jsx b/src/components/SectionCards.jsx
new file mode 100644
index 0000000..cbc49f3
--- /dev/null
+++ b/src/components/SectionCards.jsx
@@ -0,0 +1,71 @@
+import Link from 'next/link'
+import { navigation } from '@/lib/navigation'
+
+const sectionIcons = {
+  'quick start': (
+    <svg className="h-6 w-6 text-emerald-500" viewBox="0 0 24 24" fill="currentColor">
+      <path d="M13 2L3 14h9l-1 8 10-12h-9l1-8z" />
+    </svg>
+  ),
+  advanced: (
+    <svg className="h-6 w-6 text-violet-500" viewBox="0 0 24 24" fill="currentColor">
+      <path d="M12 6V4m0 2a2 2 0 100 4m0-4a2 2 0 110 4m-6 8a2 2 0 100-4m0 4a2 2 0 110-4m0 4v2m0-6V4m6 6v10m6-2a2 2 0 100-4m0 4a2 2 0 110-4m0 4v2m0-6V4" stroke="currentColor" fill="none" strokeWidth="2" strokeLinecap="round" />
+    </svg>
+  ),
+  datasource: (
+    <svg className="h-6 w-6 text-sky-500" viewBox="0 0 24 24" fill="currentColor">
+      <path d="M4 7v10c0 2.21 3.582 4 8 4s8-1.79 8-4V7M4 7c0 2.21 3.582 4 8 4s8-1.79 8-4M4 7c0-2.21 3.582-4 8-4s8 1.79 8 4m0 5c0 2.21-3.582 4-8 4s-8-1.79-8-4" stroke="currentColor" fill="none" strokeWidth="1.5" />
+    </svg>
+  ),
+  reference: (
+    <svg className="h-6 w-6 text-amber-500" viewBox="0 0 24 24" fill="currentColor">
+      <path d="M12 6.042A8.967 8.967 0 006 3.75c-1.052 0-2.062.18-3 .512v14.25A8.987 8.987 0 016 18c2.305 0 4.408.867 6 2.292m0-14.25a8.966 8.966 0 016-2.292c1.052 0 2.062.18 3 .512v14.25A8.987 8.987 0 0018 18a8.967 8.967 0 00-6 2.292m0-14.25v14.25" stroke="currentColor" fill="none" strokeWidth="1.5" />
+    </svg>
+  ),
+}
+
+function getIcon(title) {
+  let lower = title.toLowerCase()
+  for (let [key, icon] of Object.entries(sectionIcons)) {
+    if (lower.includes(key)) return icon
+  }
+  return sectionIcons.reference
+}
+
+export function SectionCards() {
+  return (
+    <div className="not-prose my-8 grid grid-cols-1 gap-4 sm:grid-cols-2">
+      {navigation.map((section) => (
+        <Link
+          key={section.title}
+          href={section.links[0]?.href || '/docs'}
+          className="group relative block rounded-xl border border-slate-200 p-5 transition-all hover:border-transparent dark:border-slate-800 dark:hover:border-transparent"
+        >
+          <div className="absolute -inset-px rounded-xl border-2 border-transparent opacity-0 transition-opacity [background:linear-gradient(var(--quick-links-hover-bg,theme(colors.sky.50)),var(--quick-links-hover-bg,theme(colors.sky.50)))_padding-box,linear-gradient(to_top,theme(colors.indigo.400),theme(colors.cyan.400),theme(colors.sky.500))_border-box] group-hover:opacity-100 dark:[--quick-links-hover-bg:theme(colors.slate.800)]" />
+          <div className="relative">
+            <div className="flex items-center gap-3">
+              {getIcon(section.title)}
+              <h3 className="font-display text-base font-medium text-slate-900 dark:text-white">
+                {section.title}
+              </h3>
+              <span className="ml-auto rounded-full bg-slate-100 px-2 py-0.5 text-xs font-medium text-slate-600 dark:bg-slate-800 dark:text-slate-400">
+                {section.links.length} guides
+              </span>
+            </div>
+            {section.desc && (
+              <p className="mt-2 text-sm text-slate-600 line-clamp-2 dark:text-slate-400">
+                {section.desc}
+              </p>
+            )}
+            <span className="mt-3 flex items-center gap-1 text-sm font-medium text-sky-500 group-hover:text-sky-600 dark:group-hover:text-sky-400">
+              Explore
+              <svg className="h-3.5 w-3.5 transition-transform group-hover:translate-x-0.5" viewBox="0 0 16 16" fill="currentColor">
+                <path fillRule="evenodd" d="M2 8a.75.75 0 01.75-.75h8.69L8.22 4.03a.75.75 0 011.06-1.06l4.5 4.5a.75.75 0 010 1.06l-4.5 4.5a.75.75 0 01-1.06-1.06l3.22-3.22H2.75A.75.75 0 012 8z" clipRule="evenodd" />
+              </svg>
+            </span>
+          </div>
+        </Link>
+      ))}
+    </div>
+  )
+}
diff --git a/src/components/StaggerChildren.jsx b/src/components/StaggerChildren.jsx
new file mode 100644
index 0000000..aea5916
--- /dev/null
+++ b/src/components/StaggerChildren.jsx
@@ -0,0 +1,58 @@
+'use client'
+
+import { Children, cloneElement, isValidElement, useEffect, useRef, useState } from 'react'
+import clsx from 'clsx'
+
+// Container that fades each direct child in sequence (left→right or
+// top→bottom by source order) once 15% of the container scrolls into
+// view. Each child gets a `transition-delay: i * stepMs` via inline
+// style; no per-child observer overhead.
+//
+// Children must accept className/style passthrough (most JSX elements
+// do; cards in this project all do). For arbitrary children, the
+// component still works — they just don't get the fade.
+//
+// Honors `prefers-reduced-motion` (renders fully visible, no anim).
+export function StaggerChildren({ children, className, stepMs = 90 }) {
+  const ref = useRef(null)
+  const [shown, setShown] = useState(true)
+
+  useEffect(() => {
+    if (typeof window === 'undefined') return
+    const reduce = window.matchMedia?.('(prefers-reduced-motion: reduce)').matches
+    if (reduce) return // already shown
+    const node = ref.current
+    if (!node) return
+    setShown(false)
+    const obs = new IntersectionObserver(
+      ([entry]) => {
+        if (entry.isIntersecting) {
+          setShown(true)
+          obs.unobserve(node)
+        }
+      },
+      { threshold: 0.15 },
+    )
+    obs.observe(node)
+    return () => obs.disconnect()
+  }, [])
+
+  return (
+    <div ref={ref} className={className}>
+      {Children.map(children, (child, i) => {
+        if (!isValidElement(child)) return child
+        const delay = `${i * stepMs}ms`
+        const existingClass = child.props.className || ''
+        const existingStyle = child.props.style || {}
+        return cloneElement(child, {
+          className: clsx(
+            existingClass,
+            'transition-all duration-700 ease-out',
+            shown ? 'translate-y-0 opacity-100' : 'translate-y-4 opacity-0',
+          ),
+          style: { ...existingStyle, transitionDelay: delay },
+        })
+      })}
+    </div>
+  )
+}
diff --git a/src/components/Tabs.jsx b/src/components/Tabs.jsx
new file mode 100644
index 0000000..7f5f16e
--- /dev/null
+++ b/src/components/Tabs.jsx
@@ -0,0 +1,47 @@
+'use client'
+
+import { useState, Children, isValidElement } from 'react'
+import clsx from 'clsx'
+
+export function Tabs({ children, labels = [] }) {
+  const tabs = []
+  Children.forEach(children, (child) => {
+    if (isValidElement(child)) {
+      tabs.push(child)
+    }
+  })
+
+  const tabLabels = labels.length > 0
+    ? labels
+    : tabs.map((tab, i) => tab.props?.label || `Tab ${i + 1}`)
+
+  const [activeIndex, setActiveIndex] = useState(0)
+
+  return (
+    <div className="my-6 overflow-hidden rounded-2xl border border-slate-200 dark:border-slate-700">
+      <div className="flex border-b border-slate-200 bg-slate-50 dark:border-slate-700 dark:bg-slate-800/50">
+        {tabLabels.map((label, i) => (
+          <button
+            key={i}
+            onClick={() => setActiveIndex(i)}
+            className={clsx(
+              'px-4 py-2.5 text-sm font-medium transition-colors',
+              i === activeIndex
+                ? 'border-b-2 border-sky-500 text-sky-600 dark:text-sky-400'
+                : 'text-slate-500 hover:text-slate-700 dark:text-slate-400 dark:hover:text-slate-300',
+            )}
+          >
+            {label}
+          </button>
+        ))}
+      </div>
+      <div className="p-4">
+        {tabs[activeIndex]}
+      </div>
+    </div>
+  )
+}
+
+export function Tab({ children }) {
+  return <div>{children}</div>
+}
diff --git a/src/components/VerticalTimeline.jsx b/src/components/VerticalTimeline.jsx
index 7a90429..d4203d9 100644
--- a/src/components/VerticalTimeline.jsx
+++ b/src/components/VerticalTimeline.jsx
@@ -55,14 +55,19 @@ const VerticalTimeline = ({ events }) => {
                 )}
             />
 
+            {/* `unoptimized` is required: this site builds with */}
+            {/* output: 'export', which disables /_next/image. Without */}
+            {/* unoptimized, Next emits a /_next/image?url=... src that */}
+            {/* 404s in production and renders as a broken-image icon. */}
             <Image
-                className="fixed bottom-full right-full top-5 -mb-56 -mr-72 opacity-50"
+                aria-hidden="true"
+                className="fixed bottom-full right-full top-5 -mb-56 -mr-72 opacity-50 pointer-events-none select-none hidden sm:block"
                 src={blurCyanImage}
                 alt=""
                 width={530}
                 height={530}
+                loading="lazy"
                 unoptimized
-                priority
             />
 
             <div className="relative z-10">
@@ -80,13 +85,14 @@ const VerticalTimeline = ({ events }) => {
             </div>
 
             <Image
-                className="fixed right-0 bottom-0 -mb-56 -mr-72 opacity-50"
+                aria-hidden="true"
+                className="fixed right-0 bottom-0 -mb-56 -mr-72 opacity-50 pointer-events-none select-none hidden sm:block"
                 src={blurCyanImage}
                 alt=""
                 width={530}
                 height={530}
+                loading="lazy"
                 unoptimized
-                priority
             />
         </div>
     );
diff --git a/src/components/goforgofr/GFGTracks.jsx b/src/components/goforgofr/GFGTracks.jsx
index fde3544..a0a4bbc 100644
--- a/src/components/goforgofr/GFGTracks.jsx
+++ b/src/components/goforgofr/GFGTracks.jsx
@@ -52,7 +52,7 @@ const GfgTracks = () => {
               height={40}
               className={`w-[20px]`}
             />
-            ZopSmart , Bengaluru
+            Bengaluru
           </span>
           <Link
             href={`https://maps.app.goo.gl/N8GdxnioYtzBqVkc7`}
diff --git a/src/data/doc-mtimes.json b/src/data/doc-mtimes.json
new file mode 100644
index 0000000..36859b8
--- /dev/null
+++ b/src/data/doc-mtimes.json
@@ -0,0 +1,58 @@
+{
+  "/docs/advanced-guide/authentication": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/building-cli-applications": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/circuit-breaker": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/custom-spans-in-tracing": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/dealing-with-sql": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/debugging": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/gofr-errors": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/graphql": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/grpc": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/grpc-streaming": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/handling-data-migrations": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/handling-file": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/http-communication": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/injecting-databases-drivers": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/key-value-store": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/middlewares": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/monitoring-service-health": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/overriding-default": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/publishing-custom-metrics": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/rbac": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/remote-log-level-change": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/serving-static-files": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/setting-custom-response-headers": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/startup-hooks": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/swagger-documentation": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/using-cron": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/using-publisher-subscriber": "2026-05-01T14:13:13+05:30",
+  "/docs/advanced-guide/websocket": "2026-05-01T14:13:13+05:30",
+  "/docs/datasources/arangodb": "2026-05-01T14:13:13+05:30",
+  "/docs/datasources/cassandra": "2026-05-01T14:13:13+05:30",
+  "/docs/datasources/clickhouse": "2026-05-01T14:13:13+05:30",
+  "/docs/datasources/cockroachdb": "2026-05-01T14:13:13+05:30",
+  "/docs/datasources/couchbase": "2026-05-01T14:13:13+05:30",
+  "/docs/datasources/dgraph": "2026-05-01T14:13:13+05:30",
+  "/docs/datasources/elasticsearch": "2026-05-01T14:13:13+05:30",
+  "/docs/datasources/getting-started": "2026-05-01T14:13:13+05:30",
+  "/docs/datasources/influxdb": "2026-05-01T14:13:13+05:30",
+  "/docs/datasources/migrations/elasticsearch": "2026-05-01T14:13:13+05:30",
+  "/docs/datasources/mongodb": "2026-05-01T14:13:13+05:30",
+  "/docs/datasources/opentsdb": "2026-05-01T14:13:13+05:30",
+  "/docs/datasources/oracle": "2026-05-01T14:13:13+05:30",
+  "/docs/datasources/scylladb": "2026-05-01T14:13:13+05:30",
+  "/docs/datasources/solr": "2026-05-01T14:13:13+05:30",
+  "/docs/datasources/surrealdb": "2026-05-01T14:13:13+05:30",
+  "/docs": "2026-05-01T14:13:13+05:30",
+  "/docs/quick-start/add-rest-handlers": "2026-05-01T14:13:13+05:30",
+  "/docs/quick-start/cli": "2026-05-01T14:13:13+05:30",
+  "/docs/quick-start/configuration": "2026-05-01T14:13:13+05:30",
+  "/docs/quick-start/connecting-mysql": "2026-05-01T14:13:13+05:30",
+  "/docs/quick-start/connecting-redis": "2026-05-01T14:13:13+05:30",
+  "/docs/quick-start/introduction": "2026-05-01T14:13:13+05:30",
+  "/docs/quick-start/observability": "2026-05-01T14:13:13+05:30",
+  "/docs/references/configs": "2026-05-01T14:13:13+05:30",
+  "/docs/references/context": "2026-05-01T14:13:13+05:30",
+  "/docs/references/gofrcli": "2026-05-01T14:13:13+05:30",
+  "/docs/references/testing": "2026-05-01T14:13:13+05:30"
+}
diff --git a/src/data/github-stars.json b/src/data/github-stars.json
new file mode 100644
index 0000000..673dfa2
--- /dev/null
+++ b/src/data/github-stars.json
@@ -0,0 +1,5 @@
+{
+  "stars": 21557,
+  "fetchedAt": "2026-05-02T21:27:58.368Z",
+  "source": "github-api"
+}
diff --git a/src/data/roadmap.json b/src/data/roadmap.json
new file mode 100644
index 0000000..becf6c5
--- /dev/null
+++ b/src/data/roadmap.json
@@ -0,0 +1,384 @@
+{
+  "repo": "gofr-dev/gofr",
+  "fetchedAt": "2026-04-30T18:28:56.237Z",
+  "labels": [
+    "roadmap",
+    "enhancement"
+  ],
+  "milestones": [],
+  "items": [
+    {
+      "number": 459,
+      "title": "Support  to filter and mask PII data from logs at the framework level",
+      "url": "https://github.com/gofr-dev/gofr/issues/459",
+      "state": "open",
+      "labels": [
+        "enhancement",
+        "Observability"
+      ],
+      "milestone": null,
+      "created_at": "2024-04-13T15:46:09Z",
+      "updated_at": "2024-08-18T17:06:11Z",
+      "comments": 4
+    },
+    {
+      "number": 492,
+      "title": "Enhance terminal output for cli application",
+      "url": "https://github.com/gofr-dev/gofr/issues/492",
+      "state": "open",
+      "labels": [
+        "enhancement"
+      ],
+      "milestone": null,
+      "created_at": "2024-04-18T07:15:14Z",
+      "updated_at": "2025-05-25T17:01:55Z",
+      "comments": 3
+    },
+    {
+      "number": 863,
+      "title": "Support for write through cache.",
+      "url": "https://github.com/gofr-dev/gofr/issues/863",
+      "state": "open",
+      "labels": [
+        "enhancement"
+      ],
+      "milestone": null,
+      "created_at": "2024-07-22T08:29:16Z",
+      "updated_at": "2024-07-22T16:36:18Z",
+      "comments": 1
+    },
+    {
+      "number": 891,
+      "title": "Refactor and improve error struct",
+      "url": "https://github.com/gofr-dev/gofr/issues/891",
+      "state": "open",
+      "labels": [
+        "enhancement",
+        "Datasource"
+      ],
+      "milestone": null,
+      "created_at": "2024-08-05T08:24:35Z",
+      "updated_at": "2026-04-28T22:17:17Z",
+      "comments": 3
+    },
+    {
+      "number": 984,
+      "title": "Support MSSQL",
+      "url": "https://github.com/gofr-dev/gofr/issues/984",
+      "state": "open",
+      "labels": [
+        "enhancement",
+        "Datasource"
+      ],
+      "milestone": null,
+      "created_at": "2024-09-03T11:26:26Z",
+      "updated_at": "2024-12-12T09:28:02Z",
+      "comments": 1
+    },
+    {
+      "number": 1242,
+      "title": "Open AI Client wrapper for GoFr",
+      "url": "https://github.com/gofr-dev/gofr/issues/1242",
+      "state": "open",
+      "labels": [
+        "enhancement",
+        "Service"
+      ],
+      "milestone": null,
+      "created_at": "2024-11-26T11:58:36Z",
+      "updated_at": "2025-01-12T18:08:01Z",
+      "comments": 18
+    },
+    {
+      "number": 1249,
+      "title": "Support Chroma as datasource",
+      "url": "https://github.com/gofr-dev/gofr/issues/1249",
+      "state": "open",
+      "labels": [
+        "enhancement",
+        "Datasource"
+      ],
+      "milestone": null,
+      "created_at": "2024-11-27T12:15:46Z",
+      "updated_at": "2025-12-04T17:30:01Z",
+      "comments": 2
+    },
+    {
+      "number": 1330,
+      "title": "Soft delete",
+      "url": "https://github.com/gofr-dev/gofr/issues/1330",
+      "state": "open",
+      "labels": [
+        "enhancement",
+        "Datasource"
+      ],
+      "milestone": null,
+      "created_at": "2024-12-23T03:21:38Z",
+      "updated_at": "2025-08-05T06:34:37Z",
+      "comments": 1
+    },
+    {
+      "number": 1456,
+      "title": "Request validation support",
+      "url": "https://github.com/gofr-dev/gofr/issues/1456",
+      "state": "open",
+      "labels": [
+        "enhancement"
+      ],
+      "milestone": null,
+      "created_at": "2025-01-29T08:18:42Z",
+      "updated_at": "2025-07-16T12:27:40Z",
+      "comments": 2
+    },
+    {
+      "number": 1484,
+      "title": "Add WebRTC Support",
+      "url": "https://github.com/gofr-dev/gofr/issues/1484",
+      "state": "open",
+      "labels": [
+        "enhancement",
+        "Service"
+      ],
+      "milestone": null,
+      "created_at": "2025-02-13T09:56:30Z",
+      "updated_at": "2025-02-17T07:33:02Z",
+      "comments": 0
+    },
+    {
+      "number": 1495,
+      "title": "Support Pinecone as a Datasource",
+      "url": "https://github.com/gofr-dev/gofr/issues/1495",
+      "state": "open",
+      "labels": [
+        "enhancement",
+        "Datasource"
+      ],
+      "milestone": null,
+      "created_at": "2025-02-13T10:25:25Z",
+      "updated_at": "2025-02-27T18:25:47Z",
+      "comments": 1
+    },
+    {
+      "number": 1497,
+      "title": "Support Faiss as a datasource",
+      "url": "https://github.com/gofr-dev/gofr/issues/1497",
+      "state": "open",
+      "labels": [
+        "enhancement",
+        "Datasource"
+      ],
+      "milestone": null,
+      "created_at": "2025-02-13T10:27:40Z",
+      "updated_at": "2025-02-17T07:30:06Z",
+      "comments": 0
+    },
+    {
+      "number": 1716,
+      "title": "CI: enable disabled linters and remove exclusions from .golangci.yml",
+      "url": "https://github.com/gofr-dev/gofr/issues/1716",
+      "state": "open",
+      "labels": [
+        "enhancement"
+      ],
+      "milestone": null,
+      "created_at": "2025-05-16T18:45:57Z",
+      "updated_at": "2025-07-23T11:17:21Z",
+      "comments": 3
+    },
+    {
+      "number": 1988,
+      "title": "Okta Identity Provider",
+      "url": "https://github.com/gofr-dev/gofr/issues/1988",
+      "state": "open",
+      "labels": [
+        "enhancement",
+        "gofr-soc"
+      ],
+      "milestone": null,
+      "created_at": "2025-07-03T07:16:42Z",
+      "updated_at": "2025-07-21T05:02:56Z",
+      "comments": 4
+    },
+    {
+      "number": 1992,
+      "title": "Implement Unified Cache Layer",
+      "url": "https://github.com/gofr-dev/gofr/issues/1992",
+      "state": "open",
+      "labels": [
+        "enhancement",
+        "gofr-soc"
+      ],
+      "milestone": null,
+      "created_at": "2025-07-03T08:27:18Z",
+      "updated_at": "2026-03-02T06:41:42Z",
+      "comments": 6
+    },
+    {
+      "number": 2007,
+      "title": "OpenID Connect Support",
+      "url": "https://github.com/gofr-dev/gofr/issues/2007",
+      "state": "open",
+      "labels": [
+        "enhancement",
+        "gofr-soc"
+      ],
+      "milestone": null,
+      "created_at": "2025-07-04T02:56:40Z",
+      "updated_at": "2025-07-23T08:08:43Z",
+      "comments": 1
+    },
+    {
+      "number": 2014,
+      "title": "LDAP Integration Helper Module",
+      "url": "https://github.com/gofr-dev/gofr/issues/2014",
+      "state": "open",
+      "labels": [
+        "enhancement"
+      ],
+      "milestone": null,
+      "created_at": "2025-07-04T18:11:47Z",
+      "updated_at": "2026-04-29T09:59:18Z",
+      "comments": 3
+    },
+    {
+      "number": 2123,
+      "title": "Adding Job Queue & Worker pool in Framework",
+      "url": "https://github.com/gofr-dev/gofr/issues/2123",
+      "state": "open",
+      "labels": [
+        "enhancement",
+        "go",
+        "triage"
+      ],
+      "milestone": null,
+      "created_at": "2025-08-04T11:45:29Z",
+      "updated_at": "2026-03-21T06:57:26Z",
+      "comments": 4
+    },
+    {
+      "number": 2232,
+      "title": "Support emitting metrics from CLI applications",
+      "url": "https://github.com/gofr-dev/gofr/issues/2232",
+      "state": "open",
+      "labels": [
+        "enhancement"
+      ],
+      "milestone": null,
+      "created_at": "2025-09-03T03:40:17Z",
+      "updated_at": "2026-03-18T05:53:04Z",
+      "comments": 7
+    },
+    {
+      "number": 2237,
+      "title": "Use YAML files to configure AddRestHandlers feature",
+      "url": "https://github.com/gofr-dev/gofr/issues/2237",
+      "state": "open",
+      "labels": [
+        "enhancement"
+      ],
+      "milestone": null,
+      "created_at": "2025-09-05T10:20:36Z",
+      "updated_at": "2026-03-04T16:09:16Z",
+      "comments": 10
+    },
+    {
+      "number": 2238,
+      "title": "Refactor WebSocket",
+      "url": "https://github.com/gofr-dev/gofr/issues/2238",
+      "state": "open",
+      "labels": [
+        "enhancement"
+      ],
+      "milestone": null,
+      "created_at": "2025-09-05T10:21:07Z",
+      "updated_at": "2026-03-10T16:00:01Z",
+      "comments": 3
+    },
+    {
+      "number": 2500,
+      "title": "Panic Recovery Across GoFr Features",
+      "url": "https://github.com/gofr-dev/gofr/issues/2500",
+      "state": "open",
+      "labels": [
+        "enhancement",
+        "triage"
+      ],
+      "milestone": null,
+      "created_at": "2025-11-07T08:16:12Z",
+      "updated_at": "2026-03-17T09:45:54Z",
+      "comments": 4
+    },
+    {
+      "number": 2528,
+      "title": "Add a workflow to automatically release submodules new releases on GoFr's release",
+      "url": "https://github.com/gofr-dev/gofr/issues/2528",
+      "state": "open",
+      "labels": [
+        "enhancement",
+        "github_actions",
+        "devops"
+      ],
+      "milestone": null,
+      "created_at": "2025-11-17T05:37:29Z",
+      "updated_at": "2025-12-03T07:53:30Z",
+      "comments": 8
+    },
+    {
+      "number": 2650,
+      "title": "Support Span links for PubSub Tracing",
+      "url": "https://github.com/gofr-dev/gofr/issues/2650",
+      "state": "open",
+      "labels": [
+        "enhancement",
+        "go"
+      ],
+      "milestone": null,
+      "created_at": "2025-12-08T10:11:21Z",
+      "updated_at": "2026-02-24T11:08:01Z",
+      "comments": 10
+    },
+    {
+      "number": 2892,
+      "title": "Transaction in dGraph Migration",
+      "url": "https://github.com/gofr-dev/gofr/issues/2892",
+      "state": "open",
+      "labels": [
+        "enhancement",
+        "good first issue",
+        "Datasource"
+      ],
+      "milestone": null,
+      "created_at": "2026-01-29T10:50:22Z",
+      "updated_at": "2026-03-02T05:08:03Z",
+      "comments": 9
+    },
+    {
+      "number": 2896,
+      "title": "Allow Configurable Rate-Limit Key Derivation in RateLimiter Middleware",
+      "url": "https://github.com/gofr-dev/gofr/issues/2896",
+      "state": "open",
+      "labels": [
+        "enhancement",
+        "Service"
+      ],
+      "milestone": null,
+      "created_at": "2026-01-30T12:15:30Z",
+      "updated_at": "2026-02-26T05:35:58Z",
+      "comments": 5
+    },
+    {
+      "number": 2955,
+      "title": "Missing OpenTelemetry Span Initialization in CLI SubCommands",
+      "url": "https://github.com/gofr-dev/gofr/issues/2955",
+      "state": "open",
+      "labels": [
+        "enhancement",
+        "Observability"
+      ],
+      "milestone": null,
+      "created_at": "2026-02-04T13:06:58Z",
+      "updated_at": "2026-02-06T07:05:17Z",
+      "comments": 1
+    }
+  ]
+}
diff --git a/src/data/team-enriched.json b/src/data/team-enriched.json
new file mode 100644
index 0000000..9595672
--- /dev/null
+++ b/src/data/team-enriched.json
@@ -0,0 +1,1052 @@
+{
+  "repo": "gofr-dev/gofr",
+  "fetchedAt": "2026-05-01T15:29:24.306Z",
+  "team": [
+    {
+      "github": "aryanmehrotra",
+      "linkedin": "https://www.linkedin.com/in/aryanmehrotra/",
+      "role": "Maintainer",
+      "name": "Aryan Mehrotra",
+      "github_data": {
+        "login": "aryanmehrotra",
+        "avatar_url": "https://avatars.githubusercontent.com/u/44036979?v=4",
+        "profile_url": "https://github.com/aryanmehrotra",
+        "profile_name": "Aryan Mehrotra",
+        "bio": null,
+        "blog": null,
+        "company": "@gofr-dev @zopdev",
+        "location": "Bengaluru",
+        "followers": 44,
+        "public_repos": 55,
+        "gofr_contributions": 372
+      }
+    },
+    {
+      "github": "vikash",
+      "linkedin": "https://www.linkedin.com/in/v4vikash/",
+      "role": "Creator",
+      "name": "Vikash",
+      "github_data": {
+        "login": "vikash",
+        "avatar_url": "https://avatars.githubusercontent.com/u/324203?v=4",
+        "profile_url": "https://github.com/vikash",
+        "profile_name": "Vikash Kumar",
+        "bio": null,
+        "blog": null,
+        "company": "@gofr-dev @zopdev @zopsmart",
+        "location": "Bangalore, India",
+        "followers": 43,
+        "public_repos": 28,
+        "gofr_contributions": 186
+      }
+    },
+    {
+      "github": "Umang01-hash",
+      "linkedin": "https://www.linkedin.com/in/umang01-hash/",
+      "role": "Maintainer",
+      "name": "Umang",
+      "github_data": {
+        "login": "Umang01-hash",
+        "avatar_url": "https://avatars.githubusercontent.com/u/55635734?v=4",
+        "profile_url": "https://github.com/Umang01-hash",
+        "profile_name": "Umang Mundhra",
+        "bio": "Golang Developer and Maintainer @gofr.dev",
+        "blog": null,
+        "company": "gofr.dev",
+        "location": "Bengaluru",
+        "followers": 61,
+        "public_repos": 31,
+        "gofr_contributions": 1829
+      }
+    },
+    {
+      "github": "coolwednesday",
+      "linkedin": "https://www.linkedin.com/in/divya-darshana/",
+      "role": "Maintainer",
+      "name": "Divya Darshana",
+      "github_data": {
+        "login": "coolwednesday",
+        "avatar_url": "https://avatars.githubusercontent.com/u/98943137?v=4",
+        "profile_url": "https://github.com/coolwednesday",
+        "profile_name": "Divya Darshana",
+        "bio": null,
+        "blog": null,
+        "company": "Software Engineer @zopdev, Maintainer @gofr-dev",
+        "location": "Bangalore, India",
+        "followers": 30,
+        "public_repos": 30,
+        "gofr_contributions": 412
+      }
+    },
+    {
+      "github": "vipul-rawat",
+      "linkedin": "https://www.linkedin.com/in/vipul-rawat-b724b217a/",
+      "role": "Maintainer",
+      "name": "Vipul Rawat",
+      "github_data": {
+        "login": "vipul-rawat",
+        "avatar_url": "https://avatars.githubusercontent.com/u/44166352?v=4",
+        "profile_url": "https://github.com/vipul-rawat",
+        "profile_name": "Vipul Rawat",
+        "bio": null,
+        "blog": null,
+        "company": "suki.ai",
+        "location": null,
+        "followers": 11,
+        "public_repos": 23,
+        "gofr_contributions": 165
+      }
+    }
+  ],
+  "contributors": [
+    {
+      "login": "srijan-27",
+      "avatar_url": "https://avatars.githubusercontent.com/u/44723623?v=4",
+      "profile_url": "https://github.com/srijan-27",
+      "contributions": 160,
+      "prs_merged": 89,
+      "reviews_authored": 210,
+      "comments_authored": 269,
+      "score": 1159.5
+    },
+    {
+      "login": "ccoVeille",
+      "avatar_url": "https://avatars.githubusercontent.com/u/3875889?v=4",
+      "profile_url": "https://github.com/ccoVeille",
+      "contributions": 48,
+      "prs_merged": 27,
+      "reviews_authored": 155,
+      "comments_authored": 208,
+      "score": 597
+    },
+    {
+      "login": "akshat-kumar-singhal",
+      "avatar_url": "https://avatars.githubusercontent.com/u/65562230?v=4",
+      "profile_url": "https://github.com/akshat-kumar-singhal",
+      "contributions": 44,
+      "prs_merged": 10,
+      "reviews_authored": 14,
+      "comments_authored": 28,
+      "score": 136
+    },
+    {
+      "login": "mfreeman451",
+      "avatar_url": "https://avatars.githubusercontent.com/u/1821930?v=4",
+      "profile_url": "https://github.com/mfreeman451",
+      "contributions": 124,
+      "prs_merged": 0,
+      "reviews_authored": 3,
+      "comments_authored": 8,
+      "score": 134
+    },
+    {
+      "login": "gizmo-rt",
+      "avatar_url": "https://avatars.githubusercontent.com/u/16516834?v=4",
+      "profile_url": "https://github.com/gizmo-rt",
+      "contributions": 58,
+      "prs_merged": 6,
+      "reviews_authored": 8,
+      "comments_authored": 23,
+      "score": 115.5
+    },
+    {
+      "login": "illenko",
+      "avatar_url": "https://avatars.githubusercontent.com/u/16544476?v=4",
+      "profile_url": "https://github.com/illenko",
+      "contributions": 31,
+      "prs_merged": 6,
+      "reviews_authored": 8,
+      "comments_authored": 19,
+      "score": 86.5
+    },
+    {
+      "login": "akhilsharmaa",
+      "avatar_url": "https://avatars.githubusercontent.com/u/74103314?v=4",
+      "profile_url": "https://github.com/akhilsharmaa",
+      "contributions": 50,
+      "prs_merged": 1,
+      "reviews_authored": 1,
+      "comments_authored": 1,
+      "score": 57.5
+    },
+    {
+      "login": "Sharath-a26",
+      "avatar_url": "https://avatars.githubusercontent.com/u/76243046?v=4",
+      "profile_url": "https://github.com/Sharath-a26",
+      "contributions": 46,
+      "prs_merged": 1,
+      "reviews_authored": 1,
+      "comments_authored": 2,
+      "score": 54
+    },
+    {
+      "login": "olxandr",
+      "avatar_url": "https://avatars.githubusercontent.com/u/31043927?v=4",
+      "profile_url": "https://github.com/olxandr",
+      "contributions": 26,
+      "prs_merged": 4,
+      "reviews_authored": 1,
+      "comments_authored": 10,
+      "score": 53
+    },
+    {
+      "login": "vaidehiadhi",
+      "avatar_url": "https://avatars.githubusercontent.com/u/96489345?v=4",
+      "profile_url": "https://github.com/vaidehiadhi",
+      "contributions": 14,
+      "prs_merged": 4,
+      "reviews_authored": 4,
+      "comments_authored": 7,
+      "score": 45.5
+    },
+    {
+      "login": "FilledEther20",
+      "avatar_url": "https://avatars.githubusercontent.com/u/143730803?v=4",
+      "profile_url": "https://github.com/FilledEther20",
+      "contributions": 14,
+      "prs_merged": 4,
+      "reviews_authored": 3,
+      "comments_authored": 7,
+      "score": 43.5
+    },
+    {
+      "login": "gitcrusher",
+      "avatar_url": "https://avatars.githubusercontent.com/u/137198498?v=4",
+      "profile_url": "https://github.com/gitcrusher",
+      "contributions": 28,
+      "prs_merged": 1,
+      "reviews_authored": 1,
+      "comments_authored": 2,
+      "score": 36
+    },
+    {
+      "login": "Samar1110",
+      "avatar_url": "https://avatars.githubusercontent.com/u/98534735?v=4",
+      "profile_url": "https://github.com/Samar1110",
+      "contributions": 16,
+      "prs_merged": 2,
+      "reviews_authored": 2,
+      "comments_authored": 3,
+      "score": 31.5
+    },
+    {
+      "login": "RahulMohanK",
+      "avatar_url": "https://avatars.githubusercontent.com/u/25799011?v=4",
+      "profile_url": "https://github.com/RahulMohanK",
+      "contributions": 25,
+      "prs_merged": 0,
+      "reviews_authored": 0,
+      "comments_authored": 4,
+      "score": 27
+    },
+    {
+      "login": "AchimGrolimund",
+      "avatar_url": "https://avatars.githubusercontent.com/u/22026079?v=4",
+      "profile_url": "https://github.com/AchimGrolimund",
+      "contributions": 14,
+      "prs_merged": 1,
+      "reviews_authored": 1,
+      "comments_authored": 3,
+      "score": 22.5
+    },
+    {
+      "login": "Sumit-Kumar1",
+      "avatar_url": "https://avatars.githubusercontent.com/u/56474834?v=4",
+      "profile_url": "https://github.com/Sumit-Kumar1",
+      "contributions": 13,
+      "score": 13
+    },
+    {
+      "login": "nitin-999-code",
+      "avatar_url": "https://avatars.githubusercontent.com/u/184984557?v=4",
+      "profile_url": "https://github.com/nitin-999-code",
+      "contributions": 11,
+      "score": 11
+    },
+    {
+      "login": "surajitpore0",
+      "avatar_url": "https://avatars.githubusercontent.com/u/47813748?v=4",
+      "profile_url": "https://github.com/surajitpore0",
+      "contributions": 11,
+      "score": 11
+    },
+    {
+      "login": "aziz-shoko",
+      "avatar_url": "https://avatars.githubusercontent.com/u/65618670?v=4",
+      "profile_url": "https://github.com/aziz-shoko",
+      "contributions": 9,
+      "score": 9
+    },
+    {
+      "login": "goginenibhavani2000",
+      "avatar_url": "https://avatars.githubusercontent.com/u/191303789?v=4",
+      "profile_url": "https://github.com/goginenibhavani2000",
+      "contributions": 8,
+      "score": 8
+    },
+    {
+      "login": "shifluxxc",
+      "avatar_url": "https://avatars.githubusercontent.com/u/141365074?v=4",
+      "profile_url": "https://github.com/shifluxxc",
+      "contributions": 8,
+      "score": 8
+    },
+    {
+      "login": "gourish25",
+      "avatar_url": "https://avatars.githubusercontent.com/u/220681217?v=4",
+      "profile_url": "https://github.com/gourish25",
+      "contributions": 8,
+      "score": 8
+    },
+    {
+      "login": "GuyKh",
+      "avatar_url": "https://avatars.githubusercontent.com/u/3136012?v=4",
+      "profile_url": "https://github.com/GuyKh",
+      "contributions": 7,
+      "score": 7
+    },
+    {
+      "login": "ARYPROGRAMMER",
+      "avatar_url": "https://avatars.githubusercontent.com/u/75311742?v=4",
+      "profile_url": "https://github.com/ARYPROGRAMMER",
+      "contributions": 7,
+      "score": 7
+    },
+    {
+      "login": "aryaman-vohra",
+      "avatar_url": "https://avatars.githubusercontent.com/u/206655502?v=4",
+      "profile_url": "https://github.com/aryaman-vohra",
+      "contributions": 7,
+      "score": 7
+    },
+    {
+      "login": "QUBITABHAY",
+      "avatar_url": "https://avatars.githubusercontent.com/u/183405787?v=4",
+      "profile_url": "https://github.com/QUBITABHAY",
+      "contributions": 7,
+      "score": 7
+    },
+    {
+      "login": "NitinKumar004",
+      "avatar_url": "https://avatars.githubusercontent.com/u/215663108?v=4",
+      "profile_url": "https://github.com/NitinKumar004",
+      "contributions": 7,
+      "score": 7
+    },
+    {
+      "login": "achaljhawar",
+      "avatar_url": "https://avatars.githubusercontent.com/u/35405812?v=4",
+      "profile_url": "https://github.com/achaljhawar",
+      "contributions": 6,
+      "score": 6
+    },
+    {
+      "login": "Ayushcode10",
+      "avatar_url": "https://avatars.githubusercontent.com/u/165639173?v=4",
+      "profile_url": "https://github.com/Ayushcode10",
+      "contributions": 5,
+      "score": 5
+    },
+    {
+      "login": "nihalchollampat",
+      "avatar_url": "https://avatars.githubusercontent.com/u/61104567?v=4",
+      "profile_url": "https://github.com/nihalchollampat",
+      "contributions": 5,
+      "score": 5
+    },
+    {
+      "login": "PradSharma554",
+      "avatar_url": "https://avatars.githubusercontent.com/u/215660161?v=4",
+      "profile_url": "https://github.com/PradSharma554",
+      "contributions": 5,
+      "score": 5
+    },
+    {
+      "login": "ssshekhu53",
+      "avatar_url": "https://avatars.githubusercontent.com/u/22931609?v=4",
+      "profile_url": "https://github.com/ssshekhu53",
+      "contributions": 5,
+      "score": 5
+    },
+    {
+      "login": "abrarr21",
+      "avatar_url": "https://avatars.githubusercontent.com/u/147129985?v=4",
+      "profile_url": "https://github.com/abrarr21",
+      "contributions": 5,
+      "score": 5
+    },
+    {
+      "login": "iNotSoCrisp",
+      "avatar_url": "https://avatars.githubusercontent.com/u/184905288?v=4",
+      "profile_url": "https://github.com/iNotSoCrisp",
+      "contributions": 4,
+      "score": 4
+    },
+    {
+      "login": "Sayanta66",
+      "avatar_url": "https://avatars.githubusercontent.com/u/53281158?v=4",
+      "profile_url": "https://github.com/Sayanta66",
+      "contributions": 4,
+      "score": 4
+    },
+    {
+      "login": "MOHITKOURAV01",
+      "avatar_url": "https://avatars.githubusercontent.com/u/190134633?v=4",
+      "profile_url": "https://github.com/MOHITKOURAV01",
+      "contributions": 4,
+      "score": 4
+    },
+    {
+      "login": "Mittalkabir",
+      "avatar_url": "https://avatars.githubusercontent.com/u/72194186?v=4",
+      "profile_url": "https://github.com/Mittalkabir",
+      "contributions": 4,
+      "score": 4
+    },
+    {
+      "login": "HugoW5",
+      "avatar_url": "https://avatars.githubusercontent.com/u/32434494?v=4",
+      "profile_url": "https://github.com/HugoW5",
+      "contributions": 4,
+      "score": 4
+    },
+    {
+      "login": "ashwingopalsamy",
+      "avatar_url": "https://avatars.githubusercontent.com/u/47941624?v=4",
+      "profile_url": "https://github.com/ashwingopalsamy",
+      "contributions": 4,
+      "score": 4
+    },
+    {
+      "login": "NishantRajZop",
+      "avatar_url": "https://avatars.githubusercontent.com/u/215662906?v=4",
+      "profile_url": "https://github.com/NishantRajZop",
+      "contributions": 3,
+      "score": 3
+    },
+    {
+      "login": "lazarofl",
+      "avatar_url": "https://avatars.githubusercontent.com/u/913314?v=4",
+      "profile_url": "https://github.com/lazarofl",
+      "contributions": 3,
+      "score": 3
+    },
+    {
+      "login": "IronwallxR5",
+      "avatar_url": "https://avatars.githubusercontent.com/u/189894380?v=4",
+      "profile_url": "https://github.com/IronwallxR5",
+      "contributions": 3,
+      "score": 3
+    },
+    {
+      "login": "SAMMILLERR",
+      "avatar_url": "https://avatars.githubusercontent.com/u/170887172?v=4",
+      "profile_url": "https://github.com/SAMMILLERR",
+      "contributions": 3,
+      "score": 3
+    },
+    {
+      "login": "rokerzfirst101",
+      "avatar_url": "https://avatars.githubusercontent.com/u/33196098?v=4",
+      "profile_url": "https://github.com/rokerzfirst101",
+      "contributions": 3,
+      "score": 3
+    },
+    {
+      "login": "aditya028",
+      "avatar_url": "https://avatars.githubusercontent.com/u/59480626?v=4",
+      "profile_url": "https://github.com/aditya028",
+      "contributions": 3,
+      "score": 3
+    },
+    {
+      "login": "amankp-zop",
+      "avatar_url": "https://avatars.githubusercontent.com/u/215659926?v=4",
+      "profile_url": "https://github.com/amankp-zop",
+      "contributions": 3,
+      "score": 3
+    },
+    {
+      "login": "surajit-zs",
+      "avatar_url": "https://avatars.githubusercontent.com/u/97510117?v=4",
+      "profile_url": "https://github.com/surajit-zs",
+      "contributions": 3,
+      "score": 3
+    },
+    {
+      "login": "dhruvjanakala",
+      "avatar_url": "https://avatars.githubusercontent.com/u/216533643?v=4",
+      "profile_url": "https://github.com/dhruvjanakala",
+      "contributions": 3,
+      "score": 3
+    },
+    {
+      "login": "00harald",
+      "avatar_url": "https://avatars.githubusercontent.com/u/126503791?v=4",
+      "profile_url": "https://github.com/00harald",
+      "contributions": 3,
+      "score": 3
+    },
+    {
+      "login": "nidhey27",
+      "avatar_url": "https://avatars.githubusercontent.com/u/46122307?v=4",
+      "profile_url": "https://github.com/nidhey27",
+      "contributions": 2,
+      "score": 2
+    },
+    {
+      "login": "jatintalgotra-zd",
+      "avatar_url": "https://avatars.githubusercontent.com/u/215661314?v=4",
+      "profile_url": "https://github.com/jatintalgotra-zd",
+      "contributions": 2,
+      "score": 2
+    },
+    {
+      "login": "Ale-Cas",
+      "avatar_url": "https://avatars.githubusercontent.com/u/64859146?v=4",
+      "profile_url": "https://github.com/Ale-Cas",
+      "contributions": 2,
+      "score": 2
+    },
+    {
+      "login": "Beeram12",
+      "avatar_url": "https://avatars.githubusercontent.com/u/116240849?v=4",
+      "profile_url": "https://github.com/Beeram12",
+      "contributions": 2,
+      "score": 2
+    },
+    {
+      "login": "bhavishyaone",
+      "avatar_url": "https://avatars.githubusercontent.com/u/181509924?v=4",
+      "profile_url": "https://github.com/bhavishyaone",
+      "contributions": 2,
+      "score": 2
+    },
+    {
+      "login": "Sianao",
+      "avatar_url": "https://avatars.githubusercontent.com/u/96694568?v=4",
+      "profile_url": "https://github.com/Sianao",
+      "contributions": 2,
+      "score": 2
+    },
+    {
+      "login": "0xEbrahim",
+      "avatar_url": "https://avatars.githubusercontent.com/u/107937836?v=4",
+      "profile_url": "https://github.com/0xEbrahim",
+      "contributions": 2,
+      "score": 2
+    },
+    {
+      "login": "robertsilen",
+      "avatar_url": "https://avatars.githubusercontent.com/u/6599142?v=4",
+      "profile_url": "https://github.com/robertsilen",
+      "contributions": 2,
+      "score": 2
+    },
+    {
+      "login": "krikera",
+      "avatar_url": "https://avatars.githubusercontent.com/u/84141602?v=4",
+      "profile_url": "https://github.com/krikera",
+      "contributions": 2,
+      "score": 2
+    },
+    {
+      "login": "Joystonm",
+      "avatar_url": "https://avatars.githubusercontent.com/u/116254639?v=4",
+      "profile_url": "https://github.com/Joystonm",
+      "contributions": 2,
+      "score": 2
+    },
+    {
+      "login": "ace3",
+      "avatar_url": "https://avatars.githubusercontent.com/u/12264813?v=4",
+      "profile_url": "https://github.com/ace3",
+      "contributions": 2,
+      "score": 2
+    },
+    {
+      "login": "KedarisettiSreeVamsi",
+      "avatar_url": "https://avatars.githubusercontent.com/u/34485436?v=4",
+      "profile_url": "https://github.com/KedarisettiSreeVamsi",
+      "contributions": 2,
+      "score": 2
+    },
+    {
+      "login": "kursataktas",
+      "avatar_url": "https://avatars.githubusercontent.com/u/17837825?v=4",
+      "profile_url": "https://github.com/kursataktas",
+      "contributions": 2,
+      "score": 2
+    },
+    {
+      "login": "Aggarwalmansi",
+      "avatar_url": "https://avatars.githubusercontent.com/u/189028773?v=4",
+      "profile_url": "https://github.com/Aggarwalmansi",
+      "contributions": 2,
+      "score": 2
+    },
+    {
+      "login": "7h3-3mp7y-m4n",
+      "avatar_url": "https://avatars.githubusercontent.com/u/115151332?v=4",
+      "profile_url": "https://github.com/7h3-3mp7y-m4n",
+      "contributions": 2,
+      "score": 2
+    },
+    {
+      "login": "goyaldivyanx",
+      "avatar_url": "https://avatars.githubusercontent.com/u/171136437?v=4",
+      "profile_url": "https://github.com/goyaldivyanx",
+      "contributions": 2,
+      "score": 2
+    },
+    {
+      "login": "rohansood10",
+      "avatar_url": "https://avatars.githubusercontent.com/u/56945243?v=4",
+      "profile_url": "https://github.com/rohansood10",
+      "contributions": 2,
+      "score": 2
+    },
+    {
+      "login": "tharunn0",
+      "avatar_url": "https://avatars.githubusercontent.com/u/184649791?v=4",
+      "profile_url": "https://github.com/tharunn0",
+      "contributions": 2,
+      "score": 2
+    },
+    {
+      "login": "SuyeshBadge",
+      "avatar_url": "https://avatars.githubusercontent.com/u/59205766?v=4",
+      "profile_url": "https://github.com/SuyeshBadge",
+      "contributions": 2,
+      "score": 2
+    },
+    {
+      "login": "iamshishirpandey",
+      "avatar_url": "https://avatars.githubusercontent.com/u/39762897?v=4",
+      "profile_url": "https://github.com/iamshishirpandey",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "SauravDharwadkar",
+      "avatar_url": "https://avatars.githubusercontent.com/u/45504629?v=4",
+      "profile_url": "https://github.com/SauravDharwadkar",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "sathwikshetty33",
+      "avatar_url": "https://avatars.githubusercontent.com/u/175965461?v=4",
+      "profile_url": "https://github.com/sathwikshetty33",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "abhirajadhikary06",
+      "avatar_url": "https://avatars.githubusercontent.com/u/171187625?v=4",
+      "profile_url": "https://github.com/abhirajadhikary06",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "Lexterl33t",
+      "avatar_url": "https://avatars.githubusercontent.com/u/44911576?v=4",
+      "profile_url": "https://github.com/Lexterl33t",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "rigved-telang",
+      "avatar_url": "https://avatars.githubusercontent.com/u/85876515?v=4",
+      "profile_url": "https://github.com/rigved-telang",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "reski-rukmantiyo",
+      "avatar_url": "https://avatars.githubusercontent.com/u/64754300?v=4",
+      "profile_url": "https://github.com/reski-rukmantiyo",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "Prakhar-Shankar",
+      "avatar_url": "https://avatars.githubusercontent.com/u/97254881?v=4",
+      "profile_url": "https://github.com/Prakhar-Shankar",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "PiyushSingh-ZS",
+      "avatar_url": "https://avatars.githubusercontent.com/u/125456748?v=4",
+      "profile_url": "https://github.com/PiyushSingh-ZS",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "Omar8345",
+      "avatar_url": "https://avatars.githubusercontent.com/u/68811721?v=4",
+      "profile_url": "https://github.com/Omar8345",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "om7057",
+      "avatar_url": "https://avatars.githubusercontent.com/u/127368012?v=4",
+      "profile_url": "https://github.com/om7057",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "chauhan17nitin",
+      "avatar_url": "https://avatars.githubusercontent.com/u/39927335?v=4",
+      "profile_url": "https://github.com/chauhan17nitin",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "naveen246",
+      "avatar_url": "https://avatars.githubusercontent.com/u/1230094?v=4",
+      "profile_url": "https://github.com/naveen246",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "sreenivasivbieb",
+      "avatar_url": "https://avatars.githubusercontent.com/u/203828853?v=4",
+      "profile_url": "https://github.com/sreenivasivbieb",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "sebdeveloper6952",
+      "avatar_url": "https://avatars.githubusercontent.com/u/18562903?v=4",
+      "profile_url": "https://github.com/sebdeveloper6952",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "prasadram",
+      "avatar_url": "https://avatars.githubusercontent.com/u/5496281?v=4",
+      "profile_url": "https://github.com/prasadram",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "naveen-bandela-au2",
+      "avatar_url": "https://avatars.githubusercontent.com/u/50129187?v=4",
+      "profile_url": "https://github.com/naveen-bandela-au2",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "faisalmorensya",
+      "avatar_url": "https://avatars.githubusercontent.com/u/4990180?v=4",
+      "profile_url": "https://github.com/faisalmorensya",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "maynkxx",
+      "avatar_url": "https://avatars.githubusercontent.com/u/185022794?v=4",
+      "profile_url": "https://github.com/maynkxx",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "srinivas365",
+      "avatar_url": "https://avatars.githubusercontent.com/u/25025778?v=4",
+      "profile_url": "https://github.com/srinivas365",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "OhJuhun",
+      "avatar_url": "https://avatars.githubusercontent.com/u/35685411?v=4",
+      "profile_url": "https://github.com/OhJuhun",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "bhavya-arora-zs",
+      "avatar_url": "https://avatars.githubusercontent.com/u/78477200?v=4",
+      "profile_url": "https://github.com/bhavya-arora-zs",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "iyashjayesh",
+      "avatar_url": "https://avatars.githubusercontent.com/u/53042582?v=4",
+      "profile_url": "https://github.com/iyashjayesh",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "FPNL",
+      "avatar_url": "https://avatars.githubusercontent.com/u/40191392?v=4",
+      "profile_url": "https://github.com/FPNL",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "vigneshp91",
+      "avatar_url": "https://avatars.githubusercontent.com/u/10446298?v=4",
+      "profile_url": "https://github.com/vigneshp91",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "VIDHITTS",
+      "avatar_url": "https://avatars.githubusercontent.com/u/179738165?v=4",
+      "profile_url": "https://github.com/VIDHITTS",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "vtushar06",
+      "avatar_url": "https://avatars.githubusercontent.com/u/180023952?v=4",
+      "profile_url": "https://github.com/vtushar06",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "up1",
+      "avatar_url": "https://avatars.githubusercontent.com/u/25113?v=4",
+      "profile_url": "https://github.com/up1",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "srrathi",
+      "avatar_url": "https://avatars.githubusercontent.com/u/57089237?v=4",
+      "profile_url": "https://github.com/srrathi",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "singhankit001",
+      "avatar_url": "https://avatars.githubusercontent.com/u/155445436?v=4",
+      "profile_url": "https://github.com/singhankit001",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "adityakrmishra",
+      "avatar_url": "https://avatars.githubusercontent.com/u/154746713?v=4",
+      "profile_url": "https://github.com/adityakrmishra",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "amaydixit11",
+      "avatar_url": "https://avatars.githubusercontent.com/u/65495380?v=4",
+      "profile_url": "https://github.com/amaydixit11",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "Bortlesboat",
+      "avatar_url": "https://avatars.githubusercontent.com/u/169967362?v=4",
+      "profile_url": "https://github.com/Bortlesboat",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "yanurag-dev",
+      "avatar_url": "https://avatars.githubusercontent.com/u/95437051?v=4",
+      "profile_url": "https://github.com/yanurag-dev",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "Ari1009",
+      "avatar_url": "https://avatars.githubusercontent.com/u/69034460?v=4",
+      "profile_url": "https://github.com/Ari1009",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "aaryyya",
+      "avatar_url": "https://avatars.githubusercontent.com/u/127311922?v=4",
+      "profile_url": "https://github.com/aaryyya",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "ary82",
+      "avatar_url": "https://avatars.githubusercontent.com/u/137564277?v=4",
+      "profile_url": "https://github.com/ary82",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "Ashish-Kumar-Dash",
+      "avatar_url": "https://avatars.githubusercontent.com/u/186616846?v=4",
+      "profile_url": "https://github.com/Ashish-Kumar-Dash",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "ayusjayaswal",
+      "avatar_url": "https://avatars.githubusercontent.com/u/95228530?v=4",
+      "profile_url": "https://github.com/ayusjayaswal",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "Ayushjhawar8",
+      "avatar_url": "https://avatars.githubusercontent.com/u/111112495?v=4",
+      "profile_url": "https://github.com/Ayushjhawar8",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "CSEBittuKr",
+      "avatar_url": "https://avatars.githubusercontent.com/u/152794122?v=4",
+      "profile_url": "https://github.com/CSEBittuKr",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "1991-bishnu",
+      "avatar_url": "https://avatars.githubusercontent.com/u/24665679?v=4",
+      "profile_url": "https://github.com/1991-bishnu",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "briheet",
+      "avatar_url": "https://avatars.githubusercontent.com/u/127481679?v=4",
+      "profile_url": "https://github.com/briheet",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "Chandanaschandu",
+      "avatar_url": "https://avatars.githubusercontent.com/u/114733441?v=4",
+      "profile_url": "https://github.com/Chandanaschandu",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "mrgear111",
+      "avatar_url": "https://avatars.githubusercontent.com/u/181999089?v=4",
+      "profile_url": "https://github.com/mrgear111",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "danysz",
+      "avatar_url": "https://avatars.githubusercontent.com/u/1667904?v=4",
+      "profile_url": "https://github.com/danysz",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "deepakpathik",
+      "avatar_url": "https://avatars.githubusercontent.com/u/184906872?v=4",
+      "profile_url": "https://github.com/deepakpathik",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "sammy200-ui",
+      "avatar_url": "https://avatars.githubusercontent.com/u/187490777?v=4",
+      "profile_url": "https://github.com/sammy200-ui",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "Juneezee",
+      "avatar_url": "https://avatars.githubusercontent.com/u/20135478?v=4",
+      "profile_url": "https://github.com/Juneezee",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "thzgajendra",
+      "avatar_url": "https://avatars.githubusercontent.com/u/219787351?v=4",
+      "profile_url": "https://github.com/thzgajendra",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "Gursewakzopdev",
+      "avatar_url": "https://avatars.githubusercontent.com/u/215660967?v=4",
+      "profile_url": "https://github.com/Gursewakzopdev",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "HeerakKashyap",
+      "avatar_url": "https://avatars.githubusercontent.com/u/175127332?v=4",
+      "profile_url": "https://github.com/HeerakKashyap",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "iamgoroot",
+      "avatar_url": "https://avatars.githubusercontent.com/u/20914644?v=4",
+      "profile_url": "https://github.com/iamgoroot",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "Ishiezz",
+      "avatar_url": "https://avatars.githubusercontent.com/u/184398946?v=4",
+      "profile_url": "https://github.com/Ishiezz",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "ish1416",
+      "avatar_url": "https://avatars.githubusercontent.com/u/187595476?v=4",
+      "profile_url": "https://github.com/ish1416",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "iv4n-ga6l",
+      "avatar_url": "https://avatars.githubusercontent.com/u/75835662?v=4",
+      "profile_url": "https://github.com/iv4n-ga6l",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "Disdjj",
+      "avatar_url": "https://avatars.githubusercontent.com/u/44730034?v=4",
+      "profile_url": "https://github.com/Disdjj",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "JonasBakys0",
+      "avatar_url": "https://avatars.githubusercontent.com/u/17063640?v=4",
+      "profile_url": "https://github.com/JonasBakys0",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "ckshitij",
+      "avatar_url": "https://avatars.githubusercontent.com/u/14061081?v=4",
+      "profile_url": "https://github.com/ckshitij",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "kailashchoudhary11",
+      "avatar_url": "https://avatars.githubusercontent.com/u/75559082?v=4",
+      "profile_url": "https://github.com/kailashchoudhary11",
+      "contributions": 1,
+      "score": 1
+    },
+    {
+      "login": "leonardobiffi",
+      "avatar_url": "https://avatars.githubusercontent.com/u/20444705?v=4",
+      "profile_url": "https://github.com/leonardobiffi",
+      "contributions": 1,
+      "score": 1
+    }
+  ],
+  "totalContributors": 134
+}
diff --git a/src/data/team.json b/src/data/team.json
new file mode 100644
index 0000000..8b7af7a
--- /dev/null
+++ b/src/data/team.json
@@ -0,0 +1,32 @@
+[
+  {
+    "github": "aryanmehrotra",
+    "linkedin": "https://www.linkedin.com/in/aryanmehrotra/",
+    "role": "Maintainer",
+    "name": "Aryan Mehrotra"
+  },
+  {
+    "github": "vikash",
+    "linkedin": "https://www.linkedin.com/in/v4vikash/",
+    "role": "Creator",
+    "name": "Vikash"
+  },
+  {
+    "github": "Umang01-hash",
+    "linkedin": "https://www.linkedin.com/in/umang01-hash/",
+    "role": "Maintainer",
+    "name": "Umang"
+  },
+  {
+    "github": "coolwednesday",
+    "linkedin": "https://www.linkedin.com/in/divya-darshana/",
+    "role": "Maintainer",
+    "name": "Divya Darshana"
+  },
+  {
+    "github": "vipul-rawat",
+    "linkedin": "https://www.linkedin.com/in/vipul-rawat-b724b217a/",
+    "role": "Maintainer",
+    "name": "Vipul Rawat"
+  }
+]
diff --git a/src/images/zopsmart.svg b/src/images/zopsmart.svg
deleted file mode 100644
index c2b0f2e..0000000
--- a/src/images/zopsmart.svg
+++ /dev/null
@@ -1,5 +0,0 @@
-<svg width="158" height="48" viewBox="0 0 158 48" fill="none" xmlns="http://www.w3.org/2000/svg">
-<path d="M20.2253 22.4392L20.219 21.7782L18.3838 21.7942C17.8464 21.7506 17.5831 21.4108 17.5947 20.7739C17.5742 20.8246 17.5742 20.0906 17.5947 18.5712L16.2718 17.8728C15.9943 17.7937 16.1562 17.517 16.2718 17.17C16.3341 16.9841 16.577 16.4059 17.0013 15.4353C16.9617 15.1679 16.9418 14.8979 16.9417 14.6275C16.9417 11.3982 19.7662 8.77924 22.9884 8.77924C26.2106 8.77924 29.1623 11.3947 29.1623 14.6249C29.1623 16.5073 28.1739 18.2616 26.7123 19.3985L26.7221 22.4552L27.5281 22.457C27.537 20.7312 27.545 19.8665 27.5494 19.862C29.0208 18.581 29.9247 16.5188 29.9647 14.4683H30.7004V28.1416C30.7004 29.4849 29.6151 30.5702 28.165 30.5738C25.2907 29.9849 19.9175 30.0222 17.0938 30.5738C15.795 30.5756 14.5584 29.4849 14.5584 28.1425V14.4692L16.2398 14.4674C16.246 14.7521 16.2647 15.1293 16.2736 15.277L15.32 17.581C15.1714 17.8461 15.2043 18.0081 15.4178 18.0694L16.9426 18.8745L16.9408 21.3076C17.036 22.0238 17.3927 22.4072 18.0128 22.457L19.9788 22.4392H20.2262H20.2253ZM22.4724 10.014C21.8595 10.014 22.1246 9.98466 21.6744 10.0638C20.8871 10.3209 20.4147 10.9712 20.4379 11.7612C18.8161 11.9302 18.9113 14.3384 20.3231 14.3384H25.9721C27.2692 14.3384 27.5316 11.8368 25.6385 11.7799C25.7426 10.7319 24.4171 10.0069 23.548 10.6519C23.2215 10.2426 22.9644 10.1608 22.4724 10.014Z" fill="white"/>
-<path fill-rule="evenodd" clip-rule="evenodd" d="M48.659 28.8782V30.6432C47.8414 30.5177 47.2961 30.4964 46.2063 30.4964H38.3431C37.0851 30.4964 36.6234 30.5177 35.9527 30.5587V29.0668C36.3726 28.6674 36.7711 28.2057 37.4828 27.2805L45.4306 16.8338C45.6397 16.5811 45.8914 16.2875 46.2063 15.9299C45.7864 15.9717 45.2206 15.9922 44.9271 15.9922H39.182C38.0913 15.9922 37.4828 16.0349 36.7498 16.1399V14.3749C37.4624 14.4807 38.0913 14.5226 39.182 14.5226H45.9546C46.8139 14.5226 47.4847 14.5012 48.3031 14.4594V15.9095C47.8628 16.3302 47.4642 16.8133 46.7935 17.6967L39.0556 27.8703C38.7621 28.2484 38.4898 28.5642 38.0504 29.0677C38.7621 29.0259 39.1606 29.0259 39.6641 29.0259H46.2063C47.1911 29.0259 47.8832 28.9841 48.659 28.8791V28.8782ZM55.9138 30.7695C52.4754 30.7695 50.295 28.4788 50.295 24.842C50.295 21.2053 52.4745 18.8932 55.8933 18.8932C59.3103 18.8932 61.4703 21.2062 61.4703 24.8216C61.4703 28.4156 59.2898 30.7695 55.9138 30.7695ZM55.9351 20.2178C53.4398 20.2178 51.9087 21.9624 51.9087 24.7993C51.9087 27.6585 53.4398 29.4031 55.8933 29.4031C58.346 29.4031 59.8556 27.6594 59.8556 24.8216C59.8556 21.9837 58.346 20.2178 55.9351 20.2178ZM65.7689 34.9106H63.9238C64.0279 34.0904 64.0706 33.4179 64.0706 32.5567V21.5843C64.0706 20.5755 64.0279 19.9652 63.9238 19.1672H65.6007V20.3646C65.5979 20.6533 65.5771 20.9415 65.5385 21.2275C66.4814 19.7348 67.9493 18.9564 69.8157 18.9564C73.045 18.9564 75.0155 21.1635 75.0155 24.8216C75.0155 28.3942 73.0023 30.6859 69.8575 30.6859C68.0125 30.6859 66.5232 29.9075 65.5376 28.4574C65.6007 29.0463 65.6221 29.3613 65.6221 29.9288V32.5354C65.6221 33.5229 65.6639 34.1331 65.7689 34.9106ZM69.7098 29.3194C71.9961 29.3194 73.3795 27.6167 73.3795 24.8216C73.3795 21.9624 72.0379 20.3228 69.6894 20.3228C67.2785 20.3228 65.6425 22.1305 65.6425 24.842C65.6425 26.2085 66.0829 27.4699 66.8382 28.2048C67.5721 28.92 68.6201 29.3194 69.7107 29.3194H69.7098Z" fill="white"/>
-<path fill-rule="evenodd" clip-rule="evenodd" d="M76.5509 25.9772L79.5703 25.6623C79.6539 26.6079 79.7802 27.0278 80.1574 27.5118C80.7659 28.3106 81.8566 28.7519 83.2186 28.7519C85.3154 28.7519 86.5733 27.8062 86.5733 26.2298C86.5733 25.3669 86.1756 24.6526 85.5253 24.2958C84.8964 23.9596 84.77 23.9382 81.877 23.2657C80.3042 22.908 79.4662 22.5718 78.71 21.9837C77.6416 21.143 77.0963 19.9865 77.0963 18.5783C77.0963 15.6568 79.4448 13.7655 83.0513 13.7655C85.4417 13.7655 87.2449 14.5003 88.2716 15.8881C88.7964 16.582 89.0482 17.2119 89.2991 18.3256L86.3011 18.6833C86.1756 17.9689 86.0288 17.6113 85.6721 17.1914C85.1268 16.5393 84.2043 16.1817 83.0513 16.1817C81.2276 16.1817 79.9902 17.1069 79.9902 18.4733C79.9902 19.3558 80.451 19.9652 81.4153 20.386C81.877 20.5755 82.0443 20.6173 84.3724 21.1422C86.0288 21.4998 87.035 21.8992 87.7894 22.425C88.985 23.3075 89.5303 24.464 89.5303 26.0403C89.5303 27.5331 89.0686 28.7519 88.2093 29.6139C87.0973 30.6859 85.4417 31.2108 83.1981 31.2108C81.4785 31.2108 79.8007 30.7909 78.7945 30.1183C77.9556 29.5508 77.348 28.7519 76.9495 27.7217C76.7609 27.2387 76.6773 26.8392 76.5509 25.9772ZM94.8556 30.8745H91.8994C92.0044 29.9706 92.0462 29.2776 92.0462 28.1425V21.5416C92.0462 20.2178 92.0044 19.6085 91.8994 18.8096H94.7088V19.8816C94.7088 20.0079 94.7088 20.3228 94.6883 20.6591C95.2959 19.3772 96.8474 18.5569 98.5884 18.5569C99.72 18.5569 100.643 18.8728 101.293 19.5035C101.67 19.8398 101.838 20.1129 102.09 20.7641C102.802 19.8184 103.201 19.4403 103.851 19.1041C104.543 18.7251 105.256 18.5569 106.2 18.5569C107.541 18.5569 108.631 18.9777 109.345 19.7553C110.036 20.5114 110.329 21.458 110.329 22.9507V28.1425C110.329 29.3195 110.371 30.0133 110.498 30.8745H107.436C107.562 30.0133 107.604 29.3826 107.604 28.1425V23.4338C107.604 21.5834 106.954 20.7436 105.549 20.7436C104.857 20.7436 104.333 20.9322 103.83 21.3743C103.096 22.0042 102.761 22.6767 102.509 23.9809V28.1425C102.509 29.299 102.551 30.0133 102.656 30.8745H99.6363C99.7618 29.992 99.8045 29.3408 99.8045 28.1425V23.4338C99.8045 21.6679 99.1328 20.7854 97.7699 20.7854C96.8892 20.7854 96.1775 21.143 95.6108 21.8787C95.1491 22.4881 94.9392 22.9712 94.7088 23.98V28.1425C94.7088 29.2776 94.7506 29.9075 94.8556 30.8745ZM121.044 30.8745V29.5089C120.205 30.3069 119.681 30.6014 118.822 30.8327C118.186 31.0032 117.53 31.0882 116.872 31.0853C114.313 31.0853 112.762 29.7607 112.762 27.5536C112.762 26.0822 113.684 24.7584 115.132 24.1481C116.494 23.5806 118.046 23.3706 121.044 23.3075V22.2355C121.044 21.0167 120.226 20.386 118.633 20.386C117.794 20.386 116.934 20.6173 116.453 20.9954C116.054 21.2898 115.865 21.5843 115.614 22.3405L112.93 21.8574C113.412 20.6386 113.789 20.0915 114.586 19.524C115.614 18.7678 116.788 18.452 118.591 18.452C120.604 18.452 121.821 18.8096 122.722 19.6921C123.434 20.3646 123.707 21.1635 123.707 22.5922V28.2475C123.707 29.3613 123.749 29.9288 123.875 30.8745H121.044ZM121.044 26.1871V25.1365C117.039 25.2201 115.466 25.914 115.466 27.5536C115.466 28.541 116.201 29.1513 117.375 29.1513C118.486 29.1513 119.576 28.7305 120.29 28.0375C120.792 27.5331 121.044 26.9228 121.044 26.1871ZM135.155 18.8096L134.421 21.458C133.54 21.2053 133.101 21.1217 132.555 21.1217C131.507 21.1217 130.71 21.458 130.123 22.1519C129.598 22.7612 129.389 23.2443 129.263 24.254V28.1416C129.263 29.2776 129.306 29.887 129.41 30.8745H126.412C126.515 29.9675 126.564 29.0553 126.559 28.1425V21.5416C126.559 20.2605 126.537 19.6716 126.412 18.8096H129.263V20.7845C130.018 19.2927 131.318 18.5783 133.205 18.5783C133.708 18.5783 134.212 18.6406 135.155 18.8096ZM138.091 15.5723H141.089C140.992 16.4307 140.943 17.2937 140.942 18.1575V18.8096H141.823C142.808 18.8096 143.27 18.7882 143.94 18.6833V21.1635C143.249 21.0585 142.85 21.0372 141.886 21.0372H140.943V27.5536C140.943 28.5837 141.32 28.9618 142.326 28.9618C142.871 28.9618 143.207 28.8569 143.856 28.4992L144.234 30.7277C143.332 31.064 142.704 31.169 141.613 31.169C139.203 31.169 138.237 30.3069 138.237 28.0998V21.0381H137.44C136.665 21.0381 136.266 21.0594 135.575 21.1644V18.6842C136.182 18.7891 136.581 18.8105 137.462 18.8105H138.237V18.1584C138.237 17.2546 138.175 16.3294 138.091 15.5723Z" fill="white"/>
-</svg>
diff --git a/src/lib/navigation.js b/src/lib/navigation.js
index f8e7ae5..7b87169 100644
--- a/src/lib/navigation.js
+++ b/src/lib/navigation.js
@@ -1,3 +1,285 @@
 export const navigation = [
+    {
+        title: 'Quick Start Guide',
+        desc: "Get started with GoFR through our Quick Start Guide. Learn to build scalable applications with easy-to-follow instructions on server setup, database connections, configuration management, and more. Boost your productivity and streamline your development process.",
+        links: [
+            {
+                title: 'Hello Server',
+                href: '/docs/quick-start/introduction',
+                desc: "Getting started with how to write a server using GoFR with basic examples and explanations. Boost your productivity with efficient coding practices and learn to build scalable applications quickly."
+            },
 
+            {
+                title: 'Configuration',
+                href: '/docs/quick-start/configuration',
+                desc: "Set up environment variables, manage settings, and streamline your development process."
+            },
+            {
+                title: 'Connecting Redis',
+                href: '/docs/quick-start/connecting-redis',
+                desc: "Discover how to connect your GoFR application to Redis for fast in-memory data storage."
+            },
+            {
+                title: 'Connecting MySQL',
+                href: '/docs/quick-start/connecting-mysql',
+                desc: "Step-by-step guide on integrating MySQL with your GoFR application. With managed database connections and new methods for increasing your productivity."
+            },
+            {
+                title: 'Observability',
+                href: '/docs/quick-start/observability',
+                desc: "Inbuilt logging, tracing, and metrics to enhance reliability and performance."
+            },
+            {
+                title: 'Adding REST Handlers',
+                href: '/docs/quick-start/add-rest-handlers',
+                desc: "Fastest way to create CRUD APIs by just providing the entity."
+            }
+        ],
+    },
+    {
+        title: 'Advanced Guide',
+        links: [
+            {
+                title: "Scheduling Cron Jobs",
+                href: "/docs/advanced-guide/using-cron",
+                desc: "Learn how to schedule and manage cron jobs in your application for automated tasks and background processes with GoFr's CRON job management."
+            },
+            {
+                title: 'Overriding Default',
+                href: '/docs/advanced-guide/overriding-default',
+                desc: "Understand how to override default configurations and behaviors in GoFr to tailor framework to your specific needs."
+            },
+            {
+                title: 'Remote Log Level Change',
+                href: '/docs/advanced-guide/remote-log-level-change',
+                desc: "Discover how to dynamically change log levels remotely, enabling you to adjust logging verbosity without redeploying your application."
+            },
+            {
+                title: 'Publishing Custom Metrics',
+                href: '/docs/advanced-guide/publishing-custom-metrics',
+                desc: "Explore methods for publishing custom metrics to monitor your application's performance and gain valuable insights."
+            },
+            {
+                title: 'Custom Headers in Response',
+                href: '/docs/advanced-guide/setting-custom-response-headers',
+                desc: "Learn how to include custom headers in HTTP responses to provide additional context and control to your API clients."
+            },
+            {
+                title: 'Custom Spans in Tracing',
+                href: '/docs/advanced-guide/custom-spans-in-tracing',
+                desc: "Learn to create custom spans for tracing to enhance observability and analyze the performance of your services."
+            },
+            {
+                title: 'Adding Custom Middleware',
+                href: '/docs/advanced-guide/middlewares',
+                desc: "Learn how to add custom middleware to your GoFr application for enhanced functionality and request processing."
+            },
+            {
+                title: 'HTTP Communication',
+                href: '/docs/advanced-guide/http-communication',
+                desc: "Get familiar with making HTTP requests and handling responses within your GoFr application to facilitate seamless communication."
+            },
+            {
+                title: 'Authentication',
+                href: '/docs/advanced-guide/authentication',
+                desc: "Implement various authentication methods to secure your GoFR application and protect sensitive endpoints across HTTP and gRPC."
+            },
+            {
+                title: 'Role-Based Access Control (RBAC)',
+                href: '/docs/advanced-guide/rbac',
+                desc: "Implement comprehensive Role-Based Access Control with support for roles, permissions, hierarchy, JWT integration, and fine-grained permission-based authorization."
+            },
+            {
+                title: 'Circuit Breaker Support',
+                href: '/docs/advanced-guide/circuit-breaker',
+                desc: "Understand how to implement circuit breaker patterns to enhance the resilience of your services against failures."
+            },
+            {
+                title: 'Monitoring Service Health',
+                href: '/docs/advanced-guide/monitoring-service-health',
+                desc: "Learn to monitor the health of your services effectively, ensuring optimal performance and quick issue resolution."
+            },
+            {
+                title: 'Handling Data Migrations',
+                href: '/docs/advanced-guide/handling-data-migrations',
+                desc: "Explore strategies for managing data migrations within your GoFr application to ensure smooth transitions and data integrity."
+            },
+            {
+                title: 'Writing gRPC Server/Client',
+                href: '/docs/advanced-guide/grpc',
+                desc: "Step-by-step guide on writing a gRPC server in GoFr to facilitate efficient communication between services."
+            },
+            {
+                title: 'gRPC Streaming',
+                href: '/docs/advanced-guide/grpc-streaming',
+                desc: "Learn how to implement server-side, client-side, and bidirectional streaming in GoFr with built-in observability and error handling."
+            },
+            {
+                title: 'Using Pub/Sub',
+                href: '/docs/advanced-guide/using-publisher-subscriber',
+                desc: "Discover how to GoFr seamlessly allows to integrate different Pub/Sub systems in your application for effective messaging and event-driven architectures."
+            },
+            {
+                title: 'Key Value Store',
+                href: '/docs/advanced-guide/key-value-store',
+                desc: "Explore how to implement and manage a key-value store in your GoFr application for fast and efficient data retrieval. Supports BadgerDB, NATS-KV, and DynamoDB."
+            },
+            {
+                title: 'Dealing with SQL',
+                href: '/docs/advanced-guide/dealing-with-sql',
+                desc: "Get insights into best practices for working with SQL databases in GoFr, including query optimization and error handling."
+            },
+            {
+                title: 'Automatic SwaggerUI Rendering',
+                href: '/docs/advanced-guide/swagger-documentation',
+                desc: "Learn how to automatically render SwaggerUI documentation for your GoFr APIs, improving discoverability and usability."
+            },
+            {
+                title: 'Adding Synchronous Startup Hooks',
+                href: '/docs/advanced-guide/startup-hooks',
+                desc: "Learn how to seed a database, warm up a cache, or perform other critical setup procedures, synchronously before starting your application."
+            },
+            {
+                title: 'Error Handling',
+                href: '/docs/advanced-guide/gofr-errors',
+                desc: "Understand error handling mechanisms in GoFr to ensure robust applications and improved user experience."
+            },
+            {
+                title: 'Handling File',
+                href: '/docs/advanced-guide/handling-file',
+                desc: "Explore how GoFr enables efficient file handling by abstracting remote and local filestore providers in your Go application. Learn to manage file uploads, downloads, and storage seamlessly, enhancing your application's capability to work with diverse data sources."
+            },
+            {
+                title: 'WebSockets',
+                href: '/docs/advanced-guide/websocket',
+                desc: "Explore how GoFr eases the process of WebSocket communication in your Golang application for real-time data exchange."
+            },
+            {
+                title: 'GraphQL',
+                href: '/docs/advanced-guide/graphql',
+                desc: 'Learn how to build native GraphQL APIs in GoFr using a schema-first approach with a ./configs/schema.graphqls file and an interactive playground.'
+            },
+            {
+                title: 'Serving-Static Files',
+                href: '/docs/advanced-guide/serving-static-files',
+                desc: "Know how GoFr automatically serves static content from a static folder in the application directory."
+            },
+            {
+                title: 'Profiling in GoFr Applications',
+                href: '/docs/advanced-guide/debugging',
+                desc: "Discover GoFr auto-enables pprof profiling by leveraging its built-in configurations."
+            },
+            {
+                title: 'Building CLI Applications',
+                href: '/docs/advanced-guide/building-cli-applications',
+                desc: "Learn to build powerful command-line interface (CLI) applications using GoFr's app.NewCMD(), offering a robust framework for command-line tools."
+            },
+        ],
+    },
+    {
+        title: 'Datasources',
+        links: [
+            {
+                title: "Getting Started",
+                href: "/docs/datasources/getting-started",
+                desc: "Learn how to connect to and interact with multiple databases in GoFr."
+            },
+            {
+                title: "ArangoDB",
+                href: "/docs/datasources/arangodb",
+                desc: "Learn how to connect to and interact with arango database in GoFr."
+            },
+            {
+                title: "Cassandra",
+                href: "/docs/datasources/cassandra",
+                desc: "Learn how to connect to and interact with cassandra database in GoFr."
+            },
+            {
+                title: "ClickHouse",
+                href: "/docs/datasources/clickhouse",
+                desc: "Learn how to connect to and interact with clickhouse database in GoFr."
+            },
+            {
+                title: "CockroachDB",
+                href: "/docs/datasources/cockroachdb",
+                desc: "Learn how to connect to and interact with CockroachDB in GoFr."
+            },
+            {
+                title: "Couchbase",
+                href: "/docs/datasources/couchbase",
+                desc: "Learn how to connect to and interact with couchbase database in GoFr."
+            },
+            {
+                title: "DGraph",
+                href: "/docs/datasources/dgraph",
+                desc: "Learn how to connect to and interact with dgraph database in GoFr."
+            },
+            {
+                title: "MongoDB",
+                href: "/docs/datasources/mongodb",
+                desc: "Learn how to connect to and interact with mongo database in GoFr."
+            },
+            {
+                title: "OpenTSDB",
+                href: "/docs/datasources/opentsdb",
+                desc: "Learn how to connect to and interact with opentsdb database in GoFr."
+            },
+            {
+                title: "OracleDB",
+                href: "/docs/datasources/oracle",
+                desc: "Learn how to connect to and interact with oracle database in GoFr."
+            },
+            {
+                title: "ScyllaDB",
+                href: "/docs/datasources/scylladb",
+                desc: "Learn how to connect to and interact with scylla database in GoFr."
+            },
+            {
+                title: "Solr",
+                href: "/docs/datasources/solr",
+                desc: "Learn how to connect to and interact with solr database in GoFr."
+            },
+            {
+                title: "SurrealDB",
+                href: "/docs/datasources/surrealdb",
+                desc: "Learn how to connect to and interact with surreal database in GoFr."
+            },
+            {
+                title: "Elasticsearch",
+                href: "/docs/datasources/elasticsearch",
+                desc: "Learn how to connect to and interact with elasticsearch in GoFr."
+            },
+            {
+                title: "InfluxDB",
+                href: "/docs/datasources/influxdb",
+                desc: "Learn how to connect to and interact with influxdb in GoFr."
+            },
+        ],
+    },
+    {
+        title: 'References',
+        links: [
+            {
+                title: 'Context',
+                href: '/docs/references/context',
+                desc: "Discover the GoFR context, an injected object that simplifies request-specific data handling for HTTP, gRPC, and Pub/Sub calls. Learn how it extends Go's context, providing easy access to dependencies like databases, loggers, and HTTP clients. Explore features for reading HTTP requests, binding data, and accessing query and path parameters efficiently, all while reducing application complexity."
+            },
+            {
+                title: 'Configs',
+                href: '/docs/references/configs',
+                desc: "Learn how to manage configuration settings in your GoFR applications, including default values for environment variables. This section provides a comprehensive list of all available configurations to streamline your setup."
+            },
+            {
+                title: 'Testing',
+                href: '/docs/references/testing',
+                desc: "GoFr provides a centralized collection of mocks to facilitate writing effective unit tests. Explore testing strategies and tools for GoFr applications, ensuring the code is robust, reliable, and maintainable."
+            },
+
+            {
+                title: 'GoFr CLI',
+                href: '/docs/references/gofrcli',
+                desc: "GoFr CLI is the command line tool for initializing projects and performing tasks in accordance with GoFr framework."
+            }
+        ],
+    },
 ]
\ No newline at end of file
diff --git a/src/markdoc/search.mjs b/src/markdoc/search.mjs
index 648175f..ea0b126 100644
--- a/src/markdoc/search.mjs
+++ b/src/markdoc/search.mjs
@@ -101,10 +101,12 @@ export default function withSearch(nextConfig = {}) {
                 fullRawText = cache.get(file)[2]
               } else {
                 let ast = Markdoc.parse(md)
-                let title =
-                  ast.attributes?.frontmatter?.match(
-                    /^title:\s*(.*?)\s*$/m,
-                  )?.[1]
+                let rawTitle = ast.attributes?.frontmatter?.match(
+                  /^title:\s*(.*?)\s*$/m,
+                )?.[1]
+                // Strip surrounding YAML quotes (single or double) so search
+                // results don't render the quoted form: `"My Title"`.
+                let title = rawTitle?.replace(/^["'](.*)["']$/, '$1')
 
                 // Extract structured sections
                 sections = [[title || 'Untitled', null, []]]
@@ -164,35 +166,72 @@ export default function withSearch(nextConfig = {}) {
                 }
               }
 
+              // Check if query matches at a word boundary (start of word)
+              function wordBoundaryMatch(text, query) {
+                try {
+                  let escaped = query.replace(/[-\\/\\\\^$*+?.()|[\\]{}]/g, '\\\\$&')
+                  let regex = new RegExp('(?:^|[\\\\s\\\\-_\\\\/,.;:()])' + escaped, 'i')
+                  return regex.test(text)
+                } catch(e) {
+                  return text.toLowerCase().includes(query.toLowerCase())
+                }
+              }
+
               export function search(query, options = {}) {
                 try {
-                  let defaultOptions = {
-                    limit: 10,
-                    ...options
-                  }
-                  
+                  let limit = (options && options.limit) || 10
                   let queryLower = query.toLowerCase().trim()
+
+                  if (queryLower.length === 0) return { items: [] }
+
                   let results = []
-                  
-                  // Search through all indexed content
+
                   for (let [url, data] of urlToData) {
+                    let titleLower = (data.title || '').toLowerCase()
                     let score = 0
-                    
-                    // Exact phrase match (highest priority)
-                    if (data.searchText.includes(queryLower)) {
-                      score += 10
-                      
-                      // Bonus for title matches
-                      if (data.title.toLowerCase().includes(queryLower)) {
-                        score += 5
-                      }
-                      
-                      // Bonus for early position in content
-                      let position = data.searchText.indexOf(queryLower)
-                      if (position < 100) {
-                        score += 3
+
+                    // 1. Exact title match (highest)
+                    if (titleLower === queryLower) {
+                      score = 100
+                    }
+                    // 2. Title starts with query
+                    else if (titleLower.startsWith(queryLower)) {
+                      score = 50
+                    }
+                    // 3. Title contains query at word boundary
+                    else if (wordBoundaryMatch(titleLower, queryLower)) {
+                      score = 30
+                    }
+                    // 4. Title contains query anywhere (mid-word like "BadgerDB" matching "ad")
+                    else if (titleLower.includes(queryLower)) {
+                      score = 5
+                    }
+                    // 5. Content contains query at word boundary
+                    else if (wordBoundaryMatch(data.searchText, queryLower)) {
+                      score = 15
+                    }
+                    // 6. Content contains query anywhere
+                    else if (data.searchText.includes(queryLower)) {
+                      score = 3
+                    }
+                    // 7. Multi-word: check if all words match
+                    else if (queryLower.includes(' ')) {
+                      let words = queryLower.split(/\\s+/).filter(w => w.length > 1)
+                      let matched = words.filter(w => data.searchText.includes(w))
+                      if (matched.length === words.length) {
+                        score = 20
+                      } else if (matched.length > 0) {
+                        score = matched.length * 2
                       }
-                      
+                    }
+
+                    if (score > 0) {
+                      // Bonus: page-level results over section-level (cleaner results)
+                      if (!url.includes('#')) score += 2
+
+                      // For very short queries (1-2 chars), suppress mid-word matches
+                      if (queryLower.length <= 2 && score <= 5) continue
+
                       results.push({
                         url: data.url || url,
                         title: data.title || '',
@@ -201,31 +240,10 @@ export default function withSearch(nextConfig = {}) {
                         score: score
                       })
                     }
-                    // Partial word matching
-                    else {
-                      let queryWords = queryLower.split(/\\s+/).filter(w => w.length > 2)
-                      let matchCount = 0
-                      
-                      for (let word of queryWords) {
-                        if (data.searchText.includes(word)) {
-                          matchCount++
-                        }
-                      }
-                      
-                      if (matchCount > 0) {
-                        score = matchCount / queryWords.length
-                        results.push({
-                          ...data,
-                          score: score
-                        })
-                      }
-                    }
                   }
-                  
-                  
-                  // Sort by score and limit results
+
                   results.sort((a, b) => b.score - a.score)
-                  results = results.slice(0, defaultOptions.limit)
+                  results = results.slice(0, limit)
                   return { items: results }
                 } catch (error) {
                   console.error('Search failed:', error)
diff --git a/src/markdoc/tags.js b/src/markdoc/tags.js
index a268786..1d68c3c 100644
--- a/src/markdoc/tags.js
+++ b/src/markdoc/tags.js
@@ -1,6 +1,11 @@
 import { Callout } from '@/components/Callout'
 import { NewTabLink } from '@/components/NewTabLinks'
 import { QuickLink, QuickLinks } from '@/components/QuickLinks'
+import { Tabs, Tab } from '@/components/Tabs'
+import { SectionCards } from '@/components/SectionCards'
+import { Answer } from '@/components/Answer'
+import { FaqList, FaqItem } from '@/components/Faq'
+import { HowTo } from '@/components/HowTo'
 
 const tags = {
   callout: {
@@ -53,6 +58,50 @@ const tags = {
       newtab: { type: Boolean },
     },
   },
+  tabs: {
+    render: Tabs,
+    attributes: {
+      labels: { type: Array },
+    },
+  },
+  tab: {
+    render: Tab,
+    attributes: {
+      label: { type: String },
+    },
+  },
+  'section-cards': {
+    selfClosing: true,
+    render: SectionCards,
+  },
+  // {% answer %}...{% /answer %} — direct-answer callout for AEO/LLM extraction.
+  answer: {
+    render: Answer,
+  },
+  // {% faq %}{% faq-item question="..." %}...{% /faq-item %}{% /faq %}
+  // FaqList emits FAQPage JSON-LD when frontmatter `items` is provided.
+  faq: {
+    render: FaqList,
+    attributes: {
+      items: { type: Array },
+    },
+  },
+  'faq-item': {
+    render: FaqItem,
+    attributes: {
+      question: { type: String },
+      answer: { type: String },
+    },
+  },
+  // {% howto name="..." description="..." %} ordered list {% /howto %}
+  howto: {
+    render: HowTo,
+    attributes: {
+      name: { type: String },
+      description: { type: String },
+      steps: { type: Array },
+    },
+  },
 }
 
 export default tags
diff --git a/src/styles/prism.css b/src/styles/prism.css
index 509f0d2..db71ed1 100644
--- a/src/styles/prism.css
+++ b/src/styles/prism.css
@@ -46,18 +46,27 @@ pre[class*='language-'] {
   color: theme('colors.slate.400');
 }
 
-code {
+/*
+ * Inline-code styling. Scoped to `:not(pre) > code` so it ONLY hits
+ * inline `<code>` (in paragraphs, list items, headings, etc.) and not
+ * the `<code>` element that lives inside a `<pre>` for fenced code
+ * blocks. Without this scope, the inline background + border-radius +
+ * margin-right paints across each rendered line box of a multiline
+ * `<pre><code>`, producing per-line "pill" stripes — which is what was
+ * happening site-wide on every fenced code block.
+ */
+:not(pre) > code {
   background-color: var(--tw-prose-background);
   padding: 1px 2px;
   border-radius: 3px;
   margin-right: 2px;
 }
 
-code::before {
+:not(pre) > code::before {
   content: none !important;
 }
 
-code::after {
+:not(pre) > code::after {
   content: none !important;
 }
 
@@ -91,3 +100,23 @@ code::after {
   animation-iteration-count: infinite;
   animation-play-state: running; /* Ensure the animation runs by default */
 }
+
+/* WCAG 2.3.3 — respect users who've requested reduced motion at the */
+/* OS level (macOS Reduce Motion, Windows Show animations off, etc). */
+/* The marquee is decorative; pausing it doesn't change information. */
+@media (prefers-reduced-motion: reduce) {
+  /* Pause the marquee in place — don't disable the animation entirely. */
+  /* Each .item is `position: absolute` with a per-item animation-delay, */
+  /* so killing the animation collapses every item to the same absolute */
+  /* left and the whole row goes invisible. Pausing keeps the staggered */
+  /* positions and just freezes the scroll. */
+  .item {
+    animation-play-state: paused !important;
+  }
+  /* Same principle for the homepage decorative animations: pause, */
+  /* don't disable. */
+  .animate-gentle-drift,
+  .animate-orb-pulse {
+    animation-play-state: paused !important;
+  }
+}
diff --git a/tailwind.config.js b/tailwind.config.js
index ccd8bc7..a476644 100644
--- a/tailwind.config.js
+++ b/tailwind.config.js
@@ -28,6 +28,27 @@ module.exports = {
       maxWidth: {
         '8xl': '88rem',
       },
+      keyframes: {
+        // Decorative homepage motion. All paused under
+        // prefers-reduced-motion via the rule in src/styles/prism.css.
+        'gentle-drift': {
+          '0%, 100%': { transform: 'translateY(0)' },
+          '50%': { transform: 'translateY(-6px)' },
+        },
+        'orb-pulse': {
+          '0%, 100%': { opacity: '0.25' },
+          '50%': { opacity: '0.45' },
+        },
+        'line-in': {
+          '0%': { opacity: '0', transform: 'translateX(-4px)' },
+          '100%': { opacity: '1', transform: 'translateX(0)' },
+        },
+      },
+      animation: {
+        'gentle-drift': 'gentle-drift 4s ease-in-out infinite',
+        'orb-pulse': 'orb-pulse 8s ease-in-out infinite',
+        'line-in': 'line-in 300ms ease-out forwards',
+      },
     },
     screens: {
       xs: '10px',
diff --git a/utils/fetch-github-stars.mjs b/utils/fetch-github-stars.mjs
new file mode 100644
index 0000000..f0af7a3
--- /dev/null
+++ b/utils/fetch-github-stars.mjs
@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+// Build-time GitHub stars fetch.
+//
+// Why this exists: the header used to call the GitHub API from
+// useEffect on every page load — a render-blocking round trip on the
+// critical rendering path. Baking the star count in at build time
+// means the real number renders on first paint, no API call needed.
+//
+// Inputs:  none (hits the public GitHub repo metadata endpoint).
+// Output:  src/data/github-stars.json — { stars, fetchedAt, source }.
+//
+// Failure mode: every fetch is best-effort. If the API is down or
+// rate-limited at build time, we keep the previous JSON snapshot
+// rather than zero-out the badge. This avoids the "transient build
+// failure makes the homepage look unloved" problem.
+//
+// Auth: optional GITHUB_TOKEN raises the rate limit (5,000/hr
+// authenticated vs 60/hr unauthenticated).
+
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const repoRoot = path.resolve(__dirname, '..')
+const outFile = path.join(repoRoot, 'src/data/github-stars.json')
+
+const REPO = 'gofr-dev/gofr'
+const TIMEOUT_MS = 10000
+
+function headers() {
+  const h = {
+    Accept: 'application/vnd.github+json',
+    'User-Agent': 'gofr.dev build script',
+    'X-GitHub-Api-Version': '2022-11-28',
+  }
+  if (process.env.GITHUB_TOKEN) h.Authorization = `Bearer ${process.env.GITHUB_TOKEN}`
+  return h
+}
+
+async function fetchRepo() {
+  const ctrl = new AbortController()
+  const t = setTimeout(() => ctrl.abort(), TIMEOUT_MS)
+  try {
+    const res = await fetch(`https://api.github.com/repos/${REPO}`, {
+      headers: headers(),
+      signal: ctrl.signal,
+    })
+    if (!res.ok) throw new Error(`HTTP ${res.status}`)
+    return await res.json()
+  } finally {
+    clearTimeout(t)
+  }
+}
+
+function readSnapshot() {
+  try {
+    return JSON.parse(fs.readFileSync(outFile, 'utf8'))
+  } catch {
+    return null
+  }
+}
+
+async function main() {
+  const snapshot = readSnapshot()
+  let data
+  try {
+    data = await fetchRepo()
+  } catch (err) {
+    console.warn(
+      `[github-stars] live fetch failed (${err.message}); keeping snapshot.`,
+    )
+    if (snapshot) {
+      // Re-write snapshot as-is so timestamps don't get wiped by
+      // unrelated tooling. This is a no-op if the file is unchanged.
+      fs.writeFileSync(outFile, JSON.stringify(snapshot, null, 2) + '\n')
+      return
+    }
+    // No snapshot to fall back on — write a zeroed record so the
+    // import path still resolves at build time.
+    fs.mkdirSync(path.dirname(outFile), { recursive: true })
+    fs.writeFileSync(
+      outFile,
+      JSON.stringify({ stars: null, fetchedAt: null, source: 'unavailable' }, null, 2) + '\n',
+    )
+    return
+  }
+
+  // GitHub returns both `stargazers_count` and `watchers_count` (which
+  // are the same number, an API quirk). We mirror the existing
+  // client-side code, which read `data.watchers`, so the rendered
+  // number stays consistent across the site.
+  const stars =
+    typeof data?.watchers === 'number'
+      ? data.watchers
+      : typeof data?.stargazers_count === 'number'
+      ? data.stargazers_count
+      : null
+
+  if (stars === null) {
+    console.warn('[github-stars] no usable star count in response; keeping snapshot.')
+    if (snapshot) return
+  }
+
+  const out = {
+    stars: stars ?? snapshot?.stars ?? null,
+    fetchedAt: new Date().toISOString(),
+    source: 'github-api',
+  }
+
+  fs.mkdirSync(path.dirname(outFile), { recursive: true })
+  fs.writeFileSync(outFile, JSON.stringify(out, null, 2) + '\n')
+  console.log(
+    `[github-stars] wrote stars=${out.stars} to ${path.relative(repoRoot, outFile)}.`,
+  )
+}
+
+main()
diff --git a/utils/fetch-releases.mjs b/utils/fetch-releases.mjs
new file mode 100644
index 0000000..3b1e3aa
--- /dev/null
+++ b/utils/fetch-releases.mjs
@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+// Build-time fetch of every published GoFr release from the GitHub API
+// → src/app/changelog/releases.json. Runs in `prebuild` so the
+// changelog page always has the full history.
+//
+// Pagination: GitHub returns max 100 releases per page; we walk pages
+// until an empty response. With ~56+ releases this is 1-2 calls.
+//
+// Auth: optional. Public-repo unauthenticated calls get 60/hr per IP,
+// which is fine for typical CI runs. For higher volume set
+// GITHUB_TOKEN in the build environment.
+//
+// Failure mode: if the network is unavailable OR the API returns an
+// error, we keep the existing committed snapshot so builds never fail.
+// The snapshot lives in the repo precisely so offline / air-gapped CI
+// keeps working.
+
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const repoRoot = path.resolve(__dirname, '..')
+const outFile = path.join(repoRoot, 'src/app/changelog/releases.json')
+
+const REPO = 'gofr-dev/gofr'
+const PER_PAGE = 100
+const MAX_PAGES = 10 // 1000 releases max — way more than we'll ever have
+const TIMEOUT_MS = 15000
+
+async function fetchPage(page) {
+  const url = `https://api.github.com/repos/${REPO}/releases?per_page=${PER_PAGE}&page=${page}`
+  const headers = {
+    Accept: 'application/vnd.github+json',
+    'User-Agent': 'gofr.dev build script',
+    'X-GitHub-Api-Version': '2022-11-28',
+  }
+  if (process.env.GITHUB_TOKEN) {
+    headers.Authorization = `Bearer ${process.env.GITHUB_TOKEN}`
+  }
+
+  const ctrl = new AbortController()
+  const t = setTimeout(() => ctrl.abort(), TIMEOUT_MS)
+  try {
+    const res = await fetch(url, { headers, signal: ctrl.signal })
+    if (!res.ok) {
+      throw new Error(`HTTP ${res.status} ${res.statusText}`)
+    }
+    return await res.json()
+  } finally {
+    clearTimeout(t)
+  }
+}
+
+function shapeRelease(r) {
+  // Match the existing releases.json schema so the changelog page
+  // continues to work without modification.
+  return {
+    body: r.body || '',
+    date: r.published_at || r.created_at || null,
+    tag: r.tag_name || r.name || '',
+    url: r.html_url || `https://github.com/${REPO}/releases`,
+  }
+}
+
+async function main() {
+  let snapshot = null
+  if (fs.existsSync(outFile)) {
+    try {
+      snapshot = JSON.parse(fs.readFileSync(outFile, 'utf8'))
+    } catch {
+      snapshot = null
+    }
+  }
+
+  const all = []
+  try {
+    for (let page = 1; page <= MAX_PAGES; page++) {
+      const batch = await fetchPage(page)
+      if (!Array.isArray(batch) || batch.length === 0) break
+      all.push(...batch.map(shapeRelease))
+      if (batch.length < PER_PAGE) break
+    }
+  } catch (err) {
+    if (Array.isArray(snapshot) && snapshot.length) {
+      console.warn(
+        `[releases] fetch failed (${err.message}); keeping existing snapshot of ${snapshot.length} release(s).`,
+      )
+      return
+    }
+    console.warn(
+      `[releases] fetch failed and no snapshot: ${err.message}. Writing empty list.`,
+    )
+    fs.writeFileSync(outFile, '[]\n')
+    return
+  }
+
+  // Filter out drafts/prereleases the shape mapping might have allowed
+  // through with empty tags. Keep stable releases only.
+  const cleaned = all.filter((r) => r.tag && r.date)
+
+  // Newest-first by date (GitHub usually returns this order, but make
+  // it explicit so the page rendering doesn't depend on it).
+  cleaned.sort((a, b) => new Date(b.date) - new Date(a.date))
+
+  if (cleaned.length === 0 && Array.isArray(snapshot) && snapshot.length) {
+    console.warn(
+      `[releases] API returned 0 valid releases; keeping existing snapshot of ${snapshot.length}.`,
+    )
+    return
+  }
+
+  fs.writeFileSync(outFile, JSON.stringify(cleaned, null, 2) + '\n')
+  console.log(
+    `[releases] wrote ${cleaned.length} release(s) to ${path.relative(repoRoot, outFile)}.`,
+  )
+}
+
+main()
diff --git a/utils/fetch-roadmap.mjs b/utils/fetch-roadmap.mjs
new file mode 100644
index 0000000..6985d2a
--- /dev/null
+++ b/utils/fetch-roadmap.mjs
@@ -0,0 +1,219 @@
+#!/usr/bin/env node
+// Build-time fetch of the roadmap from GitHub →
+// src/data/roadmap.json. Two sources are merged:
+//
+//   1. Open milestones on `gofr-dev/gofr` (with their open issues).
+//      Milestones are the strongest signal: a maintainer chose to
+//      group these issues toward a target version / theme.
+//
+//   2. Open issues labeled `roadmap` (or any label listed in
+//      ROADMAP_LABELS env var, default `roadmap`). Milestone-less
+//      ideas the maintainers want to surface.
+//
+// Closed issues are excluded — those are shipped, and the changelog
+// is the canonical place for shipped work.
+//
+// Failure mode: if the network is unavailable OR the API errors, we
+// keep the existing committed snapshot so builds never fail.
+//
+// Auth: optional GITHUB_TOKEN env var raises the rate limit. Public-
+// repo unauthenticated calls get 60/hr per IP, plenty for typical CI.
+
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const repoRoot = path.resolve(__dirname, '..')
+const outFile = path.join(repoRoot, 'src/data/roadmap.json')
+
+const REPO = 'gofr-dev/gofr'
+const PER_PAGE = 100
+const MAX_PAGES = 5
+const TIMEOUT_MS = 15000
+// Default labels: `enhancement` is the standard GitHub label every
+// repo gets; the framework currently uses it for future-work tracking.
+// `roadmap` is honored when/if the maintainers introduce that label
+// for explicit roadmap tagging. Override via ROADMAP_LABELS env var.
+const ROADMAP_LABELS = (process.env.ROADMAP_LABELS || 'roadmap,enhancement')
+  .split(',')
+  .map((s) => s.trim())
+  .filter(Boolean)
+
+function headers() {
+  const h = {
+    Accept: 'application/vnd.github+json',
+    'User-Agent': 'gofr.dev build script',
+    'X-GitHub-Api-Version': '2022-11-28',
+  }
+  if (process.env.GITHUB_TOKEN) h.Authorization = `Bearer ${process.env.GITHUB_TOKEN}`
+  return h
+}
+
+async function fetchJson(url) {
+  const ctrl = new AbortController()
+  const t = setTimeout(() => ctrl.abort(), TIMEOUT_MS)
+  try {
+    const res = await fetch(url, { headers: headers(), signal: ctrl.signal })
+    if (!res.ok) throw new Error(`HTTP ${res.status} ${res.statusText} on ${url}`)
+    return await res.json()
+  } finally {
+    clearTimeout(t)
+  }
+}
+
+async function fetchPaged(baseUrl) {
+  const out = []
+  for (let page = 1; page <= MAX_PAGES; page++) {
+    const url = baseUrl + (baseUrl.includes('?') ? '&' : '?') + `per_page=${PER_PAGE}&page=${page}`
+    const batch = await fetchJson(url)
+    if (!Array.isArray(batch) || batch.length === 0) break
+    out.push(...batch)
+    if (batch.length < PER_PAGE) break
+  }
+  return out
+}
+
+function shapeIssue(i) {
+  return {
+    number: i.number,
+    title: i.title,
+    url: i.html_url,
+    state: i.state,
+    labels: (i.labels || []).map((l) => (typeof l === 'string' ? l : l.name)),
+    milestone: i.milestone?.title || null,
+    created_at: i.created_at,
+    updated_at: i.updated_at,
+    comments: i.comments,
+  }
+}
+
+function shapeMilestone(m) {
+  return {
+    title: m.title,
+    description: m.description || '',
+    due_on: m.due_on,
+    state: m.state,
+    open_issues: m.open_issues,
+    closed_issues: m.closed_issues,
+    progress:
+      m.open_issues + m.closed_issues > 0
+        ? Math.round((m.closed_issues / (m.open_issues + m.closed_issues)) * 100)
+        : 0,
+    url: m.html_url,
+  }
+}
+
+async function main() {
+  let snapshot = null
+  if (fs.existsSync(outFile)) {
+    try {
+      snapshot = JSON.parse(fs.readFileSync(outFile, 'utf8'))
+    } catch {
+      snapshot = null
+    }
+  }
+
+  try {
+    // 1. Open milestones, sorted by due date.
+    const milestones = (
+      await fetchJson(
+        `https://api.github.com/repos/${REPO}/milestones?state=open&sort=due_on&direction=asc&per_page=${PER_PAGE}`,
+      )
+    ).map(shapeMilestone)
+
+    // 2. All open issues with ANY of the configured labels. GitHub's
+    //    `labels=a,b` parameter is AND logic, so we issue one call per
+    //    label and union the results. Labels that don't exist on the
+    //    repo simply yield zero results.
+    const labeled = []
+    for (const label of ROADMAP_LABELS) {
+      try {
+        const batch = await fetchPaged(
+          `https://api.github.com/repos/${REPO}/issues?state=open&labels=${encodeURIComponent(label)}`,
+        )
+        labeled.push(...batch)
+      } catch (err) {
+        // Label-specific failure shouldn't doom the whole roadmap;
+        // log and continue.
+        console.warn(`[roadmap] label "${label}" lookup failed: ${err.message}`)
+      }
+    }
+
+    // 3. Open issues that have a milestone assigned (any milestone we
+    //    saw in step 1). One call per milestone — usually 1-3 calls.
+    const milestonedIssues = []
+    for (const m of milestones) {
+      const issues = await fetchPaged(
+        `https://api.github.com/repos/${REPO}/issues?state=open&milestone=${encodeURIComponent(m.title)}`,
+      )
+      milestonedIssues.push(...issues)
+    }
+
+    // Merge & dedupe (an issue can match both labelled and milestoned).
+    const byNumber = new Map()
+    for (const i of [...labeled, ...milestonedIssues]) {
+      // GitHub's issues endpoint returns PRs too; filter them out.
+      if (i.pull_request) continue
+      byNumber.set(i.number, shapeIssue(i))
+    }
+    const items = [...byNumber.values()].sort((a, b) =>
+      (a.milestone || 'zzz').localeCompare(b.milestone || 'zzz') ||
+      a.number - b.number,
+    )
+
+    const data = {
+      repo: REPO,
+      fetchedAt: new Date().toISOString(),
+      labels: ROADMAP_LABELS,
+      milestones,
+      items,
+    }
+
+    if (
+      items.length === 0 &&
+      milestones.length === 0 &&
+      Array.isArray(snapshot?.items) &&
+      snapshot.items.length
+    ) {
+      console.warn(
+        `[roadmap] API returned 0 items and 0 milestones; keeping existing snapshot.`,
+      )
+      return
+    }
+
+    fs.mkdirSync(path.dirname(outFile), { recursive: true })
+    fs.writeFileSync(outFile, JSON.stringify(data, null, 2) + '\n')
+    console.log(
+      `[roadmap] wrote ${milestones.length} milestone(s), ${items.length} item(s) to ${path.relative(repoRoot, outFile)}.`,
+    )
+  } catch (err) {
+    if (snapshot) {
+      console.warn(
+        `[roadmap] fetch failed (${err.message}); keeping existing snapshot.`,
+      )
+      return
+    }
+    fs.mkdirSync(path.dirname(outFile), { recursive: true })
+    fs.writeFileSync(
+      outFile,
+      JSON.stringify(
+        {
+          repo: REPO,
+          fetchedAt: new Date().toISOString(),
+          labels: ROADMAP_LABELS,
+          milestones: [],
+          items: [],
+          error: err.message,
+        },
+        null,
+        2,
+      ) + '\n',
+    )
+    console.warn(
+      `[roadmap] fetch failed and no snapshot. Wrote empty placeholder. Error: ${err.message}`,
+    )
+  }
+}
+
+main()
diff --git a/utils/fetch-team.mjs b/utils/fetch-team.mjs
new file mode 100644
index 0000000..24a5199
--- /dev/null
+++ b/utils/fetch-team.mjs
@@ -0,0 +1,358 @@
+#!/usr/bin/env node
+// Build-time enrichment for the team page.
+//
+// Inputs:
+//   - src/data/team.json  — manually maintained list of core team
+//     entries (role, optional github handle, optional linkedin URL).
+//
+// What this script does:
+//   1. For every team member with a `github` handle, fetches their
+//      public GitHub profile (name, bio, avatar, blog, company,
+//      location, followers, public repos).
+//   2. Paginates through every contributor of gofr-dev/gofr so the
+//      page can render an "All contributors" grid below the core team.
+//   3. Writes the merged data to src/data/team-enriched.json.
+//
+// What it does NOT do:
+//   - Scrape LinkedIn. LinkedIn URLs in team.json come straight from
+//     maintainers themselves and are surfaced as click-through links.
+//
+// Failure mode: every fetch is per-entry resilient — if a specific
+// profile or the contributors endpoint fails (rate-limit, network),
+// we fall back to that entry's previous snapshot data instead of
+// losing it. This avoids the "one half-rate-limited run blows away
+// the cached avatars" failure mode.
+//
+// Auth: optional GITHUB_TOKEN raises the rate limit dramatically
+// (5,000/hr authenticated vs 60/hr unauthenticated).
+
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const repoRoot = path.resolve(__dirname, '..')
+const inFile = path.join(repoRoot, 'src/data/team.json')
+const outFile = path.join(repoRoot, 'src/data/team-enriched.json')
+
+const REPO = 'gofr-dev/gofr'
+const TIMEOUT_MS = 15000
+
+function headers() {
+  const h = {
+    Accept: 'application/vnd.github+json',
+    'User-Agent': 'gofr.dev build script',
+    'X-GitHub-Api-Version': '2022-11-28',
+  }
+  if (process.env.GITHUB_TOKEN) h.Authorization = `Bearer ${process.env.GITHUB_TOKEN}`
+  return h
+}
+
+async function fetchJson(url) {
+  const ctrl = new AbortController()
+  const t = setTimeout(() => ctrl.abort(), TIMEOUT_MS)
+  try {
+    const res = await fetch(url, { headers: headers(), signal: ctrl.signal })
+    if (!res.ok) throw new Error(`HTTP ${res.status} on ${url}`)
+    return await res.json()
+  } finally {
+    clearTimeout(t)
+  }
+}
+
+async function fetchGithubProfile(login) {
+  try {
+    const u = await fetchJson(`https://api.github.com/users/${encodeURIComponent(login)}`)
+    return {
+      login: u.login,
+      avatar_url: u.avatar_url,
+      profile_url: u.html_url,
+      profile_name: u.name || null,
+      bio: u.bio || null,
+      blog: u.blog || null,
+      company: u.company || null,
+      location: u.location || null,
+      followers: u.followers || 0,
+      public_repos: u.public_repos || 0,
+    }
+  } catch (err) {
+    return { __error: err.message }
+  }
+}
+
+// Composite-score signals beyond commit count. Each query returns a
+// `total_count` we read directly without paginating — we just need
+// the number, never the items. The Search API has a tighter rate
+// limit (30/min authenticated) than the core REST API, so we throttle
+// across users via Promise.all per-user but serialize across users.
+//
+// `is:pr+is:merged+author:U+repo:R`   → PRs the user merged into the repo
+// `is:pr+reviewed-by:U+repo:R`        → PRs the user formally reviewed
+// `commenter:U+repo:R`                → unique threads (issues+PRs) the
+//                                       user has commented on
+//
+// The "reviewed-by:" qualifier counts only formal reviews submitted
+// via the PR review UI (Approve / Request changes / Comment-via-review).
+// Plain conversation comments fall under "commenter:" instead.
+async function fetchSearchTotal(query) {
+  const url = `https://api.github.com/search/issues?q=${encodeURIComponent(query)}&per_page=1`
+  try {
+    const data = await fetchJson(url)
+    return typeof data?.total_count === 'number' ? data.total_count : null
+  } catch {
+    return null
+  }
+}
+
+async function scoreContributor(login) {
+  const [prsMerged, reviewsAuthored, commentsAuthored] = await Promise.all([
+    fetchSearchTotal(`is:pr is:merged author:${login} repo:${REPO}`),
+    fetchSearchTotal(`is:pr reviewed-by:${login} repo:${REPO}`),
+    fetchSearchTotal(`commenter:${login} repo:${REPO}`),
+  ])
+  return { prsMerged, reviewsAuthored, commentsAuthored }
+}
+
+// Composite weights — chosen so a *gated, finished contribution*
+// (merged PR) outranks a single commit, formal reviews count next,
+// and bare conversation comments contribute a soft tail. Tuneable.
+//
+// score = 1·commits + 5·prs_merged + 2·reviews + 0.5·comments
+function compositeScore({ commits = 0, prsMerged = 0, reviewsAuthored = 0, commentsAuthored = 0 }) {
+  return (
+    1 * (commits || 0) +
+    5 * (prsMerged || 0) +
+    2 * (reviewsAuthored || 0) +
+    0.5 * (commentsAuthored || 0)
+  )
+}
+
+// We score the top N candidates by raw commit count rather than every
+// contributor — the GitHub Search API limit is 30 req/min authenticated
+// and each user costs 3 search calls. 15 candidates with a 7-sec delay
+// between users keeps us safely under the limit (about 26 req/min) and
+// finishes in ~100 sec wall time. The top 15 by commits comfortably
+// contains anyone realistically in the running for "top 5 by composite",
+// so this is a tight no-waste budget.
+const SCORE_TOP_N = 15
+const SCORE_DELAY_MS = 7000
+
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms))
+}
+
+async function fetchAllContributors() {
+  // Paginate until empty so the count is exact, not capped at 100.
+  const all = []
+  for (let page = 1; page <= 20; page++) {
+    try {
+      const batch = await fetchJson(
+        `https://api.github.com/repos/${REPO}/contributors?per_page=100&page=${page}`,
+      )
+      if (!Array.isArray(batch) || batch.length === 0) break
+      all.push(...batch)
+      if (batch.length < 100) break
+    } catch (err) {
+      console.warn(
+        `[team] contributors page ${page} failed (${err.message}); have ${all.length} so far.`,
+      )
+      // Return what we have plus an error marker so the caller can
+      // fall back to snapshot if appropriate.
+      return { items: all, partial: true, error: err.message }
+    }
+  }
+  return { items: all, partial: false }
+}
+
+// In CI, gofr-dev/gofr's docs/Dockerfile overlays team.json from the
+// framework into this repo before yarn refresh-data runs. Locally
+// (where the website is checked out without the framework alongside),
+// team.json is no longer committed here. Fall back to the sibling
+// gofr-dev/gofr clone if it's available — same source of truth.
+const FRAMEWORK_FALLBACK = path.resolve(repoRoot, '../gofr/docs/team.json')
+
+function locateTeamFile() {
+  if (fs.existsSync(inFile)) return inFile
+  if (fs.existsSync(FRAMEWORK_FALLBACK)) {
+    console.warn(
+      `[team] using framework fallback ${path.relative(repoRoot, FRAMEWORK_FALLBACK)}`,
+    )
+    return FRAMEWORK_FALLBACK
+  }
+  return null
+}
+
+async function main() {
+  const teamFile = locateTeamFile()
+  if (!teamFile) {
+    console.warn(`[team] no team.json at ${inFile} or framework fallback; skipping enrichment.`)
+    process.exit(0)
+  }
+
+  let snapshot = null
+  if (fs.existsSync(outFile)) {
+    try {
+      snapshot = JSON.parse(fs.readFileSync(outFile, 'utf8'))
+    } catch {
+      snapshot = null
+    }
+  }
+
+  // Snapshot lookup helpers — used to fall back per-member when the
+  // current fetch fails for that individual.
+  const snapshotByGithub = new Map()
+  for (const m of snapshot?.team || []) {
+    if (m.github && m.github_data) snapshotByGithub.set(m.github, m.github_data)
+  }
+
+  const team = JSON.parse(fs.readFileSync(teamFile, 'utf8'))
+
+  // Enrich each team member with GitHub profile data when handle is provided.
+  // If the live fetch fails, fall back to the snapshot's data for that member.
+  const coreTeam = []
+  let profileFailures = 0
+  for (const member of team) {
+    const enriched = { ...member }
+    if (member.github) {
+      const profile = await fetchGithubProfile(member.github)
+      if (profile?.__error) {
+        profileFailures++
+        const fallback = snapshotByGithub.get(member.github)
+        if (fallback) {
+          enriched.github_data = fallback
+          console.warn(
+            `[team] live fetch failed for "${member.github}" (${profile.__error}); using snapshot data.`,
+          )
+        } else {
+          console.warn(
+            `[team] live fetch failed for "${member.github}" (${profile.__error}); no snapshot fallback.`,
+          )
+        }
+      } else if (profile) {
+        enriched.github_data = profile
+        if (!enriched.name && profile.profile_name) enriched.name = profile.profile_name
+      }
+    }
+    coreTeam.push(enriched)
+  }
+
+  // Fetch all contributors (paginated). Fall back to snapshot if the
+  // request failed mid-flight or returned nothing.
+  const contributorsResult = await fetchAllContributors()
+  const coreLogins = new Set(coreTeam.map((m) => m.github).filter(Boolean))
+
+  // Cross-reference: stash each core member's commit count to
+  // gofr-dev/gofr under github_data.gofr_contributions so the team
+  // card can render "N commits" as a meaningful proof point. The
+  // GitHub contributor login is case-insensitive against the team.json
+  // handle (e.g. "Umang01-hash" vs "umang01-hash") so we lowercase
+  // before lookup.
+  const contributionsByLogin = new Map()
+  for (const c of contributorsResult.items || []) {
+    if (c?.login) contributionsByLogin.set(c.login.toLowerCase(), c.contributions)
+  }
+  for (const m of coreTeam) {
+    if (!m.github || !m.github_data) continue
+    const count = contributionsByLogin.get(m.github.toLowerCase())
+    if (typeof count === 'number') m.github_data.gofr_contributions = count
+  }
+
+  let contributors = (contributorsResult.items || [])
+    .filter((c) => c.type === 'User' && !c.login.includes('[bot]'))
+    .filter((c) => !coreLogins.has(c.login)) // de-dupe core team from grid
+    .map((c) => ({
+      login: c.login,
+      avatar_url: c.avatar_url,
+      profile_url: c.html_url,
+      contributions: c.contributions,
+    }))
+
+  // Score the top SCORE_TOP_N candidates with the composite signal.
+  // Snapshot fallback: if a search call fails for a user, the previous
+  // value from the snapshot (if any) is preserved so a transient rate-
+  // limit doesn't drop their reviews/PRs counts to zero.
+  const snapshotByLogin = new Map(
+    (snapshot?.contributors || []).map((c) => [c.login, c]),
+  )
+  const candidates = contributors.slice(0, SCORE_TOP_N)
+  let scoredCount = 0
+
+  for (let i = 0; i < candidates.length; i++) {
+    const c = candidates[i]
+    const fresh = await scoreContributor(c.login)
+    const fallback = snapshotByLogin.get(c.login) || {}
+    c.prs_merged = fresh.prsMerged ?? fallback.prs_merged ?? 0
+    c.reviews_authored = fresh.reviewsAuthored ?? fallback.reviews_authored ?? 0
+    c.comments_authored = fresh.commentsAuthored ?? fallback.comments_authored ?? 0
+    c.score = compositeScore({
+      commits: c.contributions,
+      prsMerged: c.prs_merged,
+      reviewsAuthored: c.reviews_authored,
+      commentsAuthored: c.comments_authored,
+    })
+    if (
+      fresh.prsMerged !== null ||
+      fresh.reviewsAuthored !== null ||
+      fresh.commentsAuthored !== null
+    ) {
+      scoredCount++
+    }
+    // Throttle between users to stay under the Search API's 30/min
+    // limit. Skip the wait after the last candidate.
+    if (i < candidates.length - 1) await sleep(SCORE_DELAY_MS)
+  }
+
+  // Un-scored contributors get a baseline score from commit count alone
+  // so the array remains comparable. They sort below any scored
+  // contributor with comparable commits because reviews/comments
+  // signals add to the scored ones.
+  for (const c of contributors.slice(SCORE_TOP_N)) {
+    c.score = compositeScore({ commits: c.contributions })
+  }
+
+  // Re-rank by composite score (descending). Stable sort: ties fall
+  // back to commit count since both sides have it.
+  contributors.sort((a, b) => (b.score || 0) - (a.score || 0))
+
+  // Total contributors INCLUDING the core team — so the page can show
+  // a true "X+ contributors" stat without having to add anything.
+  let totalContributors = (contributorsResult.items || []).filter(
+    (c) => c.type === 'User' && !c.login.includes('[bot]'),
+  ).length
+
+  // If the live contributor fetch failed AND we have a snapshot with
+  // useful contributor data, prefer the snapshot rather than blank.
+  if (
+    (contributorsResult.partial || contributors.length === 0) &&
+    Array.isArray(snapshot?.contributors) &&
+    snapshot.contributors.length > contributors.length
+  ) {
+    console.warn(
+      `[team] contributor fetch incomplete (got ${contributors.length}); using snapshot of ${snapshot.contributors.length}.`,
+    )
+    contributors = snapshot.contributors
+    totalContributors = snapshot.totalContributors || contributors.length + coreTeam.length
+  }
+
+  const data = {
+    repo: REPO,
+    fetchedAt: new Date().toISOString(),
+    team: coreTeam,
+    contributors,
+    totalContributors,
+  }
+
+  fs.mkdirSync(path.dirname(outFile), { recursive: true })
+  fs.writeFileSync(outFile, JSON.stringify(data, null, 2) + '\n')
+  console.log(
+    `[team] wrote ${coreTeam.length} core member(s), ${contributors.length} contributor(s) (total ${totalContributors}) to ${path.relative(repoRoot, outFile)}.${
+      profileFailures ? ` ${profileFailures} profile fetch(es) used snapshot fallback.` : ''
+    }${
+      typeof scoredCount !== 'undefined'
+        ? ` Composite scored ${scoredCount}/${SCORE_TOP_N} top candidates.`
+        : ''
+    }`,
+  )
+}
+
+main()
diff --git a/utils/generate-changelog-rss.mjs b/utils/generate-changelog-rss.mjs
new file mode 100644
index 0000000..ab2e830
--- /dev/null
+++ b/utils/generate-changelog-rss.mjs
@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+// Generates `public/changelog.xml` — an RSS 2.0 feed of GoFr releases
+// from src/app/changelog/releases.json. Devs subscribe to RSS feeds
+// for release announcements; without one they have to remember to
+// check the page or rely on the Twitter / Medium accounts. Pure
+// static — runs at build time only, no runtime API.
+
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const repoRoot = path.resolve(__dirname, '..')
+const releasesPath = path.join(repoRoot, 'src/app/changelog/releases.json')
+const outFile = path.join(repoRoot, 'public/changelog.xml')
+
+const SITE_URL = 'https://gofr.dev'
+const FEED_URL = `${SITE_URL}/changelog.xml`
+
+function escapeXml(s) {
+  return String(s ?? '')
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&apos;')
+}
+
+function rfc822(d) {
+  return new Date(d).toUTCString()
+}
+
+if (!fs.existsSync(releasesPath)) {
+  console.warn(`[changelog-rss] ${releasesPath} not present; skipping.`)
+  process.exit(0)
+}
+
+const releases = JSON.parse(fs.readFileSync(releasesPath, 'utf8'))
+const items = releases
+  .filter((r) => r.tag && r.date)
+  .slice(0, 50)
+  .map((r) => `
+    <item>
+      <title>${escapeXml(`GoFr ${r.tag}`)}</title>
+      <link>${escapeXml(r.url || `${SITE_URL}/changelog`)}</link>
+      <guid isPermaLink="false">${escapeXml(r.tag)}</guid>
+      <pubDate>${rfc822(r.date)}</pubDate>
+      <description><![CDATA[${r.body ?? ''}]]></description>
+    </item>`).join('')
+
+const xml = `<?xml version="1.0" encoding="UTF-8"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+  <channel>
+    <title>GoFr Releases</title>
+    <link>${SITE_URL}/changelog</link>
+    <atom:link href="${FEED_URL}" rel="self" type="application/rss+xml"/>
+    <description>Release notes for GoFr — an opinionated Go framework for production microservices.</description>
+    <language>en-us</language>
+    <lastBuildDate>${rfc822(new Date())}</lastBuildDate>${items}
+  </channel>
+</rss>
+`
+
+fs.mkdirSync(path.dirname(outFile), { recursive: true })
+fs.writeFileSync(outFile, xml)
+console.log(`[changelog-rss] wrote ${items.split('<item>').length - 1} releases to ${outFile}`)
diff --git a/utils/generate-doc-mtimes.mjs b/utils/generate-doc-mtimes.mjs
new file mode 100644
index 0000000..8957baa
--- /dev/null
+++ b/utils/generate-doc-mtimes.mjs
@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+// Generate src/data/doc-mtimes.json — a route-to-ISO-date map keyed by
+// the doc URL path (e.g. "/docs/advanced-guide/rbac"). Each value is
+// the last commit ISO date that touched the underlying source file.
+//
+// Why git mtime, not fs.statSync(file).mtime: filesystem mtimes get
+// bumped by anything that touches the file (a `git checkout` resets
+// them, a fresh clone gives every file the clone time). Git's last-
+// commit date is the only honest "last actually changed" signal.
+//
+// Run via npm prebuild. Build sandboxes without git fall back to fs
+// mtime so we never emit an empty map.
+
+import { execSync } from 'node:child_process'
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const repoRoot = path.resolve(__dirname, '..')
+const outFile = path.join(repoRoot, 'src/data/doc-mtimes.json')
+
+function gitMtime(absFile) {
+  try {
+    const out = execSync(`git log -1 --format=%cI -- "${absFile}"`, {
+      cwd: repoRoot,
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'ignore'],
+    }).trim()
+    if (out) return out
+  } catch {
+    // git unavailable or file untracked.
+  }
+  try {
+    return fs.statSync(absFile).mtime.toISOString()
+  } catch {
+    return null
+  }
+}
+
+function pageFileToRoute(absFile) {
+  const rel = path
+    .relative(path.join(repoRoot, 'src/app'), absFile)
+    .replace(/\\/g, '/')
+  const route = '/' + rel.replace(/\/?page\.(md|jsx|tsx|ts|js)$/, '')
+  if (route === '/' || route === '') return '/'
+  return route
+}
+
+function walk(dir, acc = []) {
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name)
+    if (entry.isDirectory()) {
+      walk(full, acc)
+    } else if (/^page\.(md|jsx|tsx|ts|js)$/.test(entry.name)) {
+      acc.push(full)
+    }
+  }
+  return acc
+}
+
+// Walk every directory whose .md content is overlaid from the
+// framework repo at deploy time. /docs was the only path covered
+// originally — extending to /why-gofr, /comparison, /migrate, /learn,
+// /faq means each of those routes also gets a "Last updated" byline
+// and a dateModified in JSON-LD instead of going dark.
+const OVERLAY_PATHS = [
+  'src/app/docs',
+  'src/app/why-gofr',
+  'src/app/comparison',
+  'src/app/migrate',
+  'src/app/learn',
+  'src/app/faq',
+]
+
+const map = {}
+let ok = 0
+let fallbacks = 0
+let scanned = 0
+for (const rel of OVERLAY_PATHS) {
+  const dir = path.join(repoRoot, rel)
+  if (!fs.existsSync(dir)) continue
+  scanned++
+  for (const file of walk(dir)) {
+    const route = pageFileToRoute(file)
+    const ts = gitMtime(file)
+    if (ts) {
+      map[route] = ts
+      ok++
+    } else {
+      fallbacks++
+    }
+  }
+}
+
+if (scanned === 0) {
+  console.warn('[doc-mtimes] no overlay paths present; skipping.')
+  process.exit(0)
+}
+
+fs.mkdirSync(path.dirname(outFile), { recursive: true })
+fs.writeFileSync(outFile, JSON.stringify(map, null, 2) + '\n')
+console.log(
+  `[doc-mtimes] wrote ${ok} entries (fallbacks=${fallbacks}) to ${path.relative(repoRoot, outFile)}`,
+)
diff --git a/utils/generate-llms-full.mjs b/utils/generate-llms-full.mjs
new file mode 100644
index 0000000..8f429b7
--- /dev/null
+++ b/utils/generate-llms-full.mjs
@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+// Generate public/llms-full.txt — a single concatenated plaintext
+// dump of every Markdoc page on the site, with a short header per
+// page identifying its route. AGENTS.md advertises this URL as the
+// "everything in one file" variant for AI tools that can ingest a
+// long-context dump rather than crawling page-by-page (Anthropic
+// Files API, OpenAI Assistants File Search, ChatGPT custom GPT
+// knowledge).
+//
+// Sources are walked in priority order: quick-start first (the
+// answer-most-likely-needed), then advanced-guide, datasources,
+// references, why-gofr, comparison, migrate, learn, faq.
+//
+// Run via npm prebuild + npm run refresh-data.
+
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const repoRoot = path.resolve(__dirname, '..')
+const outFile = path.join(repoRoot, 'public/llms-full.txt')
+
+// Order of inclusion roughly matches the typical "what does an AI
+// assistant need first?" priority. Higher-utility content earlier so
+// when an LLM truncates context, the foundational material survives.
+const SECTIONS = [
+  { dir: 'src/app/docs/quick-start',    label: 'Quick Start' },
+  { dir: 'src/app/docs/advanced-guide', label: 'Advanced Guide' },
+  { dir: 'src/app/docs/datasources',    label: 'Datasources' },
+  { dir: 'src/app/docs/references',     label: 'References' },
+  { dir: 'src/app/why-gofr',            label: 'Why GoFr' },
+  { dir: 'src/app/comparison',          label: 'Comparison' },
+  { dir: 'src/app/migrate',             label: 'Migration guides' },
+  { dir: 'src/app/learn',               label: 'Learn' },
+  { dir: 'src/app/faq',                 label: 'FAQ' },
+]
+
+function walk(dir, acc = []) {
+  if (!fs.existsSync(dir)) return acc
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name)
+    if (entry.isDirectory()) {
+      walk(full, acc)
+    } else if (entry.name === 'page.md') {
+      acc.push(full)
+    }
+  }
+  return acc
+}
+
+function pageFileToRoute(absFile) {
+  const rel = path
+    .relative(path.join(repoRoot, 'src/app'), absFile)
+    .replace(/\\/g, '/')
+  const route = '/' + rel.replace(/\/?page\.md$/, '')
+  return route === '/' ? '/' : route
+}
+
+// Strip frontmatter (yaml between --- markers) so the dump is pure
+// content. Markdoc tags ({% answer %}, {% faq %}, …) are left as-is
+// because they communicate intent and most LLMs handle them fine; if
+// that turns out noisy in practice we can swap to a markdoc.parse →
+// transform → text emit pipeline.
+function stripFrontmatter(text) {
+  if (!text.startsWith('---')) return text
+  const end = text.indexOf('\n---', 3)
+  if (end === -1) return text
+  return text.slice(end + 4).replace(/^\n+/, '')
+}
+
+const SITE_URL = 'https://gofr.dev'
+
+const header = [
+  '# GoFr — full content dump',
+  '',
+  '> Concatenated plaintext of every public docs page on https://gofr.dev.',
+  '> Intended for AI tools that ingest a single long context (Anthropic Files',
+  '> API, OpenAI Assistants File Search, ChatGPT custom GPT knowledge, etc.)',
+  '> rather than crawling page-by-page.',
+  '',
+  `> Generated: ${new Date().toISOString()}`,
+  '> Site: https://gofr.dev  ·  Repo: https://github.com/gofr-dev/gofr',
+  '',
+  '> For a smaller curated link index instead: https://gofr.dev/llms.txt',
+  '> For an AI-coding-assistant primer: https://gofr.dev/AGENTS.md',
+  '',
+  '---',
+  '',
+]
+
+let body = []
+let pageCount = 0
+
+for (const section of SECTIONS) {
+  const dir = path.join(repoRoot, section.dir)
+  const files = walk(dir)
+  if (files.length === 0) continue
+
+  body.push('', `# ${section.label}`, '')
+  for (const file of files.sort()) {
+    const route = pageFileToRoute(file)
+    const raw = fs.readFileSync(file, 'utf8')
+    const content = stripFrontmatter(raw).trim()
+    if (!content) continue
+
+    body.push(
+      `## ${SITE_URL}${route}`,
+      '',
+      content,
+      '',
+      '---',
+      '',
+    )
+    pageCount++
+  }
+}
+
+fs.mkdirSync(path.dirname(outFile), { recursive: true })
+fs.writeFileSync(outFile, header.concat(body).join('\n'))
+
+const sizeKb = (fs.statSync(outFile).size / 1024).toFixed(1)
+console.log(
+  `[llms-full] wrote ${pageCount} page(s) (${sizeKb} KB) to ${path.relative(repoRoot, outFile)}`,
+)
diff --git a/yarn.lock b/yarn.lock
index 759799e..18c9135 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -7,6 +7,16 @@
   resolved "https://registry.npmjs.org/@aashutoshrathi/word-wrap/-/word-wrap-1.2.6.tgz"
   integrity sha512-1Yjs2SvM8TflER/OD3cOjhWWOZb58A2t7wpE2S9XfBYTiIl+XFhQG2bjy4Pu1I+EAlCNUzRDYDdFwFYUKvXcIA==
 
+"@algolia/abtesting@1.4.0":
+  version "1.4.0"
+  resolved "https://registry.npmjs.org/@algolia/abtesting/-/abtesting-1.4.0.tgz"
+  integrity sha512-N0blWT/C0KOZ/OJ9GXBX66odJZlrYjMj3M+01y8ob1mjBFnBaBo7gOCyHBDQy60+H4pJXp3pSGlJOqJIueBH+A==
+  dependencies:
+    "@algolia/client-common" "5.38.0"
+    "@algolia/requester-browser-xhr" "5.38.0"
+    "@algolia/requester-fetch" "5.38.0"
+    "@algolia/requester-node-http" "5.38.0"
+
 "@algolia/autocomplete-core@^1.17.8":
   version "1.19.4"
   resolved "https://registry.npmjs.org/@algolia/autocomplete-core/-/autocomplete-core-1.19.4.tgz"
@@ -27,6 +37,122 @@
   resolved "https://registry.npmjs.org/@algolia/autocomplete-shared/-/autocomplete-shared-1.19.4.tgz"
   integrity sha512-V7tYDgRXP0AqL4alwZBWNm1HPWjJvEU94Nr7Qa2cuPcIAbsTAj7M/F/+Pv/iwOWXl3N7tzVzNkOWm7sX6JT1SQ==
 
+"@algolia/client-abtesting@5.38.0":
+  version "5.38.0"
+  resolved "https://registry.npmjs.org/@algolia/client-abtesting/-/client-abtesting-5.38.0.tgz"
+  integrity sha512-15d6zv8vtj2l9pnnp/EH7Rhq3/snCCHRz56NnX6xIUPrbJl5gCsIYXAz8C2IEkwOpoDb0r5G6ArY2gKdVMNezw==
+  dependencies:
+    "@algolia/client-common" "5.38.0"
+    "@algolia/requester-browser-xhr" "5.38.0"
+    "@algolia/requester-fetch" "5.38.0"
+    "@algolia/requester-node-http" "5.38.0"
+
+"@algolia/client-analytics@5.38.0":
+  version "5.38.0"
+  resolved "https://registry.npmjs.org/@algolia/client-analytics/-/client-analytics-5.38.0.tgz"
+  integrity sha512-jJIbYAhYvTG3+gEAP5Q5Dp6PFJfUR+atz5rsqm5KjAKK+faLFdHJbM2IbOo0xdyGd+SH259MzfQKLJ9mZZ27dQ==
+  dependencies:
+    "@algolia/client-common" "5.38.0"
+    "@algolia/requester-browser-xhr" "5.38.0"
+    "@algolia/requester-fetch" "5.38.0"
+    "@algolia/requester-node-http" "5.38.0"
+
+"@algolia/client-common@5.38.0":
+  version "5.38.0"
+  resolved "https://registry.npmjs.org/@algolia/client-common/-/client-common-5.38.0.tgz"
+  integrity sha512-aMCXzVPGJTeQnVU3Sdf30TfMN2+QyWcjfPTCCHyqVVgjPipb6RnK40aISGoO+rlYjh9LunDsNVFLwv+JEIF8bQ==
+
+"@algolia/client-insights@5.38.0":
+  version "5.38.0"
+  resolved "https://registry.npmjs.org/@algolia/client-insights/-/client-insights-5.38.0.tgz"
+  integrity sha512-4c3FbpMiJX+VcaAj0rYaQdTLS/CkrdOn4hW+5y1plPov7KC7iSHai/VBbirmHuAfW1hVPCIh1w/4erKKTKuo+Q==
+  dependencies:
+    "@algolia/client-common" "5.38.0"
+    "@algolia/requester-browser-xhr" "5.38.0"
+    "@algolia/requester-fetch" "5.38.0"
+    "@algolia/requester-node-http" "5.38.0"
+
+"@algolia/client-personalization@5.38.0":
+  version "5.38.0"
+  resolved "https://registry.npmjs.org/@algolia/client-personalization/-/client-personalization-5.38.0.tgz"
+  integrity sha512-FzLs6c8TBL4FSgNfnH2NL7O33ktecGiaKO4ZFG51QYORUzD5d6YwB9UBteaIYu/sgFoEdY57diYU4vyBH8R6iA==
+  dependencies:
+    "@algolia/client-common" "5.38.0"
+    "@algolia/requester-browser-xhr" "5.38.0"
+    "@algolia/requester-fetch" "5.38.0"
+    "@algolia/requester-node-http" "5.38.0"
+
+"@algolia/client-query-suggestions@5.38.0":
+  version "5.38.0"
+  resolved "https://registry.npmjs.org/@algolia/client-query-suggestions/-/client-query-suggestions-5.38.0.tgz"
+  integrity sha512-7apiahlgZLvOqrh0+hAYAp/UWjqz6AfSJrCwnsoQNzgIT09dLSPIKREelkuQeUrKy38vHWWpSQE3M0zWSp/YrA==
+  dependencies:
+    "@algolia/client-common" "5.38.0"
+    "@algolia/requester-browser-xhr" "5.38.0"
+    "@algolia/requester-fetch" "5.38.0"
+    "@algolia/requester-node-http" "5.38.0"
+
+"@algolia/client-search@>= 4.9.1 < 6", "@algolia/client-search@5.38.0":
+  version "5.38.0"
+  resolved "https://registry.npmjs.org/@algolia/client-search/-/client-search-5.38.0.tgz"
+  integrity sha512-PTAFMJOpVtJweExEYYgdmSCC6n4V/R+ctDL3fRQy77ulZM/p+zMLIQC9c7HCQE1zqpauvVck3f2zYSejaUTtrw==
+  dependencies:
+    "@algolia/client-common" "5.38.0"
+    "@algolia/requester-browser-xhr" "5.38.0"
+    "@algolia/requester-fetch" "5.38.0"
+    "@algolia/requester-node-http" "5.38.0"
+
+"@algolia/ingestion@1.38.0":
+  version "1.38.0"
+  resolved "https://registry.npmjs.org/@algolia/ingestion/-/ingestion-1.38.0.tgz"
+  integrity sha512-qGSUGgceJHGyJLZ06bFLwVe2Tpf9KwabmoBjFvFscVmMmU5scKya6voCYd9bdX7V0Xy1qya9MGbmTm4zlLuveQ==
+  dependencies:
+    "@algolia/client-common" "5.38.0"
+    "@algolia/requester-browser-xhr" "5.38.0"
+    "@algolia/requester-fetch" "5.38.0"
+    "@algolia/requester-node-http" "5.38.0"
+
+"@algolia/monitoring@1.38.0":
+  version "1.38.0"
+  resolved "https://registry.npmjs.org/@algolia/monitoring/-/monitoring-1.38.0.tgz"
+  integrity sha512-VnCtAUcHirvv/dDHg9jK1Z5oo4QOC5FKDxe40x8qloru2qDcjueT34jiAsB0gRos3VWf9v4iPSYTqMIFOcADpQ==
+  dependencies:
+    "@algolia/client-common" "5.38.0"
+    "@algolia/requester-browser-xhr" "5.38.0"
+    "@algolia/requester-fetch" "5.38.0"
+    "@algolia/requester-node-http" "5.38.0"
+
+"@algolia/recommend@5.38.0":
+  version "5.38.0"
+  resolved "https://registry.npmjs.org/@algolia/recommend/-/recommend-5.38.0.tgz"
+  integrity sha512-fqgeU9GqxQorFUeGP4et1MyY28ccf9PCeciHwDPSbPYYiTqBItHdUIiytsNpjC5Dnc0RWtuXWCltLwSw9wN/bQ==
+  dependencies:
+    "@algolia/client-common" "5.38.0"
+    "@algolia/requester-browser-xhr" "5.38.0"
+    "@algolia/requester-fetch" "5.38.0"
+    "@algolia/requester-node-http" "5.38.0"
+
+"@algolia/requester-browser-xhr@5.38.0":
+  version "5.38.0"
+  resolved "https://registry.npmjs.org/@algolia/requester-browser-xhr/-/requester-browser-xhr-5.38.0.tgz"
+  integrity sha512-nAUKbv4YQIXbpPi02AQvSPisD5FDDbT8XeYSh9HFoYP0Z3IpBLLDg7R4ahPvzd7gGsVKgEbXzRPWESXSji5yIg==
+  dependencies:
+    "@algolia/client-common" "5.38.0"
+
+"@algolia/requester-fetch@5.38.0":
+  version "5.38.0"
+  resolved "https://registry.npmjs.org/@algolia/requester-fetch/-/requester-fetch-5.38.0.tgz"
+  integrity sha512-bkuAHaadC6OxJd3SVyQQnU1oJ9G/zdCqua7fwr1tJDrA/v7KzeS5np4/m6BuRUpTgVgFZHSewGnMcgj9DLBoaQ==
+  dependencies:
+    "@algolia/client-common" "5.38.0"
+
+"@algolia/requester-node-http@5.38.0":
+  version "5.38.0"
+  resolved "https://registry.npmjs.org/@algolia/requester-node-http/-/requester-node-http-5.38.0.tgz"
+  integrity sha512-yHDKZTnMPR3/4bY0CVC1/uRnnbAaJ+pctRuX7G/HflBkKOrnUBDEGtQQHzEfMz2FHZ/tbCL+Q9r6mvwTSGp8nw==
+  dependencies:
+    "@algolia/client-common" "5.38.0"
+
 "@alloc/quick-lru@^5.2.0":
   version "5.2.0"
   resolved "https://registry.npmjs.org/@alloc/quick-lru/-/quick-lru-5.2.0.tgz"
@@ -90,7 +216,7 @@
   dependencies:
     "@bugsnag/core" "^8.0.0"
 
-"@bugsnag/core@^8.0.0":
+"@bugsnag/core@^8.0.0", "@bugsnag/core@^8.0.0-alpha.1":
   version "8.0.0"
   resolved "https://registry.npmjs.org/@bugsnag/core/-/core-8.0.0.tgz"
   integrity sha512-AcDMjd4RZ+G8M/n6TFzL5P/1due+aNvTIu+26mu9TW2Tt4d/86lKVFQSy0H2Ju1HIaBdqtUUNCTXOIeNXJVkHQ==
@@ -186,7 +312,7 @@
   resolved "https://registry.npmjs.org/@emotion/memoize/-/memoize-0.9.0.tgz"
   integrity sha512-30FAj7/EoJ5mwVPOWhAyCX+FPfMDrVecJAM+Iw9NRoSl4BBAQeqj4cApHHUXOVvIPgLVDsCFoz/hGD+5QQD1GQ==
 
-"@emotion/react@^11.11.4":
+"@emotion/react@^11.0.0-rc.0", "@emotion/react@^11.11.4", "@emotion/react@^11.4.1", "@emotion/react@^11.5.0":
   version "11.11.4"
   resolved "https://registry.npmjs.org/@emotion/react/-/react-11.11.4.tgz"
   integrity sha512-t8AjMlF0gHpvvxk5mAtCqR4vmxiGHCeJBaQO6gncUSdklELOgtwjerNY2yuJNfwnc6vi16U/+uMF+afIawJ9iw==
@@ -216,7 +342,7 @@
   resolved "https://registry.npmjs.org/@emotion/sheet/-/sheet-1.4.0.tgz"
   integrity sha512-fTBW9/8r2w3dXWYM4HCB1Rdp8NLibOw2+XELH5m5+AkWiL/KqYX6dc0kKYlaYyKjrQ6ds33MCdMPEwgs2z1rqg==
 
-"@emotion/styled@^11.11.0":
+"@emotion/styled@^11.11.0", "@emotion/styled@^11.3.0":
   version "11.11.5"
   resolved "https://registry.npmjs.org/@emotion/styled/-/styled-11.11.5.tgz"
   integrity sha512-/ZjjnaNKvuMPxcIiUkf/9SHoG4Q196DRl1w82hQ3WCsjo1IUR8uaGWrC6a87CrYAW0Kb/pK7hk8BnLgLRi9KoQ==
@@ -349,7 +475,7 @@
     "@jridgewell/resolve-uri" "^3.1.0"
     "@jridgewell/sourcemap-codec" "^1.4.14"
 
-"@markdoc/markdoc@0.3.0":
+"@markdoc/markdoc@*", "@markdoc/markdoc@0.3.0":
   version "0.3.0"
   resolved "https://registry.npmjs.org/@markdoc/markdoc/-/markdoc-0.3.0.tgz"
   integrity sha512-QWCF8krIIw52ulflfnoff0yG1eKl9CCGA3KAiOjHyYtHNzSEouFh8lO52nAaO3qV2Ctj1GTB8TTb2rTfvISQfA==
@@ -375,7 +501,7 @@
   dependencies:
     "@babel/runtime" "^7.23.9"
 
-"@mui/material@^5.16.13":
+"@mui/material@^5.0.0", "@mui/material@^5.16.13":
   version "5.18.0"
   resolved "https://registry.npmjs.org/@mui/material/-/material-5.18.0.tgz"
   integrity sha512-bbH/HaJZpFtXGvWg3TsBWG4eyt3gah3E7nCNU8GLyRjVoWcA91Vm/T+sjHfUcwgJSw9iLtucfHBoq+qW/T30aA==
@@ -461,46 +587,6 @@
   resolved "https://registry.npmjs.org/@next/swc-darwin-arm64/-/swc-darwin-arm64-13.4.16.tgz"
   integrity sha512-Rl6i1uUq0ciRa3VfEpw6GnWAJTSKo9oM2OrkGXPsm7rMxdd2FR5NkKc0C9xzFCI4+QtmBviWBdF2m3ur3Nqstw==
 
-"@next/swc-darwin-x64@13.4.16":
-  version "13.4.16"
-  resolved "https://registry.npmjs.org/@next/swc-darwin-x64/-/swc-darwin-x64-13.4.16.tgz"
-  integrity sha512-o1vIKYbZORyDmTrPV1hApt9NLyWrS5vr2p5hhLGpOnkBY1cz6DAXjv8Lgan8t6X87+83F0EUDlu7klN8ieZ06A==
-
-"@next/swc-linux-arm64-gnu@13.4.16":
-  version "13.4.16"
-  resolved "https://registry.npmjs.org/@next/swc-linux-arm64-gnu/-/swc-linux-arm64-gnu-13.4.16.tgz"
-  integrity sha512-JRyAl8lCfyTng4zoOmE6hNI2f1MFUr7JyTYCHl1RxX42H4a5LMwJhDVQ7a9tmDZ/yj+0hpBn+Aan+d6lA3v0UQ==
-
-"@next/swc-linux-arm64-musl@13.4.16":
-  version "13.4.16"
-  resolved "https://registry.npmjs.org/@next/swc-linux-arm64-musl/-/swc-linux-arm64-musl-13.4.16.tgz"
-  integrity sha512-9gqVqNzUMWbUDgDiND18xoUqhwSm2gmksqXgCU0qaOKt6oAjWz8cWYjgpPVD0WICKFylEY/gvPEP1fMZDVFZ/g==
-
-"@next/swc-linux-x64-gnu@13.4.16":
-  version "13.4.16"
-  resolved "https://registry.npmjs.org/@next/swc-linux-x64-gnu/-/swc-linux-x64-gnu-13.4.16.tgz"
-  integrity sha512-KcQGwchAKmZVPa8i5PLTxvTs1/rcFnSltfpTm803Tr/BtBV3AxCkHLfhtoyVtVzx/kl/oue8oS+DSmbepQKwhw==
-
-"@next/swc-linux-x64-musl@13.4.16":
-  version "13.4.16"
-  resolved "https://registry.npmjs.org/@next/swc-linux-x64-musl/-/swc-linux-x64-musl-13.4.16.tgz"
-  integrity sha512-2RbMZNxYnJmW8EPHVBsGZPq5zqWAyBOc/YFxq/jIQ/Yn3RMFZ1dZVCjtIcsiaKmgh7mjA/W0ApbumutHNxRqqQ==
-
-"@next/swc-win32-arm64-msvc@13.4.16":
-  version "13.4.16"
-  resolved "https://registry.npmjs.org/@next/swc-win32-arm64-msvc/-/swc-win32-arm64-msvc-13.4.16.tgz"
-  integrity sha512-thDcGonELN7edUKzjzlHrdoKkm7y8IAdItQpRvvMxNUXa4d9r0ElofhTZj5emR7AiXft17hpen+QAkcWpqG7Jg==
-
-"@next/swc-win32-ia32-msvc@13.4.16":
-  version "13.4.16"
-  resolved "https://registry.npmjs.org/@next/swc-win32-ia32-msvc/-/swc-win32-ia32-msvc-13.4.16.tgz"
-  integrity sha512-f7SE1Mo4JAchUWl0LQsbtySR9xCa+x55C0taetjUApKtcLR3AgAjASrrP+oE1inmLmw573qRnE1eZN8YJfEBQw==
-
-"@next/swc-win32-x64-msvc@13.4.16":
-  version "13.4.16"
-  resolved "https://registry.npmjs.org/@next/swc-win32-x64-msvc/-/swc-win32-x64-msvc-13.4.16.tgz"
-  integrity sha512-WamDZm1M/OEM4QLce3lOmD1XdLEl37zYZwlmOLhmF7qYJ2G6oYm9+ejZVv+LakQIsIuXhSpVlOvrxIAHqwRkPQ==
-
 "@next/third-parties@^14.2.22":
   version "14.2.33"
   resolved "https://registry.npmjs.org/@next/third-parties/-/third-parties-14.2.33.tgz"
@@ -516,7 +602,7 @@
     "@nodelib/fs.stat" "2.0.5"
     run-parallel "^1.1.9"
 
-"@nodelib/fs.stat@2.0.5", "@nodelib/fs.stat@^2.0.2":
+"@nodelib/fs.stat@^2.0.2", "@nodelib/fs.stat@2.0.5":
   version "2.0.5"
   resolved "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz"
   integrity sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==
@@ -633,7 +719,7 @@
   dependencies:
     "@types/react" "*"
 
-"@types/react@*":
+"@types/react@*", "@types/react@^17.0.0 || ^18.0.0 || ^19.0.0":
   version "18.3.1"
   resolved "https://registry.npmjs.org/@types/react/-/react-18.3.1.tgz"
   integrity sha512-V0kuGBX3+prX+DQ/7r2qsv1NsdfnCLnTgnRJ1pYnxykBhGMz+qj+box5lq7XsO5mtZsBqpjwwTu/7wszPfMBcw==
@@ -697,7 +783,7 @@ acorn-jsx@^5.3.2:
   resolved "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-5.3.2.tgz"
   integrity sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==
 
-acorn@^8.9.0:
+"acorn@^6.0.0 || ^7.0.0 || ^8.0.0", acorn@^8.9.0:
   version "8.14.0"
   resolved "https://registry.npmjs.org/acorn/-/acorn-8.14.0.tgz"
   integrity sha512-cl669nCJTZBsL97OF4kUQm5g5hC2uihk0NxY3WENAC0TYdILVkAyHymAntgxGkl7K+t0cXIrH5siy5S4XkFycA==
@@ -712,6 +798,26 @@ ajv@^6.10.0, ajv@^6.12.4:
     json-schema-traverse "^0.4.1"
     uri-js "^4.2.2"
 
+"algoliasearch@>= 4.9.1 < 6":
+  version "5.38.0"
+  resolved "https://registry.npmjs.org/algoliasearch/-/algoliasearch-5.38.0.tgz"
+  integrity sha512-8VJKIzheeI9cjuVJhU1hYEVetOTe7LvA+CujAI7yqvYsPtZfVEvv1pg9AeFNtHBg/ZoSLGU5LPijhcY5l3Ea9g==
+  dependencies:
+    "@algolia/abtesting" "1.4.0"
+    "@algolia/client-abtesting" "5.38.0"
+    "@algolia/client-analytics" "5.38.0"
+    "@algolia/client-common" "5.38.0"
+    "@algolia/client-insights" "5.38.0"
+    "@algolia/client-personalization" "5.38.0"
+    "@algolia/client-query-suggestions" "5.38.0"
+    "@algolia/client-search" "5.38.0"
+    "@algolia/ingestion" "1.38.0"
+    "@algolia/monitoring" "1.38.0"
+    "@algolia/recommend" "5.38.0"
+    "@algolia/requester-browser-xhr" "5.38.0"
+    "@algolia/requester-fetch" "5.38.0"
+    "@algolia/requester-node-http" "5.38.0"
+
 ansi-regex@^5.0.1:
   version "5.0.1"
   resolved "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz"
@@ -962,7 +1068,7 @@ braces@^3.0.3, braces@~3.0.2:
   dependencies:
     fill-range "^7.1.1"
 
-browserslist@^4.21.10:
+browserslist@^4.21.10, "browserslist@>= 4.21.0":
   version "4.21.10"
   resolved "https://registry.npmjs.org/browserslist/-/browserslist-4.21.10.tgz"
   integrity sha512-bipEBdZfVH5/pwrvqc+Ub0kUPVfGUhlKxbvfD+z1BDnPEO/X98ruXGA1WP5ASpAFKan7Qr6j736IacbZQuAlKQ==
@@ -1070,7 +1176,7 @@ chownr@^1.1.1:
   resolved "https://registry.npmjs.org/chownr/-/chownr-1.1.4.tgz"
   integrity sha512-jJ0bqzaylmJtVnNgzTeSOs8DPavpbYgEr/b0YL8/2GO3xJEhInFmhKMUnEJQjZumK7KXGFhUy89PrsJWlakBVg==
 
-client-only@0.0.1, client-only@^0.0.1:
+client-only@^0.0.1, client-only@0.0.1:
   version "0.0.1"
   resolved "https://registry.npmjs.org/client-only/-/client-only-0.0.1.tgz"
   integrity sha512-IV3Ou0jSMzZrd3pZ48nLkT9DA7Ag1pnPzaiQhpW7c3RbcqqzvzzVu+L8gfqMp/8IM2MQtSiqaCxrrcfu8I8rMA==
@@ -1080,7 +1186,12 @@ clsx@^1.2.1:
   resolved "https://registry.npmjs.org/clsx/-/clsx-1.2.1.tgz"
   integrity sha512-EcR6r5a8bj6pu3ycsa/E/cKVGuTgZJZdsyUYHOksG/UHIiKfjxzRxYJpyVBwYaQeOvghal9fcc4PidlgzugAQg==
 
-clsx@^2.1.0, clsx@^2.1.1:
+clsx@^2.1.0:
+  version "2.1.1"
+  resolved "https://registry.npmjs.org/clsx/-/clsx-2.1.1.tgz"
+  integrity sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA==
+
+clsx@^2.1.1:
   version "2.1.1"
   resolved "https://registry.npmjs.org/clsx/-/clsx-2.1.1.tgz"
   integrity sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA==
@@ -1099,16 +1210,16 @@ color-convert@^2.0.1:
   dependencies:
     color-name "~1.1.4"
 
-color-name@1.1.3:
-  version "1.1.3"
-  resolved "https://registry.npmjs.org/color-name/-/color-name-1.1.3.tgz"
-  integrity sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw==
-
 color-name@^1.0.0, color-name@~1.1.4:
   version "1.1.4"
   resolved "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz"
   integrity sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==
 
+color-name@1.1.3:
+  version "1.1.3"
+  resolved "https://registry.npmjs.org/color-name/-/color-name-1.1.3.tgz"
+  integrity sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw==
+
 color-string@^1.9.0:
   version "1.9.1"
   resolved "https://registry.npmjs.org/color-string/-/color-string-1.9.1.tgz"
@@ -1549,7 +1660,7 @@ eslint-module-utils@^2.12.0, eslint-module-utils@^2.7.4:
   dependencies:
     debug "^3.2.7"
 
-eslint-plugin-import@^2.26.0:
+eslint-plugin-import@*, eslint-plugin-import@^2.26.0:
   version "2.31.0"
   resolved "https://registry.npmjs.org/eslint-plugin-import/-/eslint-plugin-import-2.31.0.tgz"
   integrity sha512-ixmkI62Rbc2/w8Vfxyh1jQRTdRTF52VxwRVHl/ykPAmqG+Nb7/kNn+byLP0LxPgI7zWA16Jt82SybJInmMia3A==
@@ -1637,7 +1748,7 @@ eslint-visitor-keys@^3.3.0, eslint-visitor-keys@^3.4.1:
   resolved "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz"
   integrity sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==
 
-eslint@8.45.0:
+eslint@*, "eslint@^2 || ^3 || ^4 || ^5 || ^6 || ^7.2.0 || ^8 || ^9", "eslint@^3 || ^4 || ^5 || ^6 || ^7 || ^8 || ^9", "eslint@^3 || ^4 || ^5 || ^6 || ^7 || ^8 || ^9.7", "eslint@^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0-0", "eslint@^6.0.0 || ^7.0.0 || >=8.0.0", "eslint@^7.0.0 || ^8.0.0", "eslint@^7.23.0 || ^8.0.0", eslint@8.45.0:
   version "8.45.0"
   resolved "https://registry.npmjs.org/eslint/-/eslint-8.45.0.tgz"
   integrity sha512-pd8KSxiQpdYRfYa9Wufvdoct3ZPQQuVuU5O6scNgMuOMYuxvH0IGaYK0wUFjo4UYYQQCUndlXiMbnxopwvvTiw==
@@ -1889,7 +2000,7 @@ github-from-package@0.0.0:
   resolved "https://registry.npmjs.org/github-from-package/-/github-from-package-0.0.0.tgz"
   integrity sha512-SyHy3T1v2NUXn29OsWdxmK6RwHD+vkj3v8en8AOBZ1wBQ/hCAQ5bAQTD02kW4W9tUp/3Qh6J8r9EvntiyCmOOw==
 
-glob-parent@^5.1.2, glob-parent@~5.1.2:
+glob-parent@^5.1.2:
   version "5.1.2"
   resolved "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz"
   integrity sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==
@@ -1903,23 +2014,18 @@ glob-parent@^6.0.2:
   dependencies:
     is-glob "^4.0.3"
 
+glob-parent@~5.1.2:
+  version "5.1.2"
+  resolved "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz"
+  integrity sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==
+  dependencies:
+    is-glob "^4.0.1"
+
 glob-to-regexp@^0.4.1:
   version "0.4.1"
   resolved "https://registry.npmjs.org/glob-to-regexp/-/glob-to-regexp-0.4.1.tgz"
   integrity sha512-lkX1HJXwyMcprw/5YUZc2s7DrpAiHB21/V+E1rHUrVNokkvB6bqMzT0VfV6/86ZNabt1k14YOIaT7nDvOX3Iiw==
 
-glob@7.1.7, glob@^7.1.3:
-  version "7.1.7"
-  resolved "https://registry.npmjs.org/glob/-/glob-7.1.7.tgz"
-  integrity sha512-OvD9ENzPLbegENnYP5UUfJIirTg4+XwMWGaQfQTY0JenxNvvIKP3U3/tAQSPIu/lHxXYSZmpXlUHeqAIdKzBLQ==
-  dependencies:
-    fs.realpath "^1.0.0"
-    inflight "^1.0.4"
-    inherits "2"
-    minimatch "^3.0.4"
-    once "^1.3.0"
-    path-is-absolute "^1.0.0"
-
 glob@^10.3.10:
   version "10.4.5"
   resolved "https://registry.npmjs.org/glob/-/glob-10.4.5.tgz"
@@ -1932,6 +2038,18 @@ glob@^10.3.10:
     package-json-from-dist "^1.0.0"
     path-scurry "^1.11.1"
 
+glob@^7.1.3, glob@7.1.7:
+  version "7.1.7"
+  resolved "https://registry.npmjs.org/glob/-/glob-7.1.7.tgz"
+  integrity sha512-OvD9ENzPLbegENnYP5UUfJIirTg4+XwMWGaQfQTY0JenxNvvIKP3U3/tAQSPIu/lHxXYSZmpXlUHeqAIdKzBLQ==
+  dependencies:
+    fs.realpath "^1.0.0"
+    inflight "^1.0.4"
+    inherits "2"
+    minimatch "^3.0.4"
+    once "^1.3.0"
+    path-is-absolute "^1.0.0"
+
 globals@^13.19.0:
   version "13.21.0"
   resolved "https://registry.npmjs.org/globals/-/globals-13.21.0.tgz"
@@ -2083,7 +2201,7 @@ inflight@^1.0.4:
     once "^1.3.0"
     wrappy "1"
 
-inherits@2, inherits@^2.0.3, inherits@^2.0.4:
+inherits@^2.0.3, inherits@^2.0.4, inherits@2:
   version "2.0.4"
   resolved "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz"
   integrity sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==
@@ -2322,7 +2440,7 @@ isarray@^2.0.5:
   resolved "https://registry.npmjs.org/isarray/-/isarray-2.0.5.tgz"
   integrity sha512-xHjhDr3cNBK0BzdUJSPXZntQUx/mwMS5Rw4A7lPJ90XGAO6ISP/ePDNuo0vhqOZU+UD5JoodwCAAoZQd3FeAKw==
 
-iserror@0.0.2, iserror@^0.0.2:
+iserror@^0.0.2, iserror@0.0.2:
   version "0.0.2"
   resolved "https://registry.npmjs.org/iserror/-/iserror-0.0.2.tgz"
   integrity sha512-oKGGrFVaWwETimP3SiWwjDeY27ovZoyZPHtxblC4hCq9fXxed/jasx+ATWFFjCVSRZng8VTMsN1nDnGo6zMBSw==
@@ -2362,16 +2480,9 @@ jiti@^1.21.6:
   resolved "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz"
   integrity sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==
 
-js-yaml@^4.1.0:
-  version "4.1.0"
-  resolved "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz"
-  integrity sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==
-  dependencies:
-    argparse "^2.0.1"
-
-js-yaml@^4.1.1:
+js-yaml@^4.1.0, js-yaml@^4.1.1:
   version "4.1.1"
-  resolved "https://registry.yarnpkg.com/js-yaml/-/js-yaml-4.1.1.tgz#854c292467705b699476e1a2decc0c8a3458806b"
+  resolved "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.1.tgz"
   integrity sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==
   dependencies:
     argparse "^2.0.1"
@@ -2521,13 +2632,6 @@ mimic-response@^3.1.0:
   resolved "https://registry.npmjs.org/mimic-response/-/mimic-response-3.1.0.tgz"
   integrity sha512-z0yWI+4FDrrweS8Zmt4Ej5HdJmky15+L2e6Wgn3+iK5fWzb6T3fhNFq2+MeTRb064c6Wr4N/wv0DzQTjNzHNGQ==
 
-minimatch@9.0.3:
-  version "9.0.3"
-  resolved "https://registry.npmjs.org/minimatch/-/minimatch-9.0.3.tgz"
-  integrity sha512-RHiac9mvaRw0x3AYRgDC1CxAP7HTcNrrECeA8YYJeWnpo+2Q5CegtZjaotWTWxDG3UeGA1coE05iH1mPjT/2mg==
-  dependencies:
-    brace-expansion "^2.0.1"
-
 minimatch@^3.0.4, minimatch@^3.0.5, minimatch@^3.1.2:
   version "3.1.2"
   resolved "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz"
@@ -2542,6 +2646,13 @@ minimatch@^9.0.4:
   dependencies:
     brace-expansion "^2.0.1"
 
+minimatch@9.0.3:
+  version "9.0.3"
+  resolved "https://registry.npmjs.org/minimatch/-/minimatch-9.0.3.tgz"
+  integrity sha512-RHiac9mvaRw0x3AYRgDC1CxAP7HTcNrrECeA8YYJeWnpo+2Q5CegtZjaotWTWxDG3UeGA1coE05iH1mPjT/2mg==
+  dependencies:
+    brace-expansion "^2.0.1"
+
 minimist@^1.2.0, minimist@^1.2.3, minimist@^1.2.6:
   version "1.2.8"
   resolved "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz"
@@ -2557,7 +2668,7 @@ mkdirp-classic@^0.5.2, mkdirp-classic@^0.5.3:
   resolved "https://registry.npmjs.org/mkdirp-classic/-/mkdirp-classic-0.5.3.tgz"
   integrity sha512-gKLcREMhtuZRwRAfqP3RFW+TK4JqApVBtOIftVgjuABpAtpxhPGaDcfvbhNvD0B8iD1oUr/txX35NjcaY6Ns/A==
 
-ms@2.1.2, ms@^2.1.1:
+ms@^2.1.1, ms@2.1.2:
   version "2.1.2"
   resolved "https://registry.npmjs.org/ms/-/ms-2.1.2.tgz"
   integrity sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w==
@@ -2591,7 +2702,7 @@ next-themes@^0.2.1:
   resolved "https://registry.npmjs.org/next-themes/-/next-themes-0.2.1.tgz"
   integrity sha512-B+AKNfYNIzh0vqQQKqQItTS8evEouKD7H5Hj3kmuPERwddR2TxvDSFZuTj6T7Jfn1oyeUyJMydPl1Bkxkh0W7A==
 
-next@13.4.16:
+next@*, "next@^13.0.0 || ^14.0.0", next@13.4.16:
   version "13.4.16"
   resolved "https://registry.npmjs.org/next/-/next-13.4.16.tgz"
   integrity sha512-1xaA/5DrfpPu0eV31Iro7JfPeqO8uxQWb1zYNTe+KDKdzqkAGapLcDYHMLNKXKB7lHjZ7LfKUOf9dyuzcibrhA==
@@ -2867,15 +2978,15 @@ postcss-nested@^6.2.0:
   dependencies:
     postcss-selector-parser "^6.1.1"
 
-postcss-selector-parser@6.0.10:
-  version "6.0.10"
-  resolved "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-6.0.10.tgz"
-  integrity sha512-IQ7TZdoaqbT+LCpShg46jnZVlhWD2w6iQYAcYXfHARZ7X1t/UGhhceQDs5X0cGqKvYlHNOuv7Oa1xmb0oQuA3w==
+postcss-selector-parser@^6.1.1:
+  version "6.1.2"
+  resolved "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-6.1.2.tgz"
+  integrity sha512-Q8qQfPiZ+THO/3ZrOrO0cJJKfpYCagtMUkXbnEfmgUjwXg6z/WBeOyS9APBBPCTSiDV+s4SwQGu8yFsiMRIudg==
   dependencies:
     cssesc "^3.0.0"
     util-deprecate "^1.0.2"
 
-postcss-selector-parser@^6.1.1, postcss-selector-parser@^6.1.2:
+postcss-selector-parser@^6.1.2:
   version "6.1.2"
   resolved "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-6.1.2.tgz"
   integrity sha512-Q8qQfPiZ+THO/3ZrOrO0cJJKfpYCagtMUkXbnEfmgUjwXg6z/WBeOyS9APBBPCTSiDV+s4SwQGu8yFsiMRIudg==
@@ -2883,11 +2994,28 @@ postcss-selector-parser@^6.1.1, postcss-selector-parser@^6.1.2:
     cssesc "^3.0.0"
     util-deprecate "^1.0.2"
 
+postcss-selector-parser@6.0.10:
+  version "6.0.10"
+  resolved "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-6.0.10.tgz"
+  integrity sha512-IQ7TZdoaqbT+LCpShg46jnZVlhWD2w6iQYAcYXfHARZ7X1t/UGhhceQDs5X0cGqKvYlHNOuv7Oa1xmb0oQuA3w==
+  dependencies:
+    cssesc "^3.0.0"
+    util-deprecate "^1.0.2"
+
 postcss-value-parser@^4.0.0, postcss-value-parser@^4.2.0:
   version "4.2.0"
   resolved "https://registry.npmjs.org/postcss-value-parser/-/postcss-value-parser-4.2.0.tgz"
   integrity sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ==
 
+postcss@^8.0.0, postcss@^8.1.0, postcss@^8.2.14, postcss@^8.4.21, postcss@^8.4.47, postcss@>=8.0.9:
+  version "8.5.6"
+  resolved "https://registry.npmjs.org/postcss/-/postcss-8.5.6.tgz"
+  integrity sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg==
+  dependencies:
+    nanoid "^3.3.11"
+    picocolors "^1.1.1"
+    source-map-js "^1.2.1"
+
 postcss@8.4.14:
   version "8.4.14"
   resolved "https://registry.npmjs.org/postcss/-/postcss-8.4.14.tgz"
@@ -2897,15 +3025,6 @@ postcss@8.4.14:
     picocolors "^1.0.0"
     source-map-js "^1.0.2"
 
-postcss@^8.4.47:
-  version "8.5.6"
-  resolved "https://registry.npmjs.org/postcss/-/postcss-8.5.6.tgz"
-  integrity sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg==
-  dependencies:
-    nanoid "^3.3.11"
-    picocolors "^1.1.1"
-    source-map-js "^1.2.1"
-
 prebuild-install@^7.1.1:
   version "7.1.1"
   resolved "https://registry.npmjs.org/prebuild-install/-/prebuild-install-7.1.1.tgz"
@@ -2934,7 +3053,7 @@ prettier-plugin-tailwindcss@^0.5.2:
   resolved "https://registry.npmjs.org/prettier-plugin-tailwindcss/-/prettier-plugin-tailwindcss-0.5.4.tgz"
   integrity sha512-QZzzB1bID6qPsKHTeA9qPo1APmmxfFrA5DD3LQ+vbTmAnY40eJI7t9Q1ocqel2EKMWNPLJqdTDWZj1hKYgqSgg==
 
-prettier@^3.0.1:
+prettier@^3.0, prettier@^3.0.1:
   version "3.0.3"
   resolved "https://registry.npmjs.org/prettier/-/prettier-3.0.3.tgz"
   integrity sha512-L/4pUDMxcNa8R/EthV08Zt42WBO4h1rarVtK0K+QJG0X187OLo7l699jWw0GKuwzkPQ//jMFA/8Xm6Fh3J/DAg==
@@ -2994,7 +3113,7 @@ rc@^1.2.7:
     minimist "^1.2.0"
     strip-json-comments "~2.0.1"
 
-react-dom@18.2.0:
+react-dom@*, "react-dom@^16 || ^17 || ^18", "react-dom@^17.0.0 || ^18.0.0 || ^19.0.0", react-dom@^18.2.0, "react-dom@>= 16.8.0", react-dom@>=16.6.0, react-dom@18.2.0:
   version "18.2.0"
   resolved "https://registry.npmjs.org/react-dom/-/react-dom-18.2.0.tgz"
   integrity sha512-6IMTriUmvsjHUjNtEDudZfuDQUoWXVxKHhlEGSk81n4YFS+r/Kl99wXiwlVXtPBtJenozv2P+hxDsw9eA7Xo6g==
@@ -3011,7 +3130,12 @@ react-highlight-words@^0.20.0:
     memoize-one "^4.0.0"
     prop-types "^15.5.8"
 
-react-is@^16.13.1, react-is@^16.7.0:
+react-is@^16.13.1:
+  version "16.13.1"
+  resolved "https://registry.npmjs.org/react-is/-/react-is-16.13.1.tgz"
+  integrity sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ==
+
+react-is@^16.7.0:
   version "16.13.1"
   resolved "https://registry.npmjs.org/react-is/-/react-is-16.13.1.tgz"
   integrity sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ==
@@ -3036,7 +3160,7 @@ react-transition-group@^4.4.5:
     loose-envify "^1.4.0"
     prop-types "^15.6.2"
 
-react@18.2.0:
+react@*, "react@^0.14.0 || ^15.0.0 || ^16.0.0-0 || ^17.0.0-0 || ^18.0.0-0", "react@^16 || ^17 || ^18", "react@^17.0.0 || ^18.0.0 || ^19.0.0", react@^18.2.0, "react@>= 16.8.0", "react@>= 16.8.0 || 17.x.x || ^18.0.0-0", react@>=16.0.0, react@>=16.6.0, react@>=16.8.0, react@18.2.0:
   version "18.2.0"
   resolved "https://registry.npmjs.org/react/-/react-18.2.0.tgz"
   integrity sha512-/3IjMdb2L9QbBdWiW5e3P2/npwMBaU9mHCSCUzNln0ZCYbcfTsGbTJrU/kGemdH2IWmB2ioZ+zkxtmq6g09fGQ==
@@ -3182,6 +3306,11 @@ scheduler@^0.23.0:
   dependencies:
     loose-envify "^1.1.0"
 
+"search-insights@>= 1 < 3":
+  version "2.17.3"
+  resolved "https://registry.npmjs.org/search-insights/-/search-insights-2.17.3.tgz"
+  integrity sha512-RQPdCYTa8A68uM2jwxoY842xDhvx3E5LFL1LxvxCNMev4o5mLuokczhzjAgGwUZBAmOKZknArSxLKmXtIi2AxQ==
+
 semver@^6.3.1:
   version "6.3.1"
   resolved "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz"
@@ -3328,6 +3457,13 @@ streamx@^2.15.0:
     fast-fifo "^1.1.0"
     queue-tick "^1.0.1"
 
+string_decoder@^1.1.1:
+  version "1.3.0"
+  resolved "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz"
+  integrity sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==
+  dependencies:
+    safe-buffer "~5.2.0"
+
 "string-width-cjs@npm:string-width@^4.2.0":
   version "4.2.3"
   resolved "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz"
@@ -3418,13 +3554,6 @@ string.prototype.trimstart@^1.0.8:
     define-properties "^1.2.1"
     es-object-atoms "^1.0.0"
 
-string_decoder@^1.1.1:
-  version "1.3.0"
-  resolved "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz"
-  integrity sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==
-  dependencies:
-    safe-buffer "~5.2.0"
-
 "strip-ansi-cjs@npm:strip-ansi@^6.0.1":
   version "6.0.1"
   resolved "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz"
@@ -3505,7 +3634,7 @@ supports-preserve-symlinks-flag@^1.0.0:
   resolved "https://registry.npmjs.org/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz"
   integrity sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==
 
-tailwindcss@^3.4.15:
+tailwindcss@^3.4.15, "tailwindcss@>=3.0.0 || insiders":
   version "3.4.17"
   resolved "https://registry.npmjs.org/tailwindcss/-/tailwindcss-3.4.17.tgz"
   integrity sha512-w33E2aCvSDP0tW9RZuNXadXlkHXqFzSkQew/aIa2i/Sj8fThxwovwlXHSPXTbAHwEIhBFXAedUhP2tueAKP8Og==
@@ -3706,6 +3835,11 @@ typed-array-length@^1.0.6:
     is-typed-array "^1.1.13"
     possible-typed-array-names "^1.0.0"
 
+typescript@>=3.3.1, typescript@>=4.2.0:
+  version "5.6.3"
+  resolved "https://registry.npmjs.org/typescript/-/typescript-5.6.3.tgz"
+  integrity sha512-hjcS1mhfuyi4WW8IWtjP7brDrG2cuDZukyrYrSauoXGNgx0S7zceP07adYkJycEr56BOUTNPzbInooiN3fn1qw==
+
 unbox-primitive@^1.0.2:
   version "1.0.2"
   resolved "https://registry.npmjs.org/unbox-primitive/-/unbox-primitive-1.0.2.tgz"