AGENTS.md

Project context for AI coding agents working in this repository.

Project

Personal website and blog for Benjamin Palko, deployed on Netlify.

Framework: SvelteKit 5 / Svelte 5
Language: TypeScript (strict)
Styling: Tailwind CSS 4 + daisyUI
Markdown/blogging: mdsvex with a custom highlight hook that renders fenced code via Components.pre code={...}
Logging: pino (server side)
Icons: @lucide/svelte

pnpm is the canonical local package manager.
The PR gate runs via Forgejo Actions (.forgejo/workflows/pr.yml) on pull requests to main. It installs with pnpm install --frozen-lockfile so CI matches a clean local install. Keep both working; document pnpm commands.
Deploys to Netlify run via Forgejo Actions (.forgejo/workflows/deploy.yml) on push to main. It needs NETLIFY_AUTH_TOKEN and NETLIFY_SITE_ID as Forgejo repo secrets. It also installs with pnpm install --frozen-lockfile.

Command	What it does
`pnpm dev`	Start dev server
`pnpm build`	Production build
`pnpm preview`	Preview the production build
`pnpm check`	`svelte-kit sync` + `svelte-check` (typecheck)
`pnpm lint`	Prettier check + ESLint
`pnpm format`	Prettier write
`pnpm test:unit`	Vitest (watch mode)
`pnpm test`	Vitest (single run)

Before finishing any work, run:

pnpm lint && pnpm check && pnpm test && pnpm build

This mirrors the existing PR gate.

Prettier + ESLint (flat config) with Svelte and Tailwind plugins. pnpm format will fix formatting.
Svelte 5 runes ($state, $props, etc.).
Path alias $lib maps to src/lib.

Posts live at src/lib/posts/*.md and are written in mdsvex markdown.
Follow src/lib/posts/template.md.sample for the frontmatter shape: title, description, image (url/alt), date, categories, published.
categories must be one of 'development' | 'work' | 'life' (see src/lib/posts/index.ts).
The slug is the filename (dynamic import in src/routes/blog/[slug]/+page.ts).
Only posts with published: true appear on the site.
Fenced code blocks use the mdsvex highlighter via Components.pre — mind the configured highlight hook in svelte.config.js.