feat: home page and metadata additions

README.md

@@ -1,6 +1,6 @@
 # FXHU
 
-Daily foreign exchange rates as published by the National Bank of Hungary (Magyar Nemzeti Bank, MNB).
+Exchange rates API sourced from the National Bank of Hungary (Magyar Nemzeti Bank, MNB).
 
 ## Rate-setting methodology
 

astro.config.ts

@@ -2,14 +2,25 @@ import starlight from "@astrojs/starlight";
 import { defineConfig } from "astro/config";
 import starlightOpenAPI, { openAPISidebarGroups } from "starlight-openapi";
 
+import { buildId } from "./src/utils/buildId";
+import { socialImageHeight, socialImageWidth } from "./src/utils/socialImage";
+
 export default defineConfig({
   site: "https://fxhu.kripod.dev",
+  trailingSlash:
+    // TODO: Use 'always', see: https://github.com/withastro/astro/issues/10149
+    import.meta.env.PROD ? "always" : "ignore",
   integrations: [
     starlight({
       title: "FXHU",
+      description:
+        "Exchange rates API sourced from the National Bank of Hungary (Magyar Nemzeti Bank, MNB).",
       social: {
         github: "https://github.com/kripod/fxhu",
       },
+      editLink: {
+        baseUrl: "https://github.com/kripod/fxhu/edit/main/",
+      },
       plugins: [
         starlightOpenAPI([
           {
@@ -21,6 +32,44 @@ export default defineConfig({
         ]),
       ],
       sidebar: [...openAPISidebarGroups],
+      head: [
+        {
+          tag: "link",
+          attrs: {
+            rel: "icon",
+            href: "/favicon.ico",
+            sizes: "48x48",
+          },
+        },
+        {
+          tag: "meta",
+          attrs: {
+            property: "og:image",
+            content: "/assets/social-image.png?v=" + buildId,
+          },
+        },
+        {
+          tag: "meta",
+          attrs: {
+            property: "og:image:width",
+            content: socialImageWidth.toString(),
+          },
+        },
+        {
+          tag: "meta",
+          attrs: {
+            property: "og:image:height",
+            content: socialImageHeight.toString(),
+          },
+        },
+        {
+          tag: "meta",
+          attrs: {
+            name: "twitter:card",
+            content: "summary_large_image",
+          },
+        },
+      ],
     }),
   ],
 });

src/content/docs/index.mdx

@@ -1,5 +1,22 @@
 ---
-title: TODO
+title: FXHU
+editUrl: false
+head:
+  - tag: title
+    content: FXHU
+template: splash
+hero:
+  tagline: Exchange rates API sourced from the National Bank of Hungary (Magyar Nemzeti Bank, MNB).
+  image:
+    file: ../../../public/favicon.svg
+  actions:
+    - text: Get started
+      link: /docs/v1/
+      variant: primary
+      icon: right-arrow
+    - text: View on GitHub
+      link: https://github.com/kripod/fxhu
+      icon: external
+      attrs:
+        rel: me
 ---
-
-TODO

src/utils/buildId.ts

@@ -0,0 +1,3 @@
+export const buildId = import.meta.env.CF_PAGES_COMMIT_SHA
+  ? import.meta.env.CF_PAGES_COMMIT_SHA.slice(0, 7)
+  : Date.now().toString();

src/utils/socialImage.ts

@@ -0,0 +1,2 @@
+export const socialImageWidth = 1200;
+export const socialImageHeight = 628;