.gitea/workflows/ci.yml

@@ -0,0 +1,38 @@
+name: Node.js CI
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  lint:
+    name: Lint and Test
+
+    steps:
+      - name: Checkout Source Files
+        uses: actions/checkout@v4
+
+      - name: Use Node.js v22
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v2
+        with:
+          version: 9
+
+      - name: Install Dependencies
+        run: pnpm install
+
+      - name: Lint Source Files
+        run: pnpm run lint
+
+      - name: Verify Build
+        run: pnpm run build
+
+      - name: Run Tests
+        run: pnpm run test

package.json

@@ -6,7 +6,8 @@
     "dev": "next dev -p 3003",
     "build": "next build",
     "start": "next start -p 3003",
-    "lint": "eslint src --max-warnings 0"
+    "lint": "eslint src --max-warnings 0",
+    "test": "echo \"No tests yet!\" && exit 0"
   },
   "dependencies": {
     "gray-matter": "4.0.3",

src/app/page.tsx

@@ -4,23 +4,30 @@
  * @author Naomi Carrigan
  */
 
+import type { JSX } from "react";
 import { Rule } from "@/components/rule";
 import { getSortedPostsData } from "@/lib/posts";
 
-export default function Home() {
+/**
+ * Renders the home page.
+ * @returns JSX component.
+ */
+const Home = (): JSX.Element => {
   const posts = getSortedPostsData();
   return (
     <main>
       <h1>{"Blog"}</h1>
       <p>{"Welcome to the musings of a transfem software engineer!"}</p>
-        {posts.map((post) => {
-          return <div key={post.slug}>
-            <Rule />
-            <h2><a className="underline" href={`/post/${post.slug}`}>{post.data.title}</a></h2>
-            <p className="italic text-center">{post.data.date.toLocaleDateString("en-GB",{ year: "numeric", month: "long", day: "numeric"})}</p>
-            <p>{post.data.summary}</p>
-          </div>;
-        })}
+      {posts.map((post) => {
+        return <div key={post.slug}>
+          <Rule />
+          <h2><a className="underline" href={`/post/${post.slug}`}>{post.data.title}</a></h2>
+          <p className="italic text-center">{post.data.date.toLocaleDateString("en-GB", { day: "numeric", month: "long", year: "numeric" })}</p>
+          <p>{post.data.summary}</p>
+        </div>;
+      })}
     </main>
   );
-}
+};
+
+export default Home;

src/app/post/[slug]/page.tsx

@@ -1,23 +1,38 @@
-import { Rule } from "@/components/rule";
-import { getPostData } from "@/lib/posts";
+/**
+ * @copyright nhcarrigan
+ * @license Naomi's Public License
+ * @author Naomi Carrigan
+ */
+
 import Markdown from "react-markdown";
 import remarkGfm from "remark-gfm";
+import type { JSX } from "react";
+import { Rule } from "@/components/rule";
+import { getPostData } from "@/lib/posts";
 
-export default async function Page({
-    params
+/**
+ * Renders a blog post.
+ * @param props - The properties of the page.
+ * @param props.params - The path parameters.
+ * @returns The JSX component.
+ */
+const Page = async({
+  params,
 }: {
-    params: Promise<{slug: string}>
-}) {
-    const { slug } = await params;
-    const post = getPostData(slug);
-    return (
-        <main>
-            <h1>{post.data.title}</h1>
-            <p className="italic text-center">{`Published ${post.data.date.toLocaleDateString("en-GB", { weekday: "long", year: "numeric", month: "long", day: "numeric"})}`}</p>
-            <Rule />
-            <Markdown remarkPlugins={[remarkGfm]}>{post.content}</Markdown>
-            <Rule />
-            <a href="/">{"← Back to home"}</a>
-        </main>
-    )
-}
+  readonly params: Promise<{ slug: string }>;
+}): Promise<JSX.Element> => {
+  const { slug } = await params;
+  const post = getPostData(slug);
+  return (
+    <main>
+      <h1>{post.data.title}</h1>
+      <p className="italic text-center">{`Published ${post.data.date.toLocaleDateString("en-GB", { day: "numeric", month: "long", weekday: "long", year: "numeric" })}`}</p>
+      <Rule />
+      <Markdown remarkPlugins={[ remarkGfm ]}>{post.content}</Markdown>
+      <Rule />
+      <a href="/">{"← Back to home"}</a>
+    </main>
+  );
+};
+
+export default Page;

src/lib/posts.ts

@@ -10,49 +10,71 @@ import matter from "gray-matter";
 
 const postsDirectory = join(process.cwd(), "posts");
 
-export const getSortedPostsData = () => {
+/**
+ * Reads the posts directory and returns an array of post data.
+ * @returns An array of parsed frontmatter and file contents.
+ */
+const getSortedPostsData = (): Array<{
+  content: string;
+  data:    { date: Date; summary: string; title: string };
+  slug:    string;
+}> => {
   const fileNames = readdirSync(postsDirectory);
   const allPostsData = fileNames.map((fileName) => {
     const slug = fileName.replace(/\.md$/, "");
     const fullPath = join(postsDirectory, fileName);
     const fileContents = readFileSync(fullPath, "utf8");
+    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- matter doesn't take a generic I guess?
     const matterResult = matter(fileContents) as unknown as {
       content: string;
-      data: { title: string; date: string; summary: string };
+      data:    { title: string; date: string; summary: string };
     };
     return {
-      slug: slug,
-      data: {
-        title: matterResult.data.title,
-        date: new Date(matterResult.data.date),
-        summary: matterResult.data.summary,
-      },
       content: matterResult.content,
+      data:    {
+        date:    new Date(matterResult.data.date),
+        summary: matterResult.data.summary,
+        title:   matterResult.data.title,
+      },
+      slug: slug,
     };
   });
   return allPostsData.sort((a, b) => {
     if (a.data.date < b.data.date) {
       return 1;
-    } else {
-      return -1;
     }
+    return -1;
   });
 };
 
-export const getPostData = (slug: string) => {
-    const fullPath = join(postsDirectory, slug + ".md");
-    const fileContents = readFileSync(fullPath, "utf8");
-    const matterResult = matter(fileContents) as unknown as {
-        content: string;
-        data: { title: string; date: string; summary: string };
-      };
-      return {
-        slug: slug,
-        data: {
-          title: matterResult.data.title,
-          date: new Date(matterResult.data.date),
-          summary: matterResult.data.summary,
-        },
-        content: matterResult.content,
-      };
-}
+/**
+ * Reads a single post file.
+ * @param slug - The slug of the post to read.
+ * @returns The parsed frontmatter and file contents.
+ */
+const getPostData = (
+  slug: string,
+): {
+  content: string;
+  data:    { date: Date; summary: string; title: string };
+  slug:    string;
+} => {
+  const fullPath = join(postsDirectory, `${slug}.md`);
+  const fileContents = readFileSync(fullPath, "utf8");
+  // eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- matter doesn't take a generic I guess?
+  const matterResult = matter(fileContents) as unknown as {
+    content: string;
+    data:    { title: string; date: string; summary: string };
+  };
+  return {
+    content: matterResult.content,
+    data:    {
+      date:    new Date(matterResult.data.date),
+      summary: matterResult.data.summary,
+      title:   matterResult.data.title,
+    },
+    slug: slug,
+  };
+};
+
+export { getSortedPostsData, getPostData };