Kobi Kadosh
artisanal-code handcrafted since 2009

$ credits

A transparent look at what powers this site, who built what, and how you can use it.

// Licensing

Like Lea Verou's thoughtful approach, this site has different licenses for different parts. Code is meant to be shared and learned from, content is personal writing, and design reflects individual identity.

▸ Code (MIT License)

The source code of this website—including the monorepo structure, components, utilities, and build configuration—is licensed under the MIT License.

You're free to use, modify, and distribute the code, including for commercial purposes. Attribution is appreciated but not required.

→ Repository: github.com/wildcard/kobi.kadosh.me

▸ Content (All Rights Reserved)

All blog posts, articles, and written content on this site are © 2025 Kobi Kadosh and protected by copyright. These represent personal thoughts, experiences, and professional insights developed over years of practice.

You may share links to posts and quote brief excerpts with proper attribution. For other uses (republishing, translation, inclusion in courses or books), please contact me.

▸ Design & Visual Identity

The terminal aesthetic, color scheme, typography choices, and overall design are part of my personal brand and identity. While the code that implements them is MIT-licensed, I ask that you don't simply clone the exact visual appearance.

Feel free to use the code as a starting point and make it your own. Good design is always personal.

// Origins & Attribution

Standing on the Shoulders of Giants

This site began its life as a fork of Gatsby Starter Lumen by Alexander Shelepenok (2016-2020). That excellent template provided a solid foundation for a minimal, content-focused blog.

Since then, the site has been completely rebuilt as an Astro-based monorepo with a custom terminal theme, React components, and modern tooling. While the original structure inspired the initial direction, virtually all code has been rewritten. The original Lumen template's MIT license is preserved in the repository's LICENSE file.

// Technologies

Framework & Build

  • ├── Astro v5 - Static site generator
  • ├── Vite - Build tool
  • ├── Turborepo - Monorepo orchestration
  • └── pnpm - Package management

UI & Styling

Content & Integrations

Development Tools

Analytics & Performance

Infrastructure

  • ├── Vercel - Hosting & deployment
  • ├── GitHub - Source control
  • └── Gravatar - Profile images

// Design System

Terminal Aesthetic

The design draws inspiration from terminal emulators and code editors, using the Ayu Mirage color palette. This creates a familiar environment for developers while maintaining readability and accessibility.

Background
Foreground
Green
Cyan
Yellow
Red
Purple
Orange

→ Typography: JetBrains Mono with programming ligatures
→ Accessibility: WCAG AA compliant contrast ratios
→ Lighthouse Score: 100/100 (Performance, Accessibility, Best Practices, SEO)

// Making Of

Architecture & Approach

This site is built as a monorepo to support multiple related projects while sharing common components and configuration. The architecture emphasizes performance, maintainability, and developer experience. 

kobi.kadosh.me/
├── apps/
│   ├── site/              # Main Astro blog
│   ├── storybook/         # Component explorer
│   └── docs/              # Documentation site
├── packages/
│   ├── ui/                # React components + Storybook
│   ├── tailwind-config/   # Shared theme
│   └── tsconfig/          # TypeScript configs
└── cli/                   # Rust CLI tool

Key architectural decisions:

  • ▸ Astro over Gatsby - Better performance, simpler mental model, islands architecture
  • ▸ Monorepo structure - Share components across site, Storybook, and docs
  • ▸ Biome over ESLint+Prettier - Faster linting and formatting with single tool
  • ▸ pnpm over npm/yarn - Faster installs, efficient disk usage
  • ▸ MDX for content - Full power of React components in blog posts

// Development Philosophy

This site was built with Claude Code, an AI-powered coding assistant. Rather than viewing AI as a replacement for engineering craft, I see it as a powerful tool that amplifies human creativity and speeds up the implementation of well-thought-out ideas.

Every architectural decision, design choice, and piece of content reflects human judgment and experience. AI helped write code faster and explore alternatives, but the "what" and "why" remain fundamentally human concerns. Read more about this philosophy on the blog.

// Reuse & Permissions

✓ You're welcome to:

  • → Fork the repository and study the code
  • → Use the code as a learning resource or starting point for your own site
  • → Adapt components and utilities for your projects
  • → Share links to blog posts and quote with attribution
  • → Use similar technologies and architectural patterns

✗ Please don't:

  • → Copy the exact visual design and present it as your own brand
  • → Republish blog content without permission
  • → Use my name, profile, or content to imply endorsement
  • → Clone the site and simply replace my name with yours

? If you're unsure:

→ Just ask! I'm generally happy to grant permissions for reasonable uses, especially for educational purposes, open source projects, and fellow developers.

Questions about using this code? Want to share what you built? Found an issue?

→ Contact me → Report an issue → View source