feat: initial commit

.gitignore

@@ -0,0 +1,22 @@
+# Created by https://www.toptal.com/developers/gitignore/api/hugo
+# Edit at https://www.toptal.com/developers/gitignore?templates=hugo
+
+### WebStorm ###
+.idea
+
+### Hugo ###
+# Generated files by hugo
+/public/
+/resources/_gen/
+/assets/jsconfig.json
+hugo_stats.json
+
+# Executable may be added to repository
+hugo.exe
+hugo.darwin
+hugo.linux
+
+# Temporary lock file while building
+/.hugo_build.lock
+
+# End of https://www.toptal.com/developers/gitignore/api/hugo

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ishmaam Khan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,3 @@
+# extroonie.com
+
+My personal website, built with [Hugo](https://hugo.io/).

archetypes/default.md

@@ -0,0 +1,5 @@
++++
+date = '{{ .Date }}'
+draft = true
+title = '{{ replace .File.ContentBaseName "-" " " | title }}'
++++

content/writing/_index.md

@@ -0,0 +1,4 @@
+---
+title: "My Writing"
+description: "I wouldn't exactly call it a blog, given the lack of a regular posting schedule, but there are times when I put pen to paper (or fingers to keys), and the result is worth sharing. You might find something enjoyable in one of these musings."
+---

content/writing/nodejs-workspaces.md

@@ -0,0 +1,44 @@
+---
+title: "Why I don't like Node.js workspaces"
+date: 2024-01-02
+description: "Monorepos are cool, but the way they're implemented using workspaces... isn't."
+---
+
+I dislike the workspaces feature of package managers in Node.js, and I will explain why in this post.
+
+## What are workspaces?
+
+If you don't know what workspaces are, here's a brief description from [npm Docs](https://docs.npmjs.com/cli/v7/using-npm/workspaces):
+
+> Workspaces is a generic term that refers to the set of features in the npm cli that provides support to managing multiple packages from your local files system from within a singular top-level, root package.
+>
+> This set of features makes up for a much more streamlined workflow handling linked packages from the local file system. Automating the linking process as part of `npm install` and avoiding manually having to use `npm link` in order to add references to packages that should be symlinked into the current `node_modules` folder.
+>
+> We also refer to these packages being auto-symlinked during `npm install` as a single workspace, meaning it's a nested package within the current local file system that is explicitly defined in the [`package.json`](https://docs.npmjs.com/cli/v7/configuring-npm/package-json#workspaces) `workspaces` configuration.
+
+It exists in most of the package managers, including [pnpm](https://pnpm.io/workspaces) and [Yarn](https://yarnpkg.com/features/workspaces). They can also be intergated with build tools such as [Turborepo](https://turbo.build/repo) and [nx](https://nx.dev/).
+
+## The problem
+
+In a monorepo setup, workspaces allow you to install dependencies separately for each package or application in the repo. This is different from a traditional setup where all dependencies would be installed at the root of the repo.
+
+A key distinction exists between regular dependencies and developer dependencies like linting/testing tools. Regular dependencies can be installed at the package root as usual with workspaces. However, developer dependencies typically need to be hoisted and installed only at the workspace root.
+
+This can be problematic because it means each workspace must install its own copies of all the various dev tools needed, leading to duplication. There is no central place to consolidate tooling.
+
+## The solution
+
+> I've grown increasingly convinced over the past year that the TypeScript monorepos should move towards installing everything at the root of the monorepo. This is also what Nx recommends, at least for brand-new monorepos:
+>
+> ![img.png](/images/nodejs-workspaces-img.png)
+>
+> This strategy has a lot of elegance to it, as it makes working in the repo ultra-simple and rips out a ton of the crappy complexity that we had before:
+>
+> 1. You only have one `node_modules` directory, and it's at the root of the monorepo. The mental model here is super clean.
+> 2. You don't use the "workspaces" feature of the package manager whatsoever. It's very annoying to have to remember to put in workspace-related command-line flags whenever e.g. adding a new dep. This brings parity between "normal" single-project repos and monorepos.
+> 3. You don't have to worry about making somewhat-arbitrary distinctions between "ESLint-like" deps that should apply to the entire mono-repo, and "library-like" deps that should only apply to specific packages. Everything just goes into the root as a normal dep or a dev dep (in the same way that a normal/single repo does it).
+> 4. Updating dependencies becomes ultra simple - you don't need some over-engineered monorepo tool to do it! You can just run conventional tools like [`npm-check-updates`](https://github.com/raineorshine/npm-check-updates), and then after updating a single "package.json" file, you can simply run `npm/yarn/pnpm install`.
+>    - And checking for breaking changes after a new dep update also becomes easy. After updating, we can trigger a commit, and TypeScript will take over and let you know in CI in any of the new API changes broke one of your existing packages. Then we can revert the commit if needed, or continue to go on and make another commit to fix to the individual broken packages (or coordinate with other teams, if necessary).
+>    - In some monorepos, some packages are published to npm, so they need their own individual "package.json" files. Nx offers the option to automatically create package.json files when publishing, but sometimes you will want more control over them, and will choose to manually manage them yourself. (Does Turborepo have an analogous feature?) If you do manually manage "package.json" files, then you need an additional tool to propagate version changes downward from the root "package.json". With that said, even in this situation, I think it is preferable to use simple tools like [`syncpack`](https://github.com/JamieMason/syncpack) to do this, rather than complicated tools like e.g. `lerna`. (`syncpack` is essentially just a glorified copy-paster, so even in this situation, we are still maintaining the simple mental model of how dependencies work.)
+
+[Source](https://github.com/vercel/turbo/issues/2060#issuecomment-1416135197)

hugo.toml

@@ -0,0 +1,77 @@
+baseURL = 'https://extroonie.com'
+languageCode = 'en-us'
+title = 'Ishmaam Khan'
+
+enableRobotsTXT = true
+enableGitInfo = true
+disableHugoGeneratorInject = true
+
+[pagination]
+pagerSize = 10
+
+summaryLength = 70
+enableEmoji = true
+
+[minify]
+minifyOutput = true
+[minify.tdewolff]
+[minify.tdewolff.html]
+keepWhitespace = false
+[minify.tdewolff.css]
+keepCSS2 = false
+
+[params]
+author = 'Ishmaam Khan'
+description = "Hi, I'm Ishmaam! I'm a student who spends most of my time developing software and exploring the frontiers of science and philosophy."
+
+keywords = [
+  "software development",
+  "science",
+  "philosophy",
+  "student",
+  "programming",
+]
+images = ["/images/Pale_Blue_Dot.png"]
+
+preload = [{ href = "/images/Pale_Blue_Dot.png", type = "image" }]
+
+[params.social]
+twitter = 'Extroonie'
+github = 'Extroonie'
+email = 'ishmaam@extroonie.com'
+
+[markup]
+[markup.goldmark]
+[markup.goldmark.renderer]
+unsafe = true
+[markup.highlight]
+style = 'github'
+lineNos = true
+codeFences = true
+noClasses = true
+tabWidth = 4
+
+[outputs]
+home = ['HTML', 'RSS', 'JSON']
+section = ['HTML', 'RSS']
+
+[outputFormats.RSS]
+mediaType = 'application/rss+xml'
+baseName = 'rss'
+[outputFormats.JSON]
+mediaType = 'application/json'
+baseName = 'index'
+
+[sitemap]
+changefreq = 'weekly'
+priority = 0.5
+filename = 'sitemap.xml'
+
+[imaging]
+resampleFilter = 'lanczos'
+quality = 85
+anchor = 'smart'
+
+[security]
+[security.funcs]
+getenv = ["^HUGO_", "^CI$"]

layouts/_default/baseof.html

@@ -0,0 +1,69 @@
+<!doctype html>
+<html
+  lang="{{ .Site.LanguageCode }}"
+  itemscope
+  itemtype="http://schema.org/WebSite"
+>
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+
+    {{ block "title" . }}
+    <title>
+      {{ if .IsHome }}{{ .Site.Title }}{{ else if .Title }}{{ .Title }} | {{
+      .Site.Title }}{{ else }}{{ .Site.Title }}{{ end }}
+    </title>
+    {{ end }}
+
+    <meta
+      name="description"
+      content="{{ .Description | default .Site.Params.description }}"
+    />
+    <meta name="author" content="{{ .Site.Params.author }}" />
+    <meta name="generator" content="Hugo {{ hugo.Version }}" />
+
+    <meta
+      property="og:title"
+      content="{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ .Title }} | {{ .Site.Title }}{{ end }}"
+    />
+    <meta
+      property="og:description"
+      content="{{ .Description | default .Site.Params.description }}"
+    />
+    <meta
+      property="og:type"
+      content="{{ if .IsPage }}article{{ else }}website{{ end }}"
+    />
+    <meta property="og:url" content="{{ .Permalink }}" />
+    <meta property="og:site_name" content="{{ .Site.Title }}" />
+
+    <meta name="twitter:card" content="summary" />
+    <meta name="twitter:site" content="@{{ .Site.Params.social.twitter }}" />
+    <meta name="twitter:creator" content="@{{ .Site.Params.social.twitter }}" />
+
+    <link rel="canonical" href="{{ .Permalink }}" />
+
+    {{ $style := resources.Get "css/style.css" | resources.Minify |
+    resources.Fingerprint }}
+    <link
+      rel="stylesheet"
+      href="{{ $style.Permalink }}"
+      integrity="{{ $style.Data.Integrity }}"
+    />
+
+    <link rel="icon" href="/images/Pale_Blue_Dot.png" />
+    <link rel="apple-touch-icon" href="/images/Pale_Blue_Dot.png" />
+
+    {{ with .OutputFormats.Get "rss" -}} {{ printf `
+    <link rel="%s" type="%s" href="%s" title="%s" />
+    ` .Rel .MediaType.Type .Permalink $.Site.Title | safeHTML }} {{ end -}} {{
+    partial "structured-data.html" . }} {{ block "head" . }}{{ end }}
+  </head>
+  <body>
+    {{ block "header" . }}{{ end }}
+
+    <main id="main" role="main">{{ block "main" . }}{{ end }}</main>
+
+    {{ block "footer" . }}{{ end }}
+  </body>
+</html>

layouts/index.html

@@ -0,0 +1,51 @@
+{{ define "main" }}
+<div class="layout">
+  {{ partial "logo-heading.html" . }}
+
+  <div class="content">
+    <p>
+      Hi! I'm Ishmaam. I'm a 20-year-old student and software developer. You may
+      enjoy reading some of the
+      <a href="/writing">articles</a> I've written.
+    </p>
+
+    <p>
+      <strong>Reach out:</strong>&nbsp;&nbsp;<a
+        href="mailto:ishmaam@extroonie.com"
+        >ishmaam@extroonie.com</a
+      >
+      or Extroonie on Discord and Extroonie.01 on Signal<br />
+      <strong>Find me:</strong>&nbsp;&nbsp;
+      <a
+        href="https://github.com/Extroonie"
+        rel="noopener noreferrer"
+        target="_blank"
+        >GitHub</a
+      >
+      <a
+        href="https://twitter.com/Extroonie"
+        rel="noopener noreferrer"
+        target="_blank"
+        >Twitter</a
+      >
+    </p>
+
+    <p>
+      I have 6 years of experience as a backend software developer. My expertise
+      is in TypeScript and Node.js for building server-side applications, with
+      working knowledge of Rust and Go gained through self-directed learning.
+      Currently, most of my projects are closed-source, but I plan to publish
+      many of them and work on more complex portfolio projects in the near
+      future.
+    </p>
+
+    <p>
+      I enjoy learning about science, especially physics. I have also developed
+      an appreciation for philosophy and enjoy discussing metaphysical
+      questions, how we know things, free will controversies, logical puzzles,
+      and more. I'm also into learning about theology and different faiths to
+      get more insightful takes. I simply enjoy learning — beyond the horizon.
+    </p>
+  </div>
+</div>
+{{ end }}

layouts/partials/logo-heading.html

@@ -0,0 +1,3 @@
+<div class="logo-heading">
+  <h1><a href="/">{{ .Site.Title }}</a></h1>
+</div>

layouts/partials/structured-data.html

@@ -0,0 +1,69 @@
+<script type="application/ld+json">
+  {
+      "@context": "https://schema.org",
+  {{ if .IsHome }}
+  "@type": "Person",
+  "name": "{{ .Site.Params.author }}",
+  "url": "{{ .Site.BaseURL }}",
+  "description": "{{ .Site.Params.description }}",
+  "jobTitle": "Software Developer",
+  "knowsAbout": ["Software Development", "TypeScript", "Node.js", "Physics", "Philosophy"],
+  "sameAs": [
+  "https://twitter.com/{{ .Site.Params.social.twitter }}",
+  "https://github.com/{{ .Site.Params.social.github }}"
+  ],
+  "contactPoint": {
+  "@type": "ContactPoint",
+  "email": "{{ .Site.Params.social.email }}",
+  "contactType": "personal"
+  }
+  {{ else if and .IsPage (eq .Section "writing") }}
+  "@type": "BlogPosting",
+  "headline": "{{ .Title }}",
+  "description": "{{ .Description | default .Summary }}",
+  "datePublished": "{{ .Date.Format "2006-01-02T15:04:05Z07:00" }}",
+  {{ if .Lastmod }}"dateModified": "{{ .Lastmod.Format "2006-01-02T15:04:05Z07:00" }}",{{ end }}
+  "author": {
+  "@type": "Person",
+  "name": "{{ .Site.Params.author }}"
+  },
+  "publisher": {
+  "@type": "Person",
+  "name": "{{ .Site.Params.author }}"
+  },
+  "url": "{{ .Permalink }}",
+  "wordCount": {{ .WordCount }}{{ if .Params.tags }},
+  "keywords": [{{ range $index, $tag := .Params.tags }}{{ if $index }}, {{ end }}"{{ $tag }}"{{ end }}]{{ end }}
+  {{ else if and .IsSection (eq .Section "writing") }}
+  "@type": "Blog",
+  "name": "{{ .Site.Title }} - Writing",
+  "description": "{{ .Description | default .Site.Params.description }}",
+  "url": "{{ .Permalink }}",
+  "author": {
+  "@type": "Person",
+  "name": "{{ .Site.Params.author }}"
+  },
+  "blogPost": [
+  {{ range $index, $page := .Pages }}
+  {{ if $index }},{{ end }}
+  {
+  "@type": "BlogPosting",
+  "headline": "{{ .Title }}",
+  "datePublished": "{{ .Date.Format "2006-01-02T15:04:05Z07:00" }}",
+  "url": "{{ .Permalink }}",
+  "description": "{{ .Description | default .Summary }}"
+  }
+  {{ end }}
+  ]
+  {{ else }}
+  "@type": "WebSite",
+  "name": "{{ .Site.Title }}",
+  "url": "{{ .Site.BaseURL }}",
+  "description": "{{ .Site.Params.description }}",
+  "author": {
+  "@type": "Person",
+  "name": "{{ .Site.Params.author }}"
+  }
+  {{ end }}
+  }
+</script>

layouts/writing/list.html

@@ -0,0 +1,60 @@
+{{ define "main" }}
+<div class="layout">
+  <header class="global-header">
+    <nav role="navigation" aria-label="Main navigation">
+      <a class="header-link-home" href="/" aria-label="Go to homepage">Home</a>
+    </nav>
+  </header>
+
+  <div class="content">
+    <header class="page-header">
+      <h1>My Writing</h1>
+      <p>
+        I wouldn't exactly call it a blog, given the lack of a regular posting
+        schedule, but there are times when I put pen to paper (or fingers to
+        keys), and the result is worth sharing. You might find something
+        enjoyable in one of these musings.
+      </p>
+    </header>
+
+    {{ if .Pages }}
+    <ol class="post-list" role="list">
+      {{ range .Pages }} {{ $dateISO := .Date.Format "2006-01-02T15:04:05Z07:00"
+      }} {{ $dateHuman := .Date.Format "January 2, 2006" }}
+      <li role="listitem">
+        <a
+          href="{{ .Permalink }}"
+          class="post-list-item-link"
+          aria-label="Read {{ .Title }}"
+        >
+          <article
+            class="post-list-item"
+            itemscope
+            itemtype="http://schema.org/BlogPosting"
+          >
+            <header>
+              <h2>
+                <span itemprop="headline">{{ .Title }}</span>
+              </h2>
+              <time datetime="{{ $dateISO }}" itemprop="datePublished">
+                {{ $dateHuman }}
+              </time>
+              <meta itemprop="author" content="{{ .Site.Params.author }}" />
+            </header>
+            <section>
+              <p itemprop="description">
+                {{ if .Params.description }}{{ .Params.description }}{{ else
+                }}{{ .Summary }}{{ end }}
+              </p>
+            </section>
+          </article>
+        </a>
+      </li>
+      {{ end }}
+    </ol>
+    {{ else }}
+    <p>No posts available at the moment.</p>
+    {{ end }}
+  </div>
+</div>
+{{ end }}

layouts/writing/single.html

@@ -0,0 +1,68 @@
+{{ define "main" }}
+<div class="layout">
+  {{ $dateISO := .Date.Format "2006-01-02T15:04:05Z07:00" }} {{ $dateHuman :=
+  .Date.Format "January 2, 2006" }}
+
+  <header class="global-header">
+    <nav role="navigation" aria-label="Main navigation">
+      <a class="header-link-home" href="/" aria-label="Go to homepage">Home</a>
+      <a
+        class="header-link-all-posts"
+        href="/writing/"
+        aria-label="View all posts"
+        >All Posts</a
+      >
+    </nav>
+  </header>
+
+  <article class="post" itemscope itemtype="http://schema.org/BlogPosting">
+    <header class="post-header">
+      <h1 itemprop="headline">{{ .Title }}</h1>
+      <div class="post-meta">
+        <time datetime="{{ $dateISO }}" itemprop="datePublished">
+          {{ $dateHuman }}
+        </time>
+        {{ if .Lastmod }} {{ $lastmodISO := .Lastmod.Format
+        "2006-01-02T15:04:05Z07:00" }}
+        <meta itemprop="dateModified" content="{{ $lastmodISO }}" />
+        {{ end }}
+        <meta itemprop="author" content="{{ .Site.Params.author }}" />
+        {{ if .Params.description }}
+        <meta itemprop="description" content="{{ .Params.description }}" />
+        {{ end }}
+      </div>
+    </header>
+
+    <section class="post-content" itemprop="articleBody">
+      {{ .Content }}
+    </section>
+  </article>
+
+  <nav class="post-nav" role="navigation" aria-label="Post navigation">
+    <ul>
+      <li class="post-nav-prev">
+        {{ if .NextInSection }}
+        <a
+          href="{{ .NextInSection.Permalink }}"
+          rel="prev"
+          aria-label="Previous post: {{ .NextInSection.Title }}"
+        >
+          ← {{ .NextInSection.Title }}
+        </a>
+        {{ end }}
+      </li>
+      <li class="post-nav-next">
+        {{ if .PrevInSection }}
+        <a
+          href="{{ .PrevInSection.Permalink }}"
+          rel="next"
+          aria-label="Next post: {{ .PrevInSection.Title }}"
+        >
+          {{ .PrevInSection.Title }} →
+        </a>
+        {{ end }}
+      </li>
+    </ul>
+  </nav>
+</div>
+{{ end }}