AGENT.md

This file provides guidance to AI agents like Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

Blazestar.net is a personal blog/homepage built with Astro v5 (static site generator). It uses React for interactive components, CSS v4 for styling, and MDX for markdown with JSX support.

Commands

npm run dev       # Start dev server at localhost:4321
npm run build     # Build production site to ./dist/
npm run preview   # Preview production build locally

Linting and formatting tools (ESLint, Prettier) are available via the Nix dev environment (nix develop or direnv). No npm scripts are configured for them.

Architecture

Content Collections

Defined in src/content.config.ts. Two collections:

blog — Markdown/MDX posts in src/content/blog/. Drafts live in src/content/blog/drafts/ and are excluded from production builds.
page — Static pages in src/content/page/ (about, values).

Blog post frontmatter: title (required), description (required), pubDate, updatedDate, heroImage, tags[].

Routing

/ — Home (src/pages/index.astro)
/blog/ — Post listing (src/pages/blog/index.astro)
/blog/[slug]/ — Individual posts (src/pages/blog/[...slug].astro)
/blog/tag/[tag]/ — Tag listing pages (src/pages/blog/tag/[...tag].astro)
/blog/tag/[tag].rss.xml — Per-tag RSS feeds
/rss.xml — Main RSS feed

Key Utilities

src/lib/blog.ts — Functions for fetching/sorting posts and extracting tag data
src/consts.ts — Global constants (SITE_TITLE, SITE_DESCRIPTION)

Layouts & Components

src/layouts/RootLayout.astro — Root HTML shell; all pages use this
src/layouts/BlogPost.astro — Layout for individual blog posts (h-entry microformat)
src/layouts/BlogList.astro — Layout for post listing pages
src/components/ — Shared components (Header, Footer, Sidebar, etc.)

Styling

Tailwind CSS v4 via Vite plugin (@tailwindcss/vite). Global CSS and custom properties in src/styles/global.css. Custom fonts in public/fonts/.

IndieWeb

The site supports IndieWeb standards: h-card and h-entry microformats in layouts, IndieAuth endpoint pointing to indieauth.com.

2.2 KiB Raw Blame History