Update README

Author: khopsickle

.gitignore

@@ -1,5 +1,6 @@
 # build output
 dist/
+
 # generated types
 .astro/
 
@@ -24,4 +25,6 @@ pnpm-debug.log*
 .idea/
 
 .vscode
+
+# output of Medium fetch script
 src/data/

README.md

@@ -1,43 +1,127 @@
-# Astro Starter Kit: Minimal
+# khopsickle.github.io
 
-```sh
-npm create astro@latest -- --template minimal
-```
+A personal site built in Astro on GitHub Pages.
 
-> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
+---
 
-## 🚀 Project Structure
+## Requirements
 
-Inside of your Astro project, you'll see the following folders and files:
+- **node** ≥ 24.14
+- **npm** ≥ 11
 
-```text
-/
-├── public/
-├── src/
-│   └── pages/
-│       └── index.astro
-└── package.json
-```
+> _Optional_: **ESLint** + **Prettier** extensions
+
+---
+
+## Local Development
+
+1.  clone the repo
+
+    ```bash
+    git clone https://github.com/khopsickle/khopsickle.github.io.git
+    cd khopsickle.github.io
+    ```
+
+1.  create `.env` file in the root dir with `GH_USERNAME`
+
+    ```
+    GH_USERNAME=khopsickle
+    ```
+
+1.  install dependencies
+
+    ```bash
+    npm ci
+    ```
+
+1.  create a `.gitignore`
+
+    <details>
+
+    <summary>sample .gitignore</summary>
 
-Astro looks for `.astro` or `.md` files in the `src/pages/` directory. Each page is exposed as a route based on its file name.
+    <code>
 
-There's nothing special about `src/components/`, but that's where we like to put any Astro/React/Vue/Svelte/Preact components.
+        # build output
+        dist/
 
-Any static assets, like images, can be placed in the `public/` directory.
+        # generated types
+        .astro/
 
-## 🧞 Commands
+        # dependencies
+        node_modules/
 
-All commands are run from the root of the project, from a terminal:
+        # logs
+        npm-debug.log*
+        yarn-debug.log*
+        yarn-error.log*
+        pnpm-debug.log*
 
-| Command                   | Action                                           |
-| :------------------------ | :----------------------------------------------- |
-| `npm install`             | Installs dependencies                            |
-| `npm run dev`             | Starts local dev server at `localhost:4321`      |
-| `npm run build`           | Build your production site to `./dist/`          |
-| `npm run preview`         | Preview your build locally, before deploying     |
-| `npm run astro ...`       | Run CLI commands like `astro add`, `astro check` |
-| `npm run astro -- --help` | Get help using the Astro CLI                     |
+        # environment variables
+        .env
+        .env.production
+
+        # macOS-specific files
+        .DS_Store
+
+        # jetbrains setting folder
+        .idea/
+
+        # output of Medium fetch script
+        src/data/
+
+        .vscode
+
+    </code>
+    </details>
+
+1.  run article fetch script
+
+    ```bash
+    node scripts/fetch-medium.js
+    ```
+
+1.  run dev server
+    ```bash
+    npm run dev
+    ```
+
+---
+
+## Project Structure
+
+Inside of your Astro project, you'll see the following folders and files:
+
+```text
+.
+├─ public/
+│
+├─ scripts/
+│  └─ fetch-medium.js
+│
+├─ src/
+│  ├─ data/                 # ignored
+│  ├─ pages/
+│  │  ├─ index.astro
+│  │  └─ 404.astro
+│  ├─ styles/
+│  │  └─ global.css
+│
+├─ package.json
+├─ tsconfig.json
+├─ tailwind.config.cjs
+│
+├─ .env                     # ignored
+└─ .github/workflows/
+   └─ deploy.yml
+```
 
-## 👀 Want to learn more?
+<br />
 
-Feel free to check [our documentation](https://docs.astro.build) or jump into our [Discord server](https://astro.build/chat).
+| Directory     | Description                                                                                              |
+| ------------- | -------------------------------------------------------------------------------------------------------- |
+| `public/`     | Any static assets,<br>like images, can be placed in this directory.                                      |
+| `scripts/`    | Node utilities<br>and other build-time code.                                                             |
+| `src/data/`   | Generated or stored data files<br>that the site consumes at build time.                                  |
+| `src/pages/`  | Astro looks for `.astro` or `.md` files here.<br>Each page is exposed as a route based on its file name. |
+| `src/styles/` | Global styles and Tailwind CSS configuration/imports.                                                    |