chore: claude stuff and timezone fixes

Author: CalvinAllen

.gitignore

@@ -24,3 +24,5 @@ pnpm-debug.log*
 .idea/
 
 .claude/
+
+CLAUDE.local.md

CLAUDE.md

@@ -0,0 +1,80 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Critical Rules
+
+**These rules override all other instructions:**
+
+1. **NEVER commit directly to main** - Always create a feature branch and submit a pull request
+2. **Conventional commits** - Format: `type(scope): description`
+3. **GitHub Issues for TODOs** - Use `gh` CLI to manage issues, no local TODO files. Use conventional commit format for issue titles
+4. **Pull Request titles** - Use conventional commit format (same as commits)
+5. **Branch naming** - Use format: `type/scope/short-description` (e.g., `feat/blog/new-post-script`)
+6. **Working an issue** - Always create a new branch from an updated main branch
+7. **Check branch status before pushing** - Verify the remote tracking branch still exists. If a PR was merged/deleted, create a new branch from main instead
+
+### Conventional Commit Types
+
+| Type | Description |
+|------|-------------|
+| `feat` | New feature |
+| `fix` | Bug fix |
+| `docs` | Documentation only |
+| `refactor` | Code change that neither fixes a bug nor adds a feature |
+| `test` | Adding or updating tests |
+| `chore` | Maintenance tasks |
+
+### GitHub CLI Commands
+
+```bash
+gh issue list                    # List open issues
+gh issue view <number>           # View details
+gh issue create --title "type(scope): description" --body "..."
+gh issue close <number>
+```
+
+## Commands
+
+```bash
+npm run dev       # Start dev server at localhost:4321
+npm run build     # Build production site to ./dist/
+npm run preview   # Preview production build locally
+npm run new       # Create a new blog post (interactive prompts)
+```
+
+## Architecture
+
+This is an Astro static site for Calvin Allen's personal blog, deployed to Cloudflare Pages.
+
+### Content System
+
+- Blog posts are markdown files in `src/content/blog/{year}/{slug}/index.md`
+- Each post lives in its own directory to colocate images (e.g., `cover.png`)
+- Schema defined in `src/content/config.ts` with Zod validation:
+  - Required: `title`, `date`, `categories` (array)
+  - Optional: `description`, `image`, `youtube`
+
+### Post Frontmatter Example
+
+```yaml
+---
+title: "Post Title"
+date: "2025-12-25T21:58:58-05:00"
+categories: [dotnet, csharp]
+description: "Optional description"
+image: ./cover.png
+---
+```
+
+### Date Handling
+
+Dates include timezone offset in frontmatter. Display formatting uses `timeZone: 'America/New_York'` to ensure dates render correctly regardless of build server timezone.
+
+### Key Files
+
+- `src/pages/[...slug].astro` - Dynamic post routes
+- `src/pages/rss.xml.ts` - RSS feed generation
+- `src/layouts/PostLayout.astro` - Individual post layout
+- `src/components/PostCard.astro` - Blog listing card component
+- `scripts/new-post.js` - Interactive post creation script

README.md

@@ -1,43 +1,60 @@
-# Astro Starter Kit: Minimal
+# 👨‍💻 Coding With Calvin
 
-```sh
-npm create astro@latest -- --template minimal
-```
+Personal blog of Calvin Allen — software development thoughts, tutorials, and experiences.
 
-> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
+🌐 **Live at:** [codingwithcalvin.net](https://www.codingwithcalvin.net)
 
-## 🚀 Project Structure
+## ✨ Features
 
-Inside of your Astro project, you'll see the following folders and files:
+- 📝 Markdown-based blog posts with frontmatter
+- 🏷️ Category tagging and filtering
+- 📰 RSS feed for subscribers
+- 🎨 Dark theme with custom styling
+- 📱 Fully responsive design
+- ⚡ Lightning-fast static site generation
+- ☁️ Deployed on Cloudflare Pages
 
-```text
-/
-├── public/
-├── src/
-│   └── pages/
-│       └── index.astro
-└── package.json
-```
+## 🛠️ Tech Stack
+
+- [Astro](https://astro.build) - Static site generator
+- [Tailwind CSS](https://tailwindcss.com) - Styling
+- [TypeScript](https://typescriptlang.org) - Type safety
 
-Astro looks for `.astro` or `.md` files in the `src/pages/` directory. Each page is exposed as a route based on its file name.
+## 🚀 Quick Start
 
-There's nothing special about `src/components/`, but that's where we like to put any Astro/React/Vue/Svelte/Preact components.
+```bash
+# Install dependencies
+npm install
 
-Any static assets, like images, can be placed in the `public/` directory.
+# Start dev server
+npm run dev
 
-## 🧞 Commands
+# Build for production
+npm run build
 
-All commands are run from the root of the project, from a terminal:
+# Preview production build
+npm run preview
+```
+
+## 📄 Creating a New Post
 
-| 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                     |
+```bash
+npm run new-post "Your Post Title Here"
+```
+
+This creates a new markdown file in `src/content/blog/` with the current date and frontmatter template.
+
+## 📁 Project Structure
+
+```
+src/
+├── components/     # Reusable Astro components
+├── content/blog/   # Markdown blog posts
+├── layouts/        # Page layouts
+├── pages/          # Routes and pages
+└── styles/         # Global styles
+```
 
-## 👀 Want to learn more?
+## 📜 License
 
-Feel free to check [our documentation](https://docs.astro.build) or jump into our [Discord server](https://astro.build/chat).
+Content © Calvin Allen. Code is MIT licensed.

src/components/PostCard.astro

@@ -16,7 +16,8 @@ const { title, slug, date, description, categories, image } = Astro.props;
 const formattedDate = date.toLocaleDateString('en-US', {
   year: 'numeric',
   month: 'long',
-  day: 'numeric'
+  day: 'numeric',
+  timeZone: 'America/New_York'
 });
 ---
 

src/layouts/PostLayout.astro

@@ -20,7 +20,8 @@ const { title, slug, date, categories, description, image, youtube } = Astro.pro
 const formattedDate = date.toLocaleDateString('en-US', {
   year: 'numeric',
   month: 'long',
-  day: 'numeric'
+  day: 'numeric',
+  timeZone: 'America/New_York'
 });
 
 const postUrl = `https://www.codingwithcalvin.net/${slug}/`;