KOLLITSCH.dev*

This is my personal website, (currently) built with Astro and TailwindCSS. This project serves as a digital garden, blog, and reference for web development, automation, and related topics, mixed with personal insights and experiences.

• General notes
• Quickstart
• Commands
• Tech stack
• Preview of the current state of the website
• Contributing

General notes

• The keywords MUST, MUST NOT, REQUIRED, SHOULD, SHOULD NOT, RECOMMENDED, MAY, and OPTIONAL are to be interpreted as described in RFC 2119. This applies to all documentation, AI instructions, agent prompts, and automation rules in this repository.

• I am working on Linux Xubuntu 26.04, meaning all code samples in this document are working on Linux Xubuntu 26.04 and any comparable (Debian- and Ubuntu-based) Linux system. If you use another operating system, you are on your own. I assume most tools, scripts, and procedures should work on other systems with the appropriate changes because I use open source programs and scripts and not having versions on all/most OSses will most certainly lead to me not endorsing them.

• Changes to the website and setup that are important are documented in the release notes on GitHub.

• The versioning follows a very sophisticated year based semantic versioning scheme that changed into a number system and now we just use 3000. Patch releases are for bug and content fixes, minor releases are for new features and content updates. Major releases are done once a while --- it's a personal website after all ;]

Quickstart

Clone and run locally:

git clone https://github.com/davidsneighbour/kollitsch.dev.git
cd kollitsch.dev
npm install
npm run dev

For more details and scattered notes about things, see the documentation directory, but don't expect it to be comprehensive or even up to date.

Commands

All commands are run from the root of the project, from a terminal:

Command	Action
npm install	Install dependencies and create cached files.
npx astro dev	Start local dev server at https://localhost:4321.
npx astro build	Build production site to ./dist/.
npx astro preview	Preview the build locally, before deploying.

Tech stack

• Astro 5.16+
• Tailwind CSS 4.1+
• Vitest & Playwright for testing
• Biome for linting and formatting

Preview of the current state of the website

Contributing

Contributions are always welcome. Keep in mind that this is a personal website and things might be wonky for reasons beyond your imagination and you might run into opposition (--- mine ---). Please open issues or pull requests for improvements, bug fixes, or new content. See CONTRIBUTING.md (if available) for guidelines. Otherwise refer to the agents documentation in AGENTS.md.